QStudioは無料のSQL GUIで、SQLスクリプトの実行、テーブルの簡単なブラウジング、グラフ作成、結果のエクスポートが可能です。すべてのオペレーティングシステムおよびすべてのデータベースで動作します。
QStudioをClickHouseに接続する
QStudioはJDBCを使用してClickHouseに接続します。
1. ClickHouseの詳細を集める
QStudioはHTTP(S)経由でJDBCを使用してClickHouseに接続します。必要な情報は次のとおりです:
- エンドポイント
- ポート番号
- ユーザー名
- パスワード
ClickHouseにHTTP(S)で接続するには、次の情報が必要です:
-
HOST と PORT: 通常、ポートはTLSを使用する場合は8443、TLSを使用しない場合は8123です。
-
DATABASE NAME: デフォルトでは、
default
という名前のデータベースがあります。接続したいデータベースの名前を使用してください。 -
USERNAME と 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 をクリックするか、ツールバーの「サーバー追加」ボタンをクリックします。
- 次に、詳細を設定します:

- サーバータイプ: Clickhouse.com
- ホストには必ず https:// を含める必要があります。 ホスト: https://abc.def.clickhouse.cloud ポート: 8443
- ユーザー名: default
パスワード:
XXXXXXXXXXX
- 「追加」をクリック
QStudioがClickHouse JDBCドライバがインストールされていないことを検出すると、自動的にダウンロードする提案をします:
4. ClickHouseにクエリを実行する
-
クエリエディタを開いてクエリを実行します。クエリは以下の方法で実行できます:
-
Ctrl + e - ハイライトされたテキストを実行
-
Ctrl + Enter - 現在の行を実行
-
サンプルクエリ:

次のステップ
QStudioの機能については QStudio を、ClickHouseの機能については ClickHouseのドキュメント を参照してください。