DataGrip は https://www.jetbrains.com/datagrip/ から入手できます。
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 管理者によって設定されます。
- DataGrip を起動し、Data Sources and Drivers ダイアログの Data Sources タブで + アイコンをクリックします
ClickHouse を選択します
接続を作成していくと表示順が変わるため、ClickHouse がまだリストの先頭に表示されていない場合があります。
-
Drivers タブに切り替えて、ClickHouse ドライバーを読み込みます
DataGrip には、ダウンロードサイズを最小限に抑えるため、ドライバーが同梱されていません。Drivers タブで、
Complete Support の一覧から ClickHouse を選択し、+ 記号をクリックして展開します。Provided Driver オプションから Latest stable ドライバーを選択します。
- データベースの接続情報を入力し、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=trueClickHouse Cloud では、すべての接続で SSL 暗号化が必須です。?ssl=true パラメータがないと、認証情報が正しくても “Connection reset” エラーが表示されます。JDBC URL の設定について詳しくは、ClickHouse JDBC driver リポジトリを参照してください。
DataGrip の詳細については、DataGrip のドキュメントをご覧ください。