メインコンテンツへスキップ
メインコンテンツへスキップ

DBeaver を ClickHouse に接続する

Partner Integration

DBeaver には複数のエディションがあります。このガイドでは DBeaver Community を使用します。各エディションとその機能についてはこちらを参照してください。DBeaver は JDBC を使用して ClickHouse に接続します。

注記

ClickHouse の Nullable カラムのサポートを改善するため、DBeaver バージョン 23.1.0 以降を使用してください。

1. ClickHouse の接続情報を確認する​

DBeaver は JDBC を HTTP(S) 経由で使用して ClickHouse に接続します。接続するには次の情報が必要です。

  • エンドポイント
  • ポート番号
  • ユーザー名
  • パスワード

2. DBeaver をダウンロードする​

DBeaver は https://dbeaver.io/download/ からダウンロードできます。

3. データベースを追加する​

  • Database > New Database Connection メニュー、または Database Navigator の New Database Connection アイコンを使用して、Connect to a database ダイアログを開きます:
新しいデータベースを追加する

  • Analytical を選択し、次に ClickHouse を選択します:

  • JDBC URL を構成します。Main タブで Host、Port、Username、Password、Database を設定します:

ホスト名、ポート、ユーザー、パスワード、データベース名を設定する
  • デフォルトでは SSL > Use SSL プロパティはオフになっています。ClickHouse Cloud や HTTP ポートで SSL が必須のサーバーに接続する場合は、SSL > Use SSL をオンにします:
必要に応じて SSL を有効化する
  • 接続をテストします:
接続をテストする

DBeaver が ClickHouse ドライバがインストールされていないことを検出した場合、ドライバのダウンロードを提案します:

ClickHouse ドライバをダウンロードする
  • ドライバをダウンロードした後、もう一度 Test を実行して接続をテストします:
接続をテストする

4. ClickHouse にクエリを実行する​

クエリエディタを開き、クエリを実行します。

  • 接続を右クリックし、SQL Editor > Open SQL Script を選択してクエリエディタを開きます：
SQL エディタを開く
  • system.query_log に対するクエリ例：
サンプルクエリ

次のステップ​

DBeaver の機能について詳しくは DBeaver wiki を、ClickHouse の機能について詳しくは ClickHouse ドキュメント を参照してください。