Skip to content

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

Open
SamWolfberg wants to merge 1 commit into
mainfrom
docs/replica-aware-routing-http-and-deprecation
Open

Document HTTP session_id replica-aware routing + native-protocol limitation#6431
SamWolfberg wants to merge 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

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