ClickHouse 连接字符串生成器
在一个表单里为 HTTP 接口和原生协议构建 ClickHouse 连接字符串,或粘贴一个来检查端口、协议和 TLS 设置。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。
在 SQLly 中打开此连接
从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。
ClickHouse 连接字符串格式
ClickHouse 有两种客户端协议,使用不同端口:HTTP(8123,或 TLS 下的 8443),用于 JDBC、clickhouse-connect 和 .NET 驱动,以及原生 TCP 协议(9000,或 TLS 下的 9440),用于 clickhouse-client 和 clickhouse-go。将客户端指向另一个协议的端口是最常见的连接错误。
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 的信息: SQLly 适用于 ClickHouse.
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 |
- | localhost | 服务器主机。 |
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 |
- | localhost | 服务器主机。 |
--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。