alibabacloud-cksync-plan

Generate ClickHouse cluster migration plans with steps, risks, and rollback.

213|24|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-cksync-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alibabacloud-cksync-plan
Source: https://github.com/aliyun/alibabacloud-aiops-skills/tree/main/skills/database/clickhouse/alibabacloud-cksync-plan
Command: npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-cksync-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

Plans and documents migration strategies for ClickHouse clusters, generating concrete migration plans and templates to guide cross-cluster moves, AZ switches, disk downgrades, and multi-cluster federations.

Core Features & Use Cases

  • Generates end-to-end migration plans tailored to source/target configurations.
  • Evaluates method suitability (cksync, backup/restore, insert-from-remote, double-write, big-cluster federation) and outputs a recommended path with steps, risks, and rollback.
  • Supports producing migration templates and reference materials for execution teams.

Quick Start

Describe your source and target ClickHouse clusters (type, edition, version, data size, TTLs, and downtime window) to generate a migration plan.

Frequently Asked Questions about alibabacloud-cksync-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a ClickHouse migration across clusters?

Plan a ClickHouse migration by evaluating source and target cluster configurations, data sizes, TTLs, and downtime windows to generate a concrete migration plan with steps, risks, and rollback procedures.

What is the best way to migrate ClickHouse data for an AZ switch or disk downgrade?

The best way to migrate ClickHouse data for AZ switches or disk downgrades is evaluating method suitability across cksync, backup/restore, or insert-from-remote to output a recommended path with compatibility checks.

Can I generate a migration template for multi-cluster ClickHouse federations?

Yes, you can generate migration templates and reference materials for multi-cluster ClickHouse federations by specifying source and target cluster types, editions, versions, and partitions to guide execution teams.

Does planning a ClickHouse migration require downtime window and TTL details?

Yes, planning a ClickHouse migration requires downtime window and TTL details alongside data size and cluster configurations to evaluate method suitability and produce accurate rollback strategies.

What are the limitations of using cksync for in-place ClickHouse migrations?

Limitations of using cksync for in-place ClickHouse migrations depend on compatibility checks against source and target configurations, requiring risk assessment and rollback planning to address potential partition or data size constraints.

Why does my ClickHouse migration plan need compatibility checks and risk assessment?

Your ClickHouse migration plan needs compatibility checks and risk assessments to ensure cross-cluster moves, AZ switches, or disk downgrades execute safely with defined rollback procedures and method recommendations.