
跨区域流量可能会产生额外费用。请查阅最新的 Azure 文档。
- 获取 Private Link 的 Azure 连接别名
- 在 Azure 中创建专用终结点
- 将专用终结点资源 ID 添加到您的 ClickHouse Cloud 组织
- 将专用终结点资源 ID 添加到您的服务允许列表
- 通过 Private Link 访问您的 ClickHouse Cloud 服务
ClickHouse Cloud Azure PrivateLink 已从使用 resourceGUID 切换为使用 Resource ID 过滤器。您仍然可以使用 resourceGUID,因为它向后兼容,但我们建议改用 Resource ID 过滤器。迁移时,只需使用 Resource ID 创建一个新端点,将其附加到服务,然后删除旧的基于 resourceGUID 的端点即可。
Service name 和 DNS name,后续配置 Private Link 时需要用到它们。

Service name 和 DNS name,后续步骤中会用到它们。
开始之前,您需要一个 ClickHouse Cloud API 密钥。您可以创建新的密钥,或使用现有密钥。
获得 API 密钥后,请先设置以下环境变量,然后再运行任何命令:
INSTANCE_ID:
endpointServiceId。下一步会用到它。
在本节中,我们将在 Azure 中创建一个专用终结点。您可以使用 Azure 门户,也可以使用 Terraform。
在 Azure 门户中,打开 Private Link Center → Private Endpoints。


在接下来的页面中,指定以下选项:
- Subscription / Resource Group:请选择用于该专用终结点的 Azure 订阅和资源组。
- Name:为 Private Endpoint 设置名称。
- Region:选择一个区域,即要通过 Private Link 连接到 ClickHouse Cloud 的已部署 VNet 所在的区域。

选择 Connect to an Azure resource by resource ID or alias 选项。 对于 Resource ID or alias,请使用你在 获取用于 Private Link 的 Azure 连接别名 步骤中获得的
endpointServiceId。
点击 Next: Virtual Network 按钮。

- Virtual network:选择要通过 Private Link 连接到 ClickHouse Cloud 的 VNet
- Subnet:选择要创建专用终结点的子网
- Application security group:你可以将 ASG 附加到专用终结点,并在 Network Security Groups 中使用它来过滤进出专用终结点的网络流量。






id 字段 (即专用终结点的 Resource ID,格式为 /subscriptions/.../providers/Microsoft.Network/privateEndpoints/<name>) ,不要使用 properties 对象内嵌套的 id 字段:
首选方法:使用 Resource ID

resourceGuid 字段并复制该值:

${location_code}.privatelink.azure.clickhouse.cloud) ,并将其关联到您的 VNet,才能通过 Private Link 访问资源。
选项 1:使用 Azure 门户
请参照本指南,在 Azure 门户中创建 Azure 私有 DNS 区域。
选项 2:使用 Terraform
使用以下 Terraform 模板创建私有 DNS 区域:
- 打开
MyAzureResourceGroup资源组,并选择${region_code}.privatelink.azure.clickhouse.cloud专用 DNS 区域。 - 选择 + 记录集。
- 在 Name 中,输入
*。 - 在 IP Address 中,输入你在专用终结点中看到的 IP 地址。
- 选择 确定。

DNS 的配置方式有很多种。请根据您的具体使用场景进行设置。
xxxxxxxxxx.westus3.privatelink.azure.clickhouse.cloud 域名应解析到专用终结点 IP (本示例中为 10.0.0.4) 。

ENDPOINT_ID 环境变量。
运行以下命令以添加专用终结点:
Resource ID。
如果您想允许通过现有 PrivateLink 连接进行访问,请使用现有端点下拉菜单。

privateDnsHostnameAPI 或 DNS nameConsole。
在 ClickHouse Cloud 控制台中,前往 设置。点击 设置专用终结点 按钮。在打开的弹出面板中,复制 DNS name。

xxxxxxx.region_code.privatelink.azure.clickhouse.cloud 主机名的流量将通过 Private Link 路由。与此同时,xxxxxxx.region_code.azure.clickhouse.cloud 的流量将通过互联网路由。
使用 privateDnsHostname 通过 Private Link 连接到你的 ClickHouse Cloud 服务。
运行以下命令:
privateDnsHostnameAPI 或 DNS name控制台
你应该会收到以下响应:
openssl 检查连通性。请确保 Private Link 端点状态为 Accepted。
OpenSSL 应该能够成功建立连接 (请查看输出中的 CONNECTED) 。出现 errno=104 是正常现象。