on cluster

[DatGuyJonathan]

Note

Adds full ClickHouse cluster (ON CLUSTER) support across CLI/migrations/DDL, TS/Py SDKs, templates, docs, and CI with new end-to-end tests.

• OLAP/DDL & Migrations:
  • Add cluster_name to table model/proto and propagate through infra maps, planning, diffing, ordering, and display.
  • Generate ON CLUSTER in CREATE/ALTER/DROP and settings/index/sample/TTL SQL; preserve cluster_name during reconcile.
  • Validate databases and clusters in migrate; plan validator checks cluster references.
  • Adjust replicated engine param injection (dev/prod; with/without cluster).
  • Migration plan schema allows complex engine objects.
• CLI:
  • Preserve clusters/additional_databases when overriding ClickHouse URL.
  • Show Cluster in infra display.
  • Docker compose mounts optional clusters.xml.
• SDKs (TS/Python):
  • Add cluster to OlapConfig and serialization; forbid mixing cluster with explicit keeperPath/replicaName.
  • New unit tests for cluster validation.
• Templates & E2E:
  • Add templates/typescript-cluster and templates/python-cluster and corresponding E2E tests (Cluster Support suites) and constants.
• Docs:
  • Document cluster-aware replicated tables and deployment semantics in TS/Python guides and configuration/olap pages.
• CI:
  • Add TS/Py cluster E2E jobs and gate them in summary; tweak change-detection patterns.

^{Written by Cursor Bugbot for commit c73d6f4. This will update automatically on new commits. Configure here.}

[linear]

ENG-1117 Add ON CLUSTER support for replicated ClickHouse tables

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
framework-docs	Ready	Preview	Comment	Nov 11, 2025 7:21pm
moosestack-framework-docs-v2	Ready	Preview	Comment	Nov 11, 2025 7:21pm