# Backup Meta Schema Version

> Use when editing backup metadata schema in proto/brpb.proto to ensure BackupSchemaVersion is updated when required.

- Skill: `pingcap/backup-meta-schema-version` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pingcap/backup-meta-schema-version`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pingcap/backup-meta-schema-version/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: pingcap (https://skillmd.com/u/pingcap)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pingcap/backup-meta-schema-version

---


# Backup Metadata Schema Version

## Overview

Use this skill whenever a change may affect backup metadata wire format or
restore semantics in `proto/brpb.proto` for `backup.BackupMeta` and messages
reachable from it.

Covered metadata messages:

- `BackupMeta`
- `BackupRange`
- `TableMeta`
- `File`
- `MetaFile`
- `PlacementPolicy`
- `StatsFileIndex`
- `Schema`
- `IDMap`
- `PitrTableMap`
- `PitrDBMap`
- `RawRange`

## Required workflow

1. Apply schema changes in `proto/brpb.proto`.
2. If the change affects backup metadata format/semantics, increment
   `BackupSchemaVersion` in `pkg/brpb/backup_schema_version.go`
   (one bump per PR is sufficient).

## Non-schema changes

No version bump is needed for comment-only or formatting-only edits.