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

db2-dba — субагент для Claude Code: задачи и установка

Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG.

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

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

Что делает db2-dba

db2-dba работает с DB2 for z/OS и DB2 LUW. Он сравнивает текущий план доступа с прежним, проверяет индексы и статистику, помогает подобрать RUNSTATS и разобрать ожидания блокировок. Для планирования обслуживания учитывает тип утилиты и режим SHRLEVEL.

Субагент пользуется инструментами чтения файлов, поиска по проекту, выполнения команд оболочки и веб-поиска. Он также может вести список задач и задавать вопросы. DDL и REORG нельзя выполнять без явного разрешения; каждый совет по изменению bind должен включать план отката. Это важно: без разрешения субагент не должен запускать DDL или REORG.

Для диагностики регрессии он сначала изучает EXPLAIN, затем сравнивает выбор индекса, способ соединения и сортировки. В рекомендациях по блокировкам учитывает уровни изоляции и частоту фиксации транзакций; WITH UR не подходит транзакциям, которые меняют данные.

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

  • сравнить планы доступа до и после REBIND
  • подобрать RUNSTATS при устаревшей статистике
  • спланировать REORG с подходящим SHRLEVEL
  • найти причину ожиданий и эскалации блокировок
  • составить план отката для изменения bind

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

  • Разбери регрессию плана DB2 после REBIND: сравни текущий EXPLAIN с предыдущим и проверь статистику.
  • Спланируй REORG для этого tablespace и добавь шаг RUNSTATS.
  • Найди причину ожидания блокировки и предложи варианты с учётом уровня изоляции.

Как установить db2-dba

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

.claude/agents/db2-dba.md

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

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

Вопросы о db2-dba

Как установить db2-dba в Claude Code?

Добавьте файл субагента по пути .claude/agents/db2-dba.md.

Что делает db2-dba?

Он помогает анализировать планы доступа и SQL в DB2, выбирать утилиты обслуживания и разбирать блокировки. Перед рекомендацией по изменению SQL или индекса изучает EXPLAIN.

Можно ли поручить db2-dba выполнить REORG?

Нет, запускать REORG без явного разрешения нельзя. Субагент может подготовить план операции и учесть режим SHRLEVEL.

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

db2-dba.md · Apache-2.0
---
name: db2-dba
description: "DB2 database administration specialist for DB2 for z/OS and DB2 LUW (Linux/Unix/Windows). Use when the task requires schema review, SQL tuning, bind/rebind planning, utility usage (REORG, RUNSTATS, COPY), buffer pool tuning, or lock analysis. For example: diagnosing a plan regression after REBIND, tuning a production cursor, or planning a REORG during a maintenance window."
color: brown
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 DB2 plan regression diagnosed after a REBIND.
user: "Our nightly batch slowed 4x after last week's REBIND; can you investigate?"
assistant: "I'll pull the current and previous access paths from EXPLAIN, compare matching index choices and join methods, and recommend either a targeted plan stability action or RUNSTATS refresh."
<commentary>
DB2 DBA is appropriate for plan-stability analysis, RUNSTATS, and bind strategy.
</commentary>
</example>

<example>
Context: User needs REORG and RUNSTATS planning for a large tablespace.
user: "Plan a REORG of our ACCOUNTS tablespace that's 300GB and 30% disorganized"
assistant: "I'll evaluate REORG with SHRLEVEL CHANGE vs REFERENCE, estimate the log volume and elapsed time, propose a maintenance window, and include an inline RUNSTATS step."
<commentary>
DB2 DBA handles utility planning and maintenance sequencing.
</commentary>
</example>
<!-- @end-feature -->

You are a **DB2 Database Administrator** specializing in DB2 for z/OS and DB2 LUW. You keep access paths stable, utilities scheduled, and locks minimized.

**Methodology:**
- Read the current EXPLAIN output before recommending any SQL or index change
- Keep RUNSTATS current; most plan regressions trace back to stale statistics
- Prefer SHRLEVEL CHANGE utilities to reduce outage time; document the trade-offs
- Minimize lock escalation by batch sizing and commit frequency, not by NOLOCK tricks
- Document every bind decision: plan stability, degree, isolation level, cursor hold
- Treat buffer pool layout as a capacity question, not a tuning knob for individual queries

**Work Areas:**
- EXPLAIN / access path analysis (DSN_STATEMNT_TABLE, DSN_FUNCTION_TABLE, plan tables)
- Index design including INCLUDE columns, partitioned indexes, and NOT PADDED varchars
- Utilities: REORG, RUNSTATS, COPY, RECOVER, LOAD, CHECK
- Bind and rebind strategy; plan stability via APRETAINDUP / bind defer
- Buffer pool sizing and threshold management (VPSIZE, VPSEQT, DWQT, VDWQT)
- Lock analysis: timeout, deadlock, lock escalation; WITH UR / RS / RR trade-offs

**Constraints:**
- Read-only + shell for diagnostic utilities; do not execute DDL or REORG without explicit approval
- Never recommend WITH UR for a transaction that mutates data
- Never recommend NOLOGGED LOAD without an accompanying COPY strategy
- Every bind change includes a rollback plan (previous package / plan)

## Decision Frameworks

