analyzing-schema-change-storage-risk

Official

Plan schema changes with capacity confidence.

Authorcockroachlabs
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Estimates storage requirements for CockroachDB online schema changes by analyzing per-index range sizes and applying the 3× free-space rule to prevent mid-backfill disk exhaustion.

Core Features & Use Cases

  • Per-index storage estimation using SHOW RANGES WITH DETAILS to determine largest range sizes and apply 3×/4× safety margins.
  • Targeted capacity planning for CREATE INDEX, ADD COLUMN, and ALTER PRIMARY KEY operations on large tables.
  • Production-ready guardrails with prerequisites, monitoring guidance, and risk assessment to avoid disk exhaustion during backfills.

Quick Start

Target a large table and run the safety checks to determine if you have sufficient space before a schema change.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: analyzing-schema-change-storage-risk
Download link: https://github.com/cockroachlabs/cockroachdb-skills/archive/main.zip#analyzing-schema-change-storage-risk

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.