副本感知路由

副本感知路由 (也称为 sticky sessions、粘性路由或会话亲和性) 会将相关请求路由到同一个 ClickHouse 副本。如果你需要让临时表或具名会话状态在多次查询之间持续可用，或者希望相关查询复用同一副本的本地缓存，就可以使用它。这是一种尽力而为的机制，不保证隔离性。扩缩容、升级和重启都可能改变给定 session_id 最终会落到哪个副本。

需要 HTTP 接口支持副本感知路由在代理层基于 HTTP/HTTPS 接口生效，使用的是 session_id 查询参数 (见下文) 。它不适用于原生协议 (native 端口，例如默认使用 native 模式的 clickhouse-go 驱动) 。使用原生协议的客户端必须切换到 HTTP，并在每个请求中传递 session_id。对于 clickhouse-go (v2) ，请设置 Protocol: clickhouse.HTTP，并将 session_id 作为设置项传递。驱动会将其作为代理进行哈希计算的 URL 查询参数发送出去。

前置条件

你的服务需要有 2 个或更多副本。如果服务只有单个副本，就没有可固定到的副本。
服务必须处于运行中状态。唤醒空闲服务可能会改变 session_id 映射到的副本。
该功能在进入 GA 后，Enterprise 默认可用。
此功能适用于标准 ClickHouse Cloud 服务。BYOC 暂不支持。

配置副本感知路由

提交一个 support 工单，申请启用基于 HTTP 的粘性副本路由。请附上你的 service ID 以及需要启用它的原因 (临时表、会话状态或缓存复用) 。启用后，开始在 HTTPS 请求中附带 ?session_id=。无需重启。

基于 HTTP 的路由 (session_id)

要将工作负载固定到某个副本，请在 HTTPS 接口上设置 session_id 查询参数。代理会对该值使用一致性哈希来选择副本，因此所有使用相同 session_id 的请求都会被发送到同一台服务器，直到集群拓扑发生变化。你可以使用现有的服务主机名。无需使用特殊的粘性主机名，也无需更改 DNS。

echo 'SELECT hostName()' | curl \
  -H 'X-ClickHouse-User: default' \
  -H 'X-ClickHouse-Key: <password>' \
  'https://<host>:8443/?session_id=my-workload-1' -d @-

每个携带 session_id=my-workload-1 的请求都会落到同一个副本上。不同的 session_id 值会分别进行哈希，可能落到同一个副本，也可能落到不同的副本。这种映射关系是固定的，但你无法选择某个给定值会映射到哪个副本。 session_id 可以是你选择的任意字符串 (应用名称、用户 ID 或工作负载标签) 。没有 session_id 的请求会保持正常的负载均衡。任何能够添加查询参数的 HTTP 客户端都可以，包括 curl、clickhouse-connect、JDBC/ODBC 等。对于 clickhouse-go (v2) ，请按上文所述使用 HTTP 模式。

检查你访问的是哪个副本

使用相同的 session_id，再次运行上面的 SELECT hostName() 示例。你应该会得到相同的主机名。不同的 session_id 可能会映射到不同的副本。

基于子域名的路由 (已弃用)

已弃用下述基于子域名的机制已弃用，并且在新服务中默认不再启用。这种方式无法很好地扩展 (每个粘性端点都需要单独的 TLS 证书) 。请改用基于 HTTP 的 session_id 方法。如果您已经在使用粘性子域名，请联系支持团队以启用 session_id 路由。这是一项破坏性变更，需要进行迁移。

此前，启用副本感知路由后，可以在服务主机名下使用通配符子域名。对于主机名为 abcxyz123.us-west-2.aws.clickhouse.cloud 的服务，任何匹配 *.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud 的主机名 (例如 aaa.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud) 都会由 Envoy 通过哈希一致地路由到某个固定副本。原始主机名则继续使用 LEAST_CONNECTION 负载均衡，即默认的路由算法。