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

DBeaver を ClickHouse に接続する

ClickHouse Supported

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 documentation を参照してください。