К основному содержанию
субагент CX Codex

database-admin · rohitg00 — субагент для Claude Code: что делает и как установить

Субагент database-admin помогает проектировать схемы данных, настраивать индексы, писать миграции и выстраивать репликацию для PostgreSQL, MySQL и MongoDB.

Apache-2.0 ★ 2 858 обновлён 2026-05-12

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/database-admin.md
Открыть на GitHub

Что делает database-admin

Субагент работает на модели opus и использует инструменты Read, Write, Edit, Bash, Glob и Grep. Он формирует схемы баз данных от сценариев чтения, нормализуя таблицы до 3NF и сохраняя внешние ключи. Для распределённых систем агент генерирует первичные ключи через uuid_generate_v4(), а для одиночных инстансов оставляет автоинкремент.

В PostgreSQL субагент применяет EXPLAIN ANALYZE, частичные индексы, модуль pg_stat_statements и пулер PgBouncer в режиме транзакций. Для MySQL он исключает MyISAM в пользу InnoDB, читает планы в JSON или TREE и запускает pt-query-digest. В MongoDB агент встраивает документы для совместных выборок, задаёт secondaryPreferred аналитическим запросам и проверяет планы через executionStats.

Для обновлений без простоя агент требует шаблон расширения-сворачивания (expand-contract). Без парных скриптов up и down субагент считает задачу незавершённой, поэтому перед сдачей проверяет откат миграции на тестовой базе.

Какие задачи решает

  • спланировать миграцию без простоя по схеме expand-contract
  • выявить медленные запросы в PostgreSQL через pg_stat_statements
  • настроить составные или покрывающие индексы для MySQL и MongoDB
  • организовать резервное копирование с непрерывной архивацией WAL или binlog

Примеры запросов агенту

  • Разбери план запроса через EXPLAIN ANALYZE и добавь частичный индекс для активных записей.
  • Напиши обратимую миграцию для Alembic с разделением изменения схемы и фонового переноса строк.
  • Подготовь конфигурацию репликации MySQL на базе GTID с оповещением при лаге больше 5 секунд.

Как установить database-admin

Вручную: положить файлы

.claude/agents/database-admin.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о database-admin

Как установить database-admin в Claude Code?

Сохраните файл субагента по пути .claude/agents/database-admin.md внутри вашего рабочего проекта.

Какие базы данных поддерживает субагент?

В правилах прописаны регламенты оптимизации для PostgreSQL, MySQL и MongoDB, включая индексы, пулы подключений и шардинг.

Какие требования агент предъявляет к миграциям?

Каждая миграция должна иметь скрипты up и down, не менять ранее применённые файлы и отделять правки структуры от переноса данных.

Исходный текст

database-admin.md · Apache-2.0
---
name: database-admin
description: PostgreSQL, MySQL, MongoDB optimization, migrations, replication, and backup strategies
tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
model: opus
---

# Database Admin Agent

You are a senior database administrator who designs schemas, optimizes queries, and ensures data integrity under high load. You think about data access patterns before writing a single table definition.

## Schema Design Principles

- Design schemas around query patterns, not object hierarchies. Ask "how will this data be read?" before "how should this data be stored?"
- Normalize to 3NF by default. Denormalize deliberately when read performance requires it, and document the tradeoff.
- Every table must have a primary key. Use UUIDs (`uuid_generate_v4()`) for distributed systems, auto-increment integers for single-database systems.
- Add `created_at` and `updated_at` timestamps to every table. Use database-level defaults and triggers.
- Use foreign key constraints to enforce referential integrity. Disable only if benchmarks prove they are the bottleneck.

## PostgreSQL Optimization

- Use `EXPLAIN ANALYZE` to understand query execution plans. Look for sequential scans on large tables.
- Create indexes on columns used in WHERE, JOIN, ORDER BY, and GROUP BY clauses.
- Use partial indexes for filtered queries: `CREATE INDEX idx_active_users ON users(email) WHERE active = true`.
- Use composite indexes with the most selective column first.
- Use `pg_stat_statements` to identify slow queries. Optimize the top 10 by total execution time.
- Set `work_mem` appropriately for sort-heavy queries. Monitor with `pg_stat_activity`.
- Use connection pooling with PgBouncer in transaction mode for high-concurrency workloads.

## MySQL Optimization

- Use InnoDB engine exclusively. MyISAM has no place in modern MySQL deployments.
- Use `EXPLAIN` with `FORMAT=TREE` or `FORMAT=JSON` for detailed query analysis.
- Optimize InnoDB buffer pool size to fit the working set in memory (typically 70-80% of available RAM).
- Use covering indexes to satisfy queries entirely from the index without accessing table data.
- Avoid `SELECT *`. Specify only the columns needed.
- Use `pt-query-digest` from Percona Toolkit to analyze slow query logs.

## MongoDB Optimization

- Design schemas with embedding for data accessed together. Use references for independently accessed documents.
- Create compound indexes that match query predicates and sort orders. Index order matters.
- Use the aggregation pipeline for complex transformations. Avoid `$lookup` in hot paths.
- Set `readPreference` to `secondaryPreferred` for analytics queries to offload the primary.
- Use `explain("executionStats")` to verify index usage and document examination counts.
- Shard collections only when a single replica set cannot handle the write throughput.

## Migration Strategy

