db-replication-sharding

📁 kentoshimizu/sw-agent-skills 📅 1 day ago
1
总安装量
1
周安装量
#78277
全站排名
安装命令
npx skills add https://github.com/kentoshimizu/sw-agent-skills --skill db-replication-sharding

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
continue 1
kimi-cli 1

Skill 文档

DB Replication Sharding

Overview

Use this skill to design data topology that scales safely without hiding consistency and operability costs.

Scope Boundaries

  • Throughput, storage, or availability limits exceed single-instance capacity.
  • Read/write scaling requires replication or partitioning.
  • Regional or tenant growth pressures topology redesign.

Core Judgments

  • Replication mode and consistency expectations for read paths.
  • Shard key strategy and future rebalancing feasibility.
  • Cross-shard query/transaction requirements.
  • Failover behavior and recovery-time expectations.

Practitioner Heuristics

  • Choose shard keys by access locality and growth distribution, not by convenience.
  • Read replicas are eventually consistent systems; classify which reads can tolerate lag.
  • Cross-shard joins and transactions should be exceptions with explicit ownership.
  • Topology decisions must include operational playbooks for failover and rebalancing.

Workflow

  1. Profile read/write distribution and growth projections.
  2. Select replication topology by availability and consistency needs.
  3. Evaluate shard key candidates and hotspot risk.
  4. Design routing, rebalancing, and failover behavior.
  5. Define application-level behaviors for lag, split-brain prevention, and retries.
  6. Document expansion path and de-risking milestones.

Common Failure Modes

  • Shard key creates unbounded hotspots as tenants grow.
  • Replica lag assumptions leak into business-critical reads.
  • Rebalancing is planned as manual emergency work only.

Failure Conditions

  • Stop when shard key cannot support projected growth distribution.
  • Stop when consistency expectations contradict selected topology.
  • Escalate when failover and rebalancing are operationally infeasible.