cockroachdb-to-tidb-migration

Generate a CockroachDB to TiDB migration plan with schema, data, and procedural code validation.

2|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pingcap-inc/TiShift --skill cockroachdb-to-tidb-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cockroachdb-to-tidb-migration
Source: https://github.com/pingcap-inc/TiShift/tree/main/cockroachdb-to-tidb
Command: npx skills add https://github.com/pingcap-inc/TiShift --skill cockroachdb-to-tidb-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers migrate CockroachDB schemas and data to TiDB by providing an actionable, end-to-end workflow that assesses compatibility, maps types, converts DDL, loads data, and validates results.

Core Features & Use Cases

  • End-to-end migration workflow: scan, assess, convert, load, and validate across schema, data, and procedural code.
  • Type mapping and DDL conversion: automatically map CRDB types to TiDB equivalents and generate compatible schema artifacts.
  • Validation & risk scoring: compare source and target inventories to ensure data integrity and readiness before cutover.
  • Use Case: Move a CockroachDB cluster to TiDB Cloud with confidence using guided prompts and AI-assisted stubs.

Quick Start

Run the /cockroachdb-to-tidb command to begin the guided migration workflow.

Frequently Asked Questions about cockroachdb-to-tidb-migration

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

FAQPage Schema
How do I migrate a CockroachDB schema to TiDB?

Migrating a CockroachDB schema to TiDB requires assessing compatibility, mapping CRDB types to TiDB equivalents, and generating compatible DDL artifacts. The workflow guides you through scanning, converting, loading, and validating schema objects.

What is the process for mapping CockroachDB data types to TiDB?

Mapping CockroachDB data types to TiDB involves automatically converting CRDB types to their TiDB equivalents during the assess and convert phases. This ensures generated schema artifacts are fully compatible before data load.

How do I validate data integrity after moving a CockroachDB cluster to TiDB Cloud?

Validating data integrity after moving a CockroachDB cluster to TiDB Cloud requires comparing source and target inventories. This risk scoring step ensures data readiness and consistency before final cutover.

Can I migrate procedural code from CockroachDB to TiDB?

Yes, you can migrate procedural code from CockroachDB to TiDB. The end-to-end migration workflow applies across schema, data, and procedural code during the scan, assess, convert, load, and validate phases.

What is the best way to assess migration readiness from CockroachDB to TiDB?

The best way to assess CockroachDB to TiDB migration readiness is to run a guided workflow that scores risks and compares source and target inventories. This generates a concrete conversion plan before cutover.