// 免费工具

ClickHouse 连接字符串生成器

在一个表单里为 HTTP 接口和原生协议构建 ClickHouse 连接字符串,或粘贴一个来检查端口、协议和 TLS 设置。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 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。