メインコンテンツまでスキップ
メインコンテンツまでスキップ

DBeaverをClickHouseに接続する

DBeaverは複数の提供形態があります。このガイドでは、DBeaver Communityを使用します。さまざまな提供形態と機能についてはこちらをご覧ください。DBeaverはJDBCを使用してClickHouseに接続します。

注記

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

1. ClickHouseの詳細を収集する​

DBeaverはHTTP(S)経由でJDBCを使用して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のドキュメンテーションをご覧ください。