获取您的 Cloud 连接详情 - ClickHouse Documentation

实时分析数据仓储可观测性AI/MLCloud

前置条件

To successfully follow this guide, you’ll need the following:

A running ClickHouse Cloud service. If you don’t have one yet, complete the Create your first Cloud service quickstart first.

你还应完成创建你的第一个 Cloud 服务快速入门，因为你需要一个现有的 ClickHouse Cloud 服务来获取连接信息。

你将完成的内容

在本快速入门中，你将学习如何找到 ClickHouse Cloud 服务的连接信息——也就是从任何外部客户端、CLI 工具或应用连接时所需的主机名、端口号、用户名和密码。完成后，你将知道如何在 Cloud 控制台中找到这些信息，以及如何使用简单的 curl 命令验证连通性，从而可以通过 clickhouse-local、clickhouse-client 或任何 ClickHouse 驱动进行连接。

打开 Cloud 控制台

前往 ClickHouse Cloud 控制台并登录你的账户。在主仪表板中，找到你要连接的服务。如果该服务处于休眠状态，点击它并等待其唤醒后再继续——你需要让它保持运行，以便在后续步骤中验证连通性。

查找连接信息

点击你的服务以打开详情页，然后点击左侧边栏中的 Connect 按钮：

第一次点击此按钮时，你会看到一个显示凭据的对话框：

详细信息	说明
Username	你的用户名 (通常为 `default`)
Password	为你的服务生成的密码

此外，还有一个下拉菜单，提供适用于不同协议和接口的预格式化示例连接字符串 (例如 clickhouse-client、HTTPS、JDBC 等) ，你可以直接复制。

请下载凭据文件，或复制你的密码并妥善保存。关闭此对话框后，你将无法再次查看该密码。

你还可以在服务详情页找到服务的 主机名 (例如 abc123.us-east-1.aws.clickhouse.cloud) 。请将它与凭证一起保存——在后续步骤以及之后的快速入门中都会用到。

如果你遗失了密码，可以在 Cloud 控制台中该服务的 Settings 选项卡内重置。

了解连接协议

ClickHouse Cloud 提供两种主要网络协议，每种协议各自使用一个端口：

native protocol (端口 9440) - clickhouse-client、clickhouse-local 以及大多数特定语言驱动使用的二进制协议。这是最快的选项，并支持所有 ClickHouse 功能。在 Cloud 上必须使用 TLS。
HTTPS protocol (端口 8443) - 基于 HTTP 的接口，适用于 REST 客户端、curl、基于 Web 的工具，以及偏好 HTTP 的驱动。在 Cloud 上同样需要 TLS。

连接到 ClickHouse Cloud 时，这两种协议都要求使用 TLS 加密——你不能通过明文连接。大多数工具在你指定正确端口时会自动处理这一点，但具体取决于客户端，你可能需要传递 --secure 标志或设置 ssl=true。在本系列的大多数快速入门和 CLI 工作流中，你将使用 9440 端口上的 native protocol。

保存连接信息以便重复使用

在各个快速入门中，你会频繁用到这些连接信息。为了避免每次都重新输入，你可以在终端会话中将它们导出为环境变量：

export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=YOUR_PASSWORD

将这些值替换为你的实际主机名、用户名和密码。如果你要使用 clickhouse-client 或 clickhouse-local 连接到 Cloud 服务，请从 “Connect with:” 旁边的下拉菜单中选择 ‘Native’ 以获取主机名。复制显示的连接示例中 --host 后面的主机名。

这些环境变量只会在当前终端会话中保留。不要将密码存储在 shell 配置文件 (.bashrc、.zshrc) 中，也不要将其提交到版本控制。

后续步骤

现在，您已经具备了从任何外部工具连接到 ClickHouse Cloud 服务所需的全部连接信息。您在此处找到的主机名、port、用户名和密码，将在本快速入门系列的后续内容中持续使用。接下来可查看以下快速入门：

或者通过参考文档进一步深入了解：

ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level — Check out the ClickHouse academy for on-demand and live training

所有快速入门

​前置条件

​你将完成的内容

​打开 Cloud 控制台

​查找连接信息

​了解连接协议

​保存连接信息以便重复使用

​后续步骤

前置条件

你将完成的内容

打开 Cloud 控制台

查找连接信息

了解连接协议

保存连接信息以便重复使用

后续步骤