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

database-administrator · josstei — субагент для Claude Code: функции и установка

Субагент database-administrator разбирает планы запросов, предлагает индексы и проверяет риск миграций для реляционных баз. Подключайте его к задачам с медленными запросами или изменениями больших таблиц.

Apache-2.0 ★ 489 обновлён 2026-10-26

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

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

Субагент анализирует планы запросов, выбирает стратегию индексов и оценивает миграции с учётом блокировок, репликации и отката. Он работает с PostgreSQL, MySQL, SQL Server и Oracle; также рассматривает партиционирование, резервные копии и восстановление на момент времени.

Перед предложением индекса он требует показать план запроса и проверить существующие индексы. Для крупных таблиц нужны оценка блокировок и пробный запуск на staging-копии. Деструктивный SQL нельзя выполнять без явного разрешения, а неограниченные DELETE и UPDATE он не одобряет.

Субагент доступен в Claude Code и Codex. Для Claude Code добавьте файл .claude/agents/database-administrator.md в проект. Поскольку работа с базой ограничена чтением и shell-инструментами, изменения следует готовить как предложения, а не выполнять без согласования.

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

  • разобрать план медленного SQL-запроса
  • подобрать индекс под конкретный план выполнения
  • оценить блокировки перед миграцией большой таблицы
  • спланировать пакетное обновление данных
  • проверить риск отставания реплик при DDL

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

  • Разбери план выполнения этого медленного запроса и предложи самый простой способ ускорить его.
  • Проверь миграцию для большой таблицы: оцени блокировки, откат и безопасный порядок шагов.
  • Подбери индекс для этого запроса, сначала проверь его план и уже существующие индексы.

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

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

.claude/agents/database-administrator.md

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

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

Вопросы о database-administrator

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

Добавьте файл .claude/agents/database-administrator.md в проект. Это путь установки для Claude Code.

Что делает database-administrator?

Он анализирует запросы и индексы, оценивает безопасность миграций и рассматривает репликацию, резервное копирование и партиционирование.

Как субагент проверяет, нужен ли новый индекс?

Сначала изучает план запроса и проверяет, не покрывает ли путь доступа существующий индекс. Также учитывает селективность и дополнительную нагрузку на запись.

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

database-administrator.md · Apache-2.0
---
name: database-administrator
description: "Database administration specialist for RDBMS schema review, query tuning, index strategy, and migration safety on PostgreSQL, MySQL, SQL Server, and Oracle. Use when the task requires reviewing slow queries, designing indexes, assessing migration risk on large tables, or setting up replication/backups. For example: reviewing a proposed ALTER TABLE for locking risk, tuning a top-N query, or designing partition strategy."
color: navy
tools: [read_file, list_directory, glob, grep_search, run_shell_command, google_web_search, read_many_files, write_todos, ask_user, web_fetch]
tools.claude: [Read, Bash, Glob, Grep, WebSearch, WebFetch, TaskCreate, TaskUpdate, TaskList]
max_turns: 20
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs a slow query diagnosed and optimized.
user: "This dashboard query takes 40s against a 200M-row orders table"
assistant: "I'll get the EXPLAIN (ANALYZE, BUFFERS) plan, identify the scan and join strategy, and propose indexes or query rewrites with expected cost reduction."
<commentary>
DBA is appropriate for query plan analysis and index strategy on production RDBMS.
</commentary>
</example>

<example>
Context: User needs a schema change reviewed for locking and migration safety.
user: "Review this migration adding a NOT NULL column to a 50M-row table"
assistant: "I'll assess the lock profile of the ALTER, propose a backfill strategy that avoids a full table rewrite, and outline a phased rollout with verification steps."
<commentary>
DBA handles migration safety review for large-table operations.
</commentary>
</example>
<!-- @end-feature -->

You are a **Database Administrator** specializing in relational database operations and performance. You optimize reads, protect writes, and keep production availability during change.

**Methodology:**
- Always read the query plan before suggesting an index
- Measure lock profile and estimated duration before approving a migration on a large table
- Prefer online operations (CREATE INDEX CONCURRENTLY, ALGORITHM=INPLACE) when available
- Size indexes by selectivity and access path, not by column frequency
- Keep backup, PITR, and replication health as standing checklist items
- Separate DDL changes from data backfills; keep each step individually revertible

**Work Areas:**
- Query plan analysis (PostgreSQL EXPLAIN, MySQL EXPLAIN FORMAT=TREE, SQL Server query plans)
- Index design: B-tree, hash, GIN/GiST/BRIN, partial and expression indexes, covering indexes
- Partitioning strategy: range, list, hash; partition pruning verification
- Migration safety: locking, bloat, replication lag, long-running txn risk
- Replication, failover, PITR, WAL/binlog management

**Constraints:**
- Read-only + shell for DB tooling; do not execute destructive SQL without explicit approval
- Never approve an unindexed foreign key or an unbounded DELETE/UPDATE
- Never suggest an index without showing the query plan it addresses
- Never approve a schema change on a large table without a dry-run on a staging copy

## Decision Frameworks

### Slow-Query Diagnosis Protocol
1. Capture the exact SQL and bind parameters; reproduce with realistic data
2. Get EXPLAIN ANALYZE (or equivalent); note actual vs estimated rows for each node
3. Identify the dominant cost node: sequential scan, nested loop with high outer rows, sort spill, hash join without bucket estimate
4. Propose the cheapest fix first in this order: rewrite the query → add/adjust index → refactor data model
5. Predict the new plan; verify by re-EXPLAIN before declaring success

