メインコンテンツまでスキップ
メインコンテンツまでスキップ

Connect QStudio to ClickHouse

Community Maintained

QStudioは無料のSQL GUIで、SQLスクリプトの実行、テーブルの簡単なブラウジング、チャートの作成、結果のエクスポートを可能にします。すべてのオペレーティングシステムおよびすべてのデータベースで動作します。

QStudioはJDBCを使用してClickHouseに接続します。

1. Gather your ClickHouse details

QStudioはHTTP(S)経由でJDBCを使用してClickHouseに接続します。必要な情報は次のとおりです:

  • エンドポイント
  • ポート番号
  • ユーザー名
  • パスワード

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

Choose HTTPS, and the details are available in an example curl command.

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.


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. Download QStudio

QStudioは https://www.timestored.com/qstudio/download/ から入手できます。

3. Add a database

  • QStudioを初めて開いたとき、メニューオプションのサーバー->サーバーの追加をクリックするか、ツールバーのサーバーの追加ボタンをクリックします。
  • 次に、詳細を設定します:
  1. サーバータイプ: Clickhouse.com
  2. ホストには必ずhttps://を含めてください ホスト: https://abc.def.clickhouse.cloud ポート: 8443
  3. ユーザー名: default パスワード: XXXXXXXXXXX
  4. 追加をクリック

QStudioがClickHouseのJDBCドライバーがインストールされていないことを検出した場合、ダウンロードを提案します:

4. Query ClickHouse

  • クエリエディタを開いてクエリを実行します。クエリを実行する方法は次のとおりです:

  • Ctrl + e - ハイライトされたテキストを実行

  • Ctrl + Enter - 現在の行を実行

  • 例のクエリ:

Next Steps

QStudioを参照してQStudioの機能について学び、ClickHouse documentationを参照してClickHouseの機能について学びましょう。