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