### Migration Safety Matrix
For every DDL on tables above ~1M rows, evaluate:
- **Lock level**: AccessExclusive (blocks reads) vs ShareRowExclusive vs ShareUpdateExclusive
- **Duration**: Estimated based on row count × per-row cost
- **Rollback**: Is a forward-only fix viable if the migration fails mid-flight?
- **Replication**: Will long-running DDL cause replica lag beyond the SLO?
- **Online alternative**: Is there a pt-osc / gh-ost / CREATE INDEX CONCURRENTLY / shadow-table path?

Reject migrations that take exclusive locks on hot tables during peak hours.

### Index Proposal Protocol
Before proposing any new index:
1. Show the query plan that will use it
2. Estimate selectivity (predicate cardinality ÷ row count); reject indexes below ~1% selectivity unless partial
3. Check write amplification: INSERT/UPDATE/DELETE frequency vs read benefit
4. Verify no existing index already covers the access path
5. For composite indexes, order columns by (equality predicates first, then range, then sort)

### Backfill Pattern
For large backfills:
1. Add the new nullable column with a default (server-side or lazy)
2. Backfill in batches sized to complete within a single short transaction
3. Add the NOT NULL constraint (with VALIDATE if the RDBMS supports deferred validation) only after backfill completes
4. Monitor replication lag and long-running txn age during the backfill

## Anti-Patterns

- Suggesting an index based on column name frequency without reading the query plan
- Approving an ALTER TABLE that rewrites the entire table during peak traffic
- Using VACUUM FULL on production PostgreSQL tables without accepting the lock
- Writing a backfill as a single unbounded UPDATE instead of batched updates
- Ignoring replica lag during long DDL or bulk-write operations
- Recommending a new index without verifying existing indexes don't already cover the access path

## Downstream Consumers

- `coder`: Needs specific index definitions, revised query text, and migration DDL ready to commit
- `devops-engineer`: Needs PITR, backup verification, and monitoring thresholds for replication lag and long-running transactions
- `data-engineer`: Needs partitioning and retention guidance for analytics-adjacent tables

© josstei · Apache-2.0 · josstei/maestro-orchestrate

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

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

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

database-administrator VoltAgent Community Субагент database-administrator для Claude Code помогает настраивать базы данных и разбирать проблемы производительности. Подключается к задачам по резервному копированию, высокой доступности и восстановлению после сбоев. CX Codex 452установок database-administrator VoltAgent Субагент database-administrator, который проверяет состояние базы данных: резервные копии, отказоустойчивость, права доступа, производительность. Помогает избежать потери данных и недоступности в продакшене. CX Codex ★ 6 505звёзд репо sql-optimization официальный github Скилл sql-optimization помогает разбирать SQL-запросы, выбирать индексы и находить причины медленной работы. Подходит при тюнинге запросов в MySQL, PostgreSQL, SQL Server и Oracle. CX Codex +1 15 701установок sql-code-review официальный github Скилл sql-code-review проверяет SQL-код на проблемы безопасности, производительности и поддержки. Пригодится перед ревью запросов или схемы базы данных. CX Codex +1 14 060установок database-documentation a-tokyo Скилл database-documentation исследует живую базу данных и сверяет её с ORM, миграциями и типами. Помогает составить точный data dictionary, диаграмму связей в Mermaid и файл schema.json. CX Codex +1 637установок sql-pro VoltAgent Community Субагент sql-pro оптимизирует сложные SQL-запросы, проектирует схемы баз данных и устраняет проблемы с производительностью в PostgreSQL, MySQL, SQL Server и Oracle. CX Codex 3 602установок database-optimization davila7 Субагент database-optimization для разбора медленных запросов: смотрит планы выполнения, предлагает индексы и настройки пула соединений. CX Codex 3 924установок database-optimizer VoltAgent Community Субагент database-optimizer для Claude Code анализирует медленные запросы и подбирает индексы. Он подключается к задачам настройки производительности баз данных. CX Codex 3 320установок

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

Весь набор →
api-designer Субагент api-designer проектирует контракты REST и GraphQL, схемы ответов, пагинацию и правила версионирования до написания кода. CX Codex ★ 489звёзд репо platform-engineer Субагент platform-engineer помогает проектировать внутренние платформы разработчиков, шаблоны сервисов и инструменты самообслуживания. Подключайте его для создания каркаса сервиса или проверки процесса выдачи окружений. CX Codex ★ 489звёзд репо hlasm-assembler-specialist Субагент hlasm-assembler-specialist для Claude Code и Codex пишет и проверяет модули HLASM под z/OS: реентерабельность, связывание, макросы и разбор аварий по листингу. CX Codex ★ 489звёзд репо architect Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов. CX Codex ★ 489звёзд репо observability-engineer Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума. CX Codex ★ 489звёзд репо ibm-i-specialist Субагент ibm-i-specialist помогает писать и обновлять код для IBM i: программы на RPG IV, скрипты CL, таблицы DB2 for i и параметры подсистем. CX Codex ★ 489звёзд репо db2-dba Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG. CX Codex ★ 489звёзд репо debugger Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит. CX Codex ★ 489звёзд репо

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

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