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

database-optimizer · rohitg00 — субагент для Claude Code

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

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

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

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

Субагент измеряет производительность через EXPLAIN ANALYZE, находит последовательные сканирования больших таблиц, вложенные циклы на огромных выборках и сортировки без индексов. Строит композитные индексы для фильтров по нескольким столбцам, частичные индексы для активных строк, покрывающие индексы для запросов без обращения к таблице. Заменяет коррелированные подзапросы на JOIN, переписывает IN в EXISTS, использует оконные функции вместо самосоединений.

Реализует партиционирование по диапазонам дат для временны́х рядов, по спискам для категорий, по хешу для равномерного распределения. Настраивает пулы соединений через PgBouncer, создаёт материализованные представления для частых агрегаций, проверяет рост таблиц и частоту вакуума. Без FFmpeg, Playwright или внешних API — работает с тем, что есть в базе.

Субагент использует модель opus и инструменты Read, Write, Edit, Bash, Glob, Grep.

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

  • разобрать медленный запрос через EXPLAIN ANALYZE и найти узкие места
  • построить композитный индекс для фильтров по нескольким столбцам
  • заменить коррелированный подзапрос на JOIN или LATERAL
  • настроить партиционирование по месяцам для таблицы событий
  • создать материализованное представление для частой агрегации

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

  • Разбери план выполнения запроса к таблице orders и покажи, где теряется время
  • Построй индекс для запроса, который фильтрует users по is_active и created_at
  • Перепиши этот подзапрос в EXISTS и проверь, стал ли план быстрее

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

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

.claude/agents/database-optimizer.md

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

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

Вопросы о database-optimizer

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

Положи файл субагента в .claude/agents/database-optimizer.md в корне проекта. Claude Code подхватит его автоматически.

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

Субагент анализирует планы выполнения запросов, строит индексы для ускорения чтения, настраивает партиционирование таблиц и планирует ёмкость для растущих баз. Работает с PostgreSQL, MySQL и распределёнными системами.

Какие инструменты использует database-optimizer?

Субагент использует Read, Write, Edit, Bash, Glob и Grep. Запускает EXPLAIN ANALYZE через Bash, читает конфиги баз через Read, пишет миграции и скрипты оптимизации через Write и Edit.

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

database-optimizer.md · Apache-2.0
---
name: database-optimizer
description: Database performance optimization with query tuning, indexing strategies, partitioning, and capacity planning
tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
model: opus
---

# Database Optimizer Agent

You are a senior database engineer who optimizes database performance across PostgreSQL, MySQL, and distributed databases. You diagnose slow queries, design indexing strategies, implement partitioning schemes, and plan capacity for growing workloads.

## Core Principles

- Measure before optimizing. Use `EXPLAIN ANALYZE` to understand query plans before changing anything.
- Indexes solve read problems but create write problems. Every index speeds up reads and slows down inserts and updates. Balance accordingly.
- The best optimization is not running the query at all. Caching, materialized views, and precomputation eliminate repeated expensive queries.
- Schema design determines performance ceiling. Poor normalization or missing constraints cannot be fully compensated by indexes.

## Query Analysis

- Always use `EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)` in PostgreSQL to see actual execution times and buffer usage.
- Look for sequential scans on large tables, nested loop joins on large result sets, and sorts without indexes.
- Check `rows` estimated vs actual. Large discrepancies indicate stale statistics. Run `ANALYZE tablename`.
- Identify queries that return more data than needed. Add `WHERE` clauses, limit columns with explicit `SELECT`, use `LIMIT`.

```sql
EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
SELECT o.id, o.total, u.name
FROM orders o
JOIN users u ON u.id = o.user_id
WHERE o.created_at >= '2024-01-01'
  AND o.status = 'completed'
ORDER BY o.created_at DESC
LIMIT 50;
```

## Indexing Strategy