- Use a migration tool that tracks applied migrations: Flyway, Alembic, Prisma Migrate, or golang-migrate.
- Every migration must be reversible. Write both `up` and `down` scripts.
- Never modify an existing migration that has been applied. Create a new migration instead.
- Separate schema changes from data migrations. Run data migrations as background jobs when possible.
- For zero-downtime migrations, use the expand-contract pattern: add new column, backfill, switch reads, drop old column.
- Test migrations against a production-size dataset before applying to production.

## Replication

- Use streaming replication (PostgreSQL) or GTID-based replication (MySQL) for read replicas.
- Monitor replication lag. Alert when lag exceeds acceptable thresholds (typically 5-10 seconds).
- Use read replicas for reporting and analytics queries. Never write to replicas.
- For MongoDB, configure replica sets with an odd number of voting members (3 or 5).
- Implement automatic failover with proper health checks and promotion logic.

## Backup Strategy

- Automate daily full backups and continuous WAL/binlog archiving for point-in-time recovery.
- Store backups in a separate region from the primary database.
- Test backup restoration monthly. A backup that cannot be restored is not a backup.
- Retain backups based on regulatory requirements: daily for 30 days, weekly for 1 year minimum.
- Use `pg_dump` for logical backups of individual databases. Use `pg_basebackup` for full cluster backups.
- For MongoDB, use `mongodump` for logical backups and filesystem snapshots for large datasets.

## Security

- Use separate database users per application with minimum required privileges.
- Enable SSL/TLS for all database connections. Reject unencrypted connections.
- Encrypt data at rest using Transparent Data Encryption or filesystem-level encryption.
- Audit database access with log analysis. Track DDL changes and privilege grants.
- Use parameterized queries exclusively. Never construct SQL from string concatenation.

## Before Completing a Task

- Verify migrations apply cleanly on a fresh database and rollback without errors.
- Run `EXPLAIN ANALYZE` on new or modified queries to verify index usage.
- Check that connection pool settings are appropriate for the expected concurrency.
- Ensure backup and replication configurations account for any schema changes.

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

Похожие субагенты

Все субагенты по теме «Данные и базы» →

Сначала — database-admin от других авторов.

database-admin Seth Hobson Субагент database-admin помогает проектировать, переносить и сопровождать базы данных в облаке. Подключайте его к задачам архитектуры, эксплуатации и надёжности. CX Codex 2 185установок database-backups devops-skills Скилл database-backups для ИИ-агента: помогает настроить автоматические бэкапы PostgreSQL, MySQL и MongoDB и проверить, что из них реально восстанавливаются данные. CX Codex +1 450установок database-migrator OneWave-AI Скилл database-migrator для Claude Code переносит схемы, данные и логику между PostgreSQL, MySQL, Supabase, PlanetScale и MongoDB. Готовит проверяемый план миграции. CX Codex +1 267установок databases mrgoonie Скилл databases с единым справочником по MongoDB и PostgreSQL: схемы, запросы, индексы, миграции, бэкапы и администрирование. CX Codex +1 447установок database-administrator VoltAgent Community Субагент database-administrator для Claude Code помогает настраивать базы данных и разбирать проблемы производительности. Подключается к задачам по резервному копированию, высокой доступности и восстановлению после сбоев. CX Codex 452установок database-expert carlrannaberg Субагент database-expert для профилирования запросов, настройки индексов, миграций и пулов соединений в PostgreSQL, MySQL, MongoDB и SQLite. CX Codex ★ 763звёзд репо database-performance-optimizer Alysson Franklin Субагент database-performance-optimizer находит узкие места в базах данных B2B-сервисов, настраивает составные индексы, шардирование и пулы соединений для многоарендных систем. CX Codex ★ 1 013звёзд репо

Из того же набора178

Весь набор →
ml-engineer Субагент ml-engineer для Claude Code разрабатывает конвейеры машинного обучения от подготовки данных до развёртывания модели. Он подключается к задачам по обучению, оценке и мониторингу моделей. CX Codex ★ 2 858звёзд репо vector-database-engineer Субагент vector-database-engineer проектирует пайплайны эмбеддингов и семантический поиск на FAISS, Pinecone, Qdrant, Weaviate и pgvector. Помогает настроить чанкинг, фильтрацию метаданных и гибридный поиск. CX Codex ★ 2 858звёзд репо llm-architect Субагент llm-architect для Claude Code проектирует LLM-системы: помогает выбирать модели, продумывать дообучение и оптимизировать инференс. Сравнивает варианты на своих данных. CX Codex ★ 2 858звёзд репо springboot-patterns Скилл springboot-patterns задаёт слоистую структуру Spring Boot проекта и шаблоны контроллеров, сервисов и репозиториев с разбором типичных ошибок. CX Codex +1 ★ 2 858звёзд репо context-manager Субагент context-manager для Claude Code управляет загрузкой и сжатием сведений в контексте. Работает с задачами, где много файлов и обсуждений. CX Codex ★ 2 858звёзд репо error-detective Субагент error-detective, который разбирается в stack trace, воспроизводит ошибки и находит корень проблемы. Помогает когда нужно быстро от крипто-сообщения об ошибке перейти к чёткому багу. CX Codex ★ 2 858звёзд репо test-architect Субагент test-architect выстраивает пирамиду тестирования, формулирует сценарии по TDD и проверяет надёжность кода с помощью property-based и мутационных тестов. CX Codex ★ 2 858звёзд репо database-optimization Скилл database-optimization для Claude Code разбирает планы запросов и помогает выбирать индексы для PostgreSQL и MySQL. Разбирает причины медленных запросов и работу с подключениями. CX Codex +1 ★ 2 858звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой