QStudio を ClickHouse に接続する
QStudio は無償の SQL 向け GUI ツールであり、SQL スクリプトの実行、テーブルの簡単な参照、チャートの作成、結果のエクスポートが可能です。すべてのオペレーティングシステム上で動作し、あらゆるデータベースと連携できます。
QStudio は JDBC を使用して ClickHouse に接続します。
1. ClickHouse の情報を収集する
QStudio は JDBC over HTTP(S) を使用して ClickHouse に接続します。そのため、次の情報が必要です。
- エンドポイント
- ポート番号
- ユーザー名
- パスワード
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. QStudio をダウンロードする
QStudio は https://www.timestored.com/qstudio/download/ からダウンロードできます。
3. データベースを追加する
- QStudio を初めて開いたら、メニューオプション Server->Add Server をクリックするか、ツールバーの Add Server ボタンをクリックします。
- 次に、以下の詳細を設定します:
- Server Type: ClickHouse.com
- Host には必ず https:// を含める必要があります Host: https://abc.def.clickhouse.cloud Port: 8443
- Username: default
Password:
XXXXXXXXXXX - Add をクリックします
QStudio が ClickHouse JDBC ドライバーがインストールされていないことを検出した場合、ドライバーのダウンロードを提案します。
4. ClickHouse にクエリを実行する
-
クエリエディタを開き、以下のいずれかの方法でクエリを実行します。
-
Ctrl + e - 選択中のテキストを実行
-
Ctrl + Enter - 現在の行を実行
-
クエリの例:
次のステップ
QStudio の機能については QStudio を、ClickHouse の機能については ClickHouse ドキュメント をそれぞれ参照してください。
