Skip to content

Document HTTP session_id replica-aware routing + native-protocol limitation#6431

Merged
dhtclk merged 1 commit into
mainfrom
docs/replica-aware-routing-http-and-deprecation
Jun 24, 2026
Merged

Document HTTP session_id replica-aware routing + native-protocol limitation#6431
dhtclk merged 1 commit into
mainfrom
docs/replica-aware-routing-http-and-deprecation

Conversation

@SamWolfberg

Copy link
Copy Markdown
Contributor

Closes #6430

Updates the replica-aware routing page to reflect current behavior:

  • Lead with the supported HTTP session_id method (over HTTPS).
  • Mark the subdomain/url-based method deprecated (doesn't scale — each sticky endpoint needs its own TLS cert).
  • Add a native-protocol not supported limitation plus the clickhouse-go Protocol: clickhouse.HTTP workaround.

Source: Jan Mensch's "HTTP-based replica-aware routing" DP doc + #data-plane-team-all. Verified hands-on: on an un-flagged 3-replica service session_id does not pin and *.sticky.<host> is NXDOMAIN; the DP doc shows session_id pinning on a flag-enabled instance. Prompted by SF case 00047418.

@SamWolfberg SamWolfberg requested a review from a team as a code owner June 22, 2026 22:38
@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 22, 2026 10:49pm
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jun 22, 2026 10:49pm
clickhouse-docs-ko Ignored Ignored Jun 22, 2026 10:49pm
clickhouse-docs-ru Ignored Ignored Jun 22, 2026 10:49pm
clickhouse-docs-zh Ignored Ignored Jun 22, 2026 10:49pm

Request Review

@dhtclk dhtclk merged commit b3f64f9 into main Jun 24, 2026
17 checks passed
@mintlify

mintlify Bot commented Jun 24, 2026

Copy link
Copy Markdown

Docs PR opened: ClickHouse/mintlify-docs-dev#267

Replica-aware routing now leads with the HTTP session_id method, deprecates subdomain-based routing, and documents the native-protocol limitation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Replica-aware routing docs: missing native-protocol limitation; subdomain method deprecated

2 participants