DataGrip を ClickHouse に接続する

Community Maintained

DataGrip を起動するかダウンロードする

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 への接続では、Host の下にある 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 のドキュメントを参照してください。