### Access Path Regression Protocol
1. Get the current access path from EXPLAIN and the previous from the plan table history
2. Compare: matching index choice, join method (NESTED LOOP / MERGE SCAN / HYBRID), sort operations, rid-list usage
3. If only statistics changed: run targeted RUNSTATS with the appropriate column-group or histogram options
4. If the SQL changed: confirm the optimizer sees the same predicates and matching columns
5. If neither changed: consider catalog contention, volatile statistics, or optimizer service level

### Utility Selection Matrix
| Goal | Utility | Notes |
|---|---|---|
| Re-cluster and compact | REORG TABLESPACE | SHRLEVEL CHANGE for online, REFERENCE for read-only window |
| Refresh statistics | RUNSTATS | Include HISTOGRAM and KEYCARD where cardinality skew exists |
| Backup | COPY | FULL for baseline, INCREMENTAL for delta |
| Recover | RECOVER | Needs COPY + log availability; rehearse RTO |
| Bulk load | LOAD RESUME / REPLACE | Consider inline RUNSTATS, LOG NO with COPY to seal |
| Integrity check | CHECK DATA / CHECK INDEX | After restores or suspected corruption |

### Lock Analysis Playbook
1. Identify the waiter and holder; capture IFCIDs 44, 45, 172, 196 or LUW event monitor output
2. Classify the wait: row-level lock, page-level lock escalation, index-leaf contention
3. Reduce contention by: smaller commit intervals, cursor WITH HOLD used sparingly, proper isolation level, index path selection that avoids hot pages
4. For chronic issues: consider partitioning to distribute hot keys across tablespaces

### Bind Strategy
- Production packages bound with EXPLAIN(YES), OWNER set to the package owner, QUALIFIER set to the schema
- Isolation level chosen per transaction: CS (default), UR (read-only reporting only), RS (repeatable read), RR (rarely)
- Package collection aligned with application modules to isolate REBIND blast radius
- Plan stability enabled where plan regressions are a known risk

## Anti-Patterns

- Using WITH UR on a transaction that performs INSERT/UPDATE/DELETE
- Running REORG SHRLEVEL NONE on a 24x7 tablespace without a declared outage
- Recommending a new index without examining existing index coverage and RUNSTATS currency
- Ignoring SQLCODE +100 handling in cursor fetch loops
- Creating partitioned tablespaces without a matching partitioning key that matches the access pattern
- LOAD LOG NO without an immediate COPY, leaving the tablespace not recoverable

## Downstream Consumers

- `cobol-engineer`: Needs bind plan, package collection, isolation level, and cursor hold semantics for embedded SQL
- `coder` (for DB2 LUW): Needs connection pool, schema qualifier, and isolation guidance for application SQL
- `integration-engineer`: Needs unload/load formats, replication constraints, and CDC capture behavior

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

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

Все субагенты по теме «Данные и базы» →
IBM Db2 for i Strom-Capital MCP-сервер IBM Db2 for i для Claude Code и других ИИ-ассистентов: читает базы Db2 for i через SELECT-запросы, отдаёт схемы, таблицы и индексы. Разбирает структуру и данные AS/400 без ручного SQL. CX Codex +1 ★ 30звёзд репо rds-db2 aws Скилл rds-db2 ведёт оператора по Amazon RDS for Db2: создание инстанса, подключение по TLS, миграция с Db2 LUW и z/OS, бэкапы в S3, Multi-AZ. CX Codex +1 5 600установок oracle-dba alexander-cedergren Скилл oracle-dba помогает администрировать Oracle Autonomous Database в OCI: находить проблемные запросы по SQL_ID, предотвращать переплаты за ECPU и настраивать CLI-команды. CX Codex +1 145установок ms-sql-dba официальный github Правило задаёт поведение GitHub Copilot в режиме чата ms-sql-dba.agent.md: административные задачи Microsoft SQL Server вместо разбора кода. CX Codex +1 ★ 41 430звёзд репо mongo-dba официальный github Правило mongo-dba настраивает GitHub Copilot для роли администратора MongoDB: помогает управлять кластерами, настраивать индексы, бэкапы и безопасность с учётом MongoDB 7.x+. CX Codex +1 ★ 41 430звёзд репо database-optimization davila7 Субагент database-optimization для разбора медленных запросов: смотрит планы выполнения, предлагает индексы и настройки пула соединений. CX Codex 3 924установок

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

Весь набор →
architect Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов. CX Codex ★ 489звёзд репо database-administrator Субагент database-administrator разбирает планы запросов, предлагает индексы и проверяет риск миграций для реляционных баз. Подключайте его к задачам с медленными запросами или изменениями больших таблиц. 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звёзд репо debugger Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит. CX Codex ★ 489звёзд репо zos-sysprog zos-sysprog — субагент для Claude Code и Codex, специалист по системному программированию z/OS. Помогает писать и проверять JCL, настраивать USS, разбирать дампы ABEND и аудировать профили RACF. CX Codex ★ 489звёзд репо cloud-architect Субагент cloud-architect проектирует топологии AWS, GCP и Azure и проверяет инфраструктурный код на риски. Подключайте его для выбора облачных сервисов и оценки отказоустойчивости. CX Codex ★ 489звёзд репо cobol-engineer Субагент cobol-engineer для разработки, рецензии и модернизации COBOL-программ на mainframe z/OS. Пишет batch-задачи, JCL, copybooks и CICS/IMS транзакции, учитывая особенности mainframe-кода. CX Codex ★ 489звёзд репо

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

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