DataGripをClickHouseに接続する

DataGripは、ClickHouseを標準でサポートしているデータベースIDEです。

​

DataGrip を起動またはダウンロードする

DataGrip は https://www.jetbrains.com/datagrip/ から入手できます。

​

1. 接続情報を確認する

HTTP(S) で ClickHouse に接続するには、次の情報が必要です。

Parameter(s)	Description
HOST and PORT	通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合は 8123 です。
DATABASE NAME	デフォルトでは default という名前のデータベースがあります。接続先のデータベース名を使用してください。
USERNAME and PASSWORD	デフォルトのユーザー名は default です。用途に応じたユーザー名を使用してください。

ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。 サービスを選択し、Connect をクリックします。

HTTPS を選択します。接続情報は curl コマンドの例として表示されます。

セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

​

2. ClickHouseドライバーを読み込む

1. DataGrip を起動し、Data Sources and Drivers ダイアログの Data Sources タブで + アイコンをクリックします

ClickHouse を選択します

接続を作成していくと表示順が変わるため、ClickHouse がまだリストの先頭に表示されていない場合があります。

• Drivers タブに切り替えて、ClickHouse ドライバーを読み込みます

  DataGrip には、ダウンロードサイズを最小限に抑えるため、ドライバーが同梱されていません。Drivers タブで、 Complete Support の一覧から ClickHouse を選択し、+ 記号をクリックして展開します。Provided Driver オプションから Latest stable ドライバーを選択します。

​

3. ClickHouse に接続する

• データベースの接続情報を入力し、Test Connection をクリックします。 手順 1 で確認した接続情報をもとに、ホスト URL、ポート、ユーザー名、パスワード、データベース名を入力してから、接続をテストします。

Host フィールドには、https:// のようなプロトコルのプレフィックスを付けず、ホスト名のみを入力してください (例: your-host.clickhouse.cloud) 。

ClickHouse Cloud に接続する場合は、ホストの下にある URL フィールドに ?ssl=true を追加する必要があります。完全な JDBC URL は次のようになります。

jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true

ClickHouse Cloud では、すべての接続で SSL 暗号化が必須です。?ssl=true パラメータがないと、認証情報が正しくても “Connection reset” エラーが表示されます。

JDBC URL の設定について詳しくは、ClickHouse JDBC driver リポジトリを参照してください。

​

詳細情報

DataGrip の詳細については、DataGrip のドキュメントをご覧ください。