// 無料のツール

ClickHouse 接続文字列ビルダー

HTTP インターフェイスとネイティブ プロトコルの ClickHouse 接続文字列を 1 つのフォームで作成するか、接続文字列を貼り付けてポート、プロトコル、TLS の設定を確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。

SQLly でこの接続を開く

SQLly の接続エディターを、入力済みの状態で開きます。

設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。

ClickHouse 接続文字列の形式

ClickHouse には、異なるポートで 2 つのクライアントプロトコルがあります。JDBC、clickhouse-connect、.NET ドライバーが使う HTTP (8123、TLS では 8443) と、clickhouse-client や clickhouse-go が使うネイティブ TCP プロトコル (9000、TLS では 9440) です。クライアントを他方のプロトコルのポートに向けてしまうのが、最も多い接続エラーです。

HTTP URL HTTP インターフェース、curl

https://ch.example.com:8443/?database=analytics

ネイティブ DSN clickhouse-go v2

clickhouse://default:[email protected]:9440/analytics?secure=true

JDBC clickhouse-java 0.8+

jdbc:clickhouse:https://ch.example.com:8443/analytics?user=default&password=your_password&ssl=true

ADO.NET ClickHouse.Driver

Host=ch.example.com;Protocol=https;Username=default;Password=your_password;Database=analytics

次のようなプレースホルダー your_password あくまで一例です。接続文字列は上のフォームで組み立ててください。SQLlyをClickHouseに接続する方法の詳細: ClickHouse 向け SQLly.

ClickHouse のポート

ClickHouse のネットワークポートガイドから。

キーワードシノニムデフォルト何ができるか
8123 - - HTTP インターフェース。
8443 - - HTTPS インターフェース。
9000 - - ネイティブTCPプロトコル
9440 - - ネイティブプロトコル(TLS 上)。
9004 / 9005 - - MySQLとPostgreSQLのワイヤ互換インターフェイス。

clickhouse-go v2 DSNパラメーター

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// そして https:// DSN は HTTP インターフェイスを使用します。

キーワードシノニムデフォルト何ができるか
secure - 偽 TLS。
skip_verify - 偽 証明書のチェックをスキップします。
dial_timeout - 30秒 単位付きの接続タイムアウト。
read_timeout - 5分 読み取りタイムアウト。
compress - - 圧縮方法。
connection_open_strategy - - ホストの選ばれ方。

ClickHouse.Driver (.NET) のキー

ADO.NET スタイル。

キーワードシノニムデフォルト何ができるか
Host - ローカルホスト サーバーホスト。
Port - 8123 / 8443 HTTP(S) ポート。
Protocol - http http または https.
Username - デフォルト ユーザー名。
Password - 空 パスワード。
Database - 空 デフォルトデータベース。
Compression - true 通信を圧縮します。
UseSession - 偽 サーバー側のセッションを使用する。
Timeout - 120 秒。

clickhouse-clientオプション

clickhouse-clientは、最初の引数として接続文字列も受け付けます: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

キーワードシノニムデフォルト何ができるか
--host, -h - ローカルホスト サーバーホスト。
--port - 9000(--secure 使用時は 9440) ネイティブポート
--user, -u - デフォルト ユーザー。
--password --ask-password - パスワード; --ask-password プロンプト。
--database, -d - デフォルト データベース。
--secure, -s - - TLS。ポート 9440 と ClickHouse Cloud ホストでは自動的にオンになります。

一般的な ClickHouse 接続エラー

Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.

理由: HTTP クライアント(ブラウザー、curl、JDBC、clickhouse-connect、.NET)が、ネイティブプロトコルのポートに向けられました。

修正: 8123 を使用します。HTTPS の場合は 8443 を使用します。

Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.

理由: ユーザー名またはパスワードの誤り、あるいはそのユーザーがこのアドレスからのログインを許可されていない可能性があります。

修正: 認証情報と、サーバーのユーザー設定で許可されているホストを確認してください。

Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)

理由: 接続文字列に指定されたデータベースが存在しません。

修正: 確認 SHOW DATABASES とその表記。

Unexpected packet / connection reset on the native port

理由: ネイティブプロトコルのクライアント(clickhouse-client、clickhouse-go)が HTTP ポートに接続している、またはプレーンなクライアントが TLS ポート 9440 に接続している。

修正: TLS なしの場合は 9000、TLS ありの場合は 9440 を使用します --secure / secure=true.

ClickHouse 接続文字列のよくある質問

ClickHouse にはどのポートを使えばよいですか?

HTTP クライアント(JDBC、clickhouse-connect、.NET、curl)は 8123 を使い、HTTPS の場合は 8443 を使います。ネイティブクライアント(clickhouse-client、clickhouse-go のネイティブ DSN)は 9000 を使い、TLS の場合は 9440 を使います。ClickHouse Cloud は 8443 と 9440 で提供されます。

ClickHouse JDBC URL の形式は何ですか?

jdbc:clickhouse:http://host:8123/database または jdbc:clickhouse:https://host:8443/database?ssl=true (ドライバー 0.8+)。ドライバーはポートからプロトコルを推測しないため、明示してください。

HTTP URL にパスワードを含めることはできますか?

避けてください:URL はログに残ります。次のヘッダーで送信してください: X-ClickHouse-User そして X-ClickHouse-Key ヘッダー、または HTTP 基本認証で。

// 接続文字列はまるごと不要

つなぐのは一度だけ。あとは SQL を書くだけ。

SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、ClickHouse などでスキーマ対応の IntelliSense を利用できます。