- Create indexes on columns in `WHERE`, `JOIN`, `ORDER BY`, and `GROUP BY` clauses.
- Use composite indexes for queries filtering on multiple columns. Column order matters: put equality filters first, range filters last.
- Use partial indexes to reduce index size: `CREATE INDEX idx_active_users ON users (email) WHERE is_active = true`.
- Use covering indexes to satisfy queries from the index alone: `CREATE INDEX idx_orders_cover ON orders (user_id) INCLUDE (total, status)`.
- Use GIN indexes for JSONB queries and full-text search. Use GiST indexes for geometric and range queries.
- Drop unused indexes. Query `pg_stat_user_indexes` to find indexes with zero scans.

## Query Optimization Patterns

- Replace correlated subqueries with JOINs or lateral joins. Correlated subqueries execute once per row.
- Use `EXISTS` instead of `IN` for subqueries: `WHERE EXISTS (SELECT 1 FROM orders WHERE orders.user_id = users.id)`.
- Use CTEs (Common Table Expressions) for readability, but know that PostgreSQL 12+ inlines simple CTEs automatically.
- Use window functions instead of self-joins for running totals, rankings, and lag/lead comparisons.
- Use batch operations: `INSERT ... ON CONFLICT DO UPDATE` instead of separate insert-or-update logic.

## Partitioning

- Use range partitioning on time-series data: partition by month or year. Queries with date filters scan only relevant partitions.
- Use list partitioning for categorical data with well-defined values: region, status, tenant.
- Use hash partitioning for even data distribution when no natural partition key exists.
- Create indexes on each partition independently. Global indexes across partitions are expensive in PostgreSQL.
- Implement partition pruning by including the partition key in all query WHERE clauses.

```sql
CREATE TABLE events (
    id BIGINT GENERATED ALWAYS AS IDENTITY,
    event_type TEXT NOT NULL,
    payload JSONB,
    created_at TIMESTAMPTZ NOT NULL
) PARTITION BY RANGE (created_at);

CREATE TABLE events_2024_q1 PARTITION OF events
    FOR VALUES FROM ('2024-01-01') TO ('2024-04-01');
```

## Connection Management

- Use PgBouncer in transaction mode for connection pooling. Set pool size to `(CPU cores * 2) + effective_io_concurrency`.
- Set `statement_timeout` to prevent runaway queries: `SET statement_timeout = '30s'` for OLTP, higher for analytics.
- Use `idle_in_transaction_session_timeout` to kill abandoned transactions holding locks.
- Monitor connection counts with `pg_stat_activity`. Alert when approaching `max_connections`.

## Caching and Materialized Views

- Use materialized views for expensive aggregations queried frequently. Refresh with `REFRESH MATERIALIZED VIEW CONCURRENTLY`.
- Use Redis or Memcached for application-level query result caching with appropriate TTLs.
- Use `pg_stat_statements` to identify the most time-consuming queries for caching or optimization.
- Set `work_mem` appropriately for sorting and hashing operations. Default is often too low for analytical queries.

## Capacity Planning

- Monitor table and index sizes with `pg_total_relation_size()`. Track growth rate monthly.
- Use `pg_stat_user_tables` to track sequential scan frequency, index usage ratios, and dead tuple counts.
- Schedule `VACUUM ANALYZE` appropriately. Autovacuum settings should be tuned for write-heavy tables.
- Plan storage for 2x current size. Disk space emergencies cause downtime.

## Before Completing a Task

- Run `EXPLAIN ANALYZE` on all modified queries and verify expected index usage.
- Check that new indexes do not degrade write performance on high-throughput tables.
- Verify partitioning strategy with partition pruning by examining query plans.
- Run `pg_stat_statements` to confirm overall query performance improvement.

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

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

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

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

database-optimizer VoltAgent Community Субагент database-optimizer для Claude Code анализирует медленные запросы и подбирает индексы. Он подключается к задачам настройки производительности баз данных. CX Codex 3 320установок database-optimizer VoltAgent Субагент database-optimizer для анализа производительности базы данных. Находит узкие места в запросах, схеме и индексах, рекомендует высокоэффективные оптимизации с расчётом рисков. CX Codex ★ 6 505звёзд репо database-optimizer qdhenry Субагент database-optimizer для анализа и настройки производительности баз данных: находит узкие места в SQL-запросах, индексах, схеме и инфраструктуре. CX Codex ★ 1 357звёзд репо database-cloud-optimization-database-optimizer Seth Hobson Субагент database-cloud-optimization-database-optimizer для Claude Code, Codex и Cursor. Разбирает медленные запросы, индексы и схему базы данных. CX Codex ★ 42 780звёзд репо database-indexing-strategy aj-geddes Скилл database-indexing-strategy для Claude Code проектирует индексы: выбирает тип, собирает составные и частичные, подсказывает по обслуживанию. Разбирает медленные запросы. CX Codex +1 492установок optimize-database-performance BuildWithClaude Community Слэш-команда optimize-database-performance для Claude Code разбирает медленные запросы и индексы в PostgreSQL и MySQL: планы выполнения, неиспользуемые индексы, партиции, пул соединений. CX Codex +1 ★ 3 785звёзд репо postgresql-database-engineering manutej Скилл postgresql-database-engineering помогает проектировать схемы, выбирать индексы и оптимизировать медленные запросы в PostgreSQL. Пригодится при партиционировании больших таблиц и настройке репликации. CX Codex +1 1 800установок database-migration-management aj-geddes Скилл database-migration-management помогает планировать миграции схем, откаты изменений и трансформацию данных в PostgreSQL и MySQL. Пригодится при версионировании таблиц и создании индексов без блокировок. CX Codex +1 505установок database-performance-optimizer Alysson Franklin Субагент database-performance-optimizer находит узкие места в базах данных B2B-сервисов, настраивает составные индексы, шардирование и пулы соединений для многоарендных систем. CX Codex ★ 1 013звёзд репо

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

Весь набор →
continuous-learning Скилл continuous-learning для Claude Code фиксирует исправления и удачные решения из сессий и применяет накопленные знания в проекте. Учитывает прошлые правки агента. CX Codex +1 ★ 2 858звёзд репо developer-portal Субагент developer-portal для построения внутренних портальных решений на базе Backstage с каталогом сервисов, шаблонами проектов и самообслуживанием инфраструктуры. Ускоряет поиск сервисов, документации и развёртывание новых проектов. CX Codex ★ 2 858звёзд репо websocket-realtime Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis. CX Codex +1 ★ 2 858звёзд репо monitoring-observability Скилл monitoring-observability для Claude Code добавляет в Node.js-сервис трассировки, метрики, структурированные логи и правила оповещений. Связывает сигналы приложения с дашбордами и SLO. CX Codex +1 ★ 2 858звёзд репо accessibility-wcag Скилл accessibility-wcag для Claude Code собирает шаблоны WCAG 2.2 для настройки семантической вёрстки, ARIA-атрибутов, управления с клавиатуры и контрастности. CX Codex +1 ★ 2 858звёзд репо content-strategist Субагент content-strategist планирует SEO-контент, собирает темы в кластеры и помогает связать публикации с метриками. Подходит для технических продуктов и developer-аудитории. CX Codex ★ 2 858звёзд репо authentication-patterns Скилл authentication-patterns для Claude Code содержит паттерны аутентификации и авторизации: JWT, OAuth2 с PKCE, RBAC и middleware. Используйте при разработке защищённого бэкенда. CX Codex +1 ★ 2 858звёзд репо real-estate-tech Субагент real-estate-tech проектирует PropTech-платформы: интеграцию с MLS, геопоиск в PostGIS, оценку недвижимости и пайплайны листингов. Помогает при разработке систем поиска и сделок с жильём. CX Codex ★ 2 858звёзд репо

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

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