К основному содержанию
скилл CX Codex

pg_dump — скилл для Claude Code: что делает и как установить

Направляет ИИ-агента к исходникам утилиты pg_dump для извлечения схем и запросов к системным каталогам PostgreSQL 14–18.

Apache-2.0 1 установок ★ 1 089 обновлён 2026-10-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pgplex/pgschema --skill pg_dump -a claude-code
Открыть на GitHub

Что делает pg_dump

Скилл содержит справочник по исходному коду pg_dump из официального репозитория PostgreSQL (src/bin/pg_dump/). Он сопоставляет типы объектов базы данных — таблицы, триггеры, индексы, представления и политики RLS — с функциями парсинга и таблицами системного каталога вроде pg_class, pg_trigger или pg_constraint.

Внутри описан порядок переноса логики каталожных запросов в код проекта pgschema на Go: привязка параметров через pgx, обработка NULL и вызовы вспомогательных функций вроде pg_get_expr или pg_get_triggerdef. Например, для условий WHEN в триггерах инструкция требует читать pg_catalog.pg_trigger, запрещая использовать information_schema.

Материал рассчитан только на версии PostgreSQL с 14 по 18 и сфокусирован на структуре схемы. Логику архивации, форматирование вывода и совместимость со старыми версиями переносить нельзя.

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

  • Написать точный SQL-запрос к системным каталогам PostgreSQL для нового типа объектов
  • Получить корректный DDL триггеров и индексов через вспомогательные функции pg_get_*
  • Адаптировать каталожные выборки pg_dump под Go-драйвер pgx в ir/inspector.go
  • Настроить ветвление запросов под различия между версиями PostgreSQL 14–18

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

  • Посмотри реализацию getTriggers() в pg_dump.c и напиши запрос для ir/inspector.go.
  • Как pg_dump извлекает условия WHEN для триггеров без использования information_schema?
  • Сверь запрос к pg_constraint с кодом getConstraints() для поддержки PostgreSQL 16.

Как установить pg_dump

1Через Skills CLI (Vercel)

npx skills add pgplex/pgschema --skill pg_dump -a claude-code

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

~/.claude/skills/pg_dump/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pg_dump/

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

Вопросы о pg_dump

Как установить pg_dump в Claude Code?

Выполните команду npx skills add pgplex/pgschema --skill pg_dump -a claude-code в терминале.

Для чего нужен этот скилл?

Он помогает агенту правильно запрашивать метаданные системных каталогов PostgreSQL, ориентируясь на проверенную реализацию pg_dump.

Какие версии PostgreSQL поддерживаются?

Справочник ориентирован на PostgreSQL версий с 14 по 18; совместимость с более ранними выпусками не предусмотрена.

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

SKILL.md · Apache-2.0
---
name: pg_dump
description: Consult PostgreSQL's pg_dump implementation for guidance on system catalog queries and schema extraction when implementing pgschema features. Use this skill when adding new schema object support, debugging inspector.go queries, understanding how PostgreSQL represents objects internally, or handling version-specific features across PostgreSQL 14-18.
---

# pg_dump Reference

Reference pg_dump's implementation for correct system catalog queries and schema extraction patterns.

## Source

**Repository**: https://github.com/postgres/postgres/blob/master/src/bin/pg_dump/

**Key files**:
- `pg_dump.c` - Main implementation with all system catalog queries
- `pg_dump.h` - Data structures
- `pg_dump_sort.c` - Dependency sorting
- `common.c` - Shared catalog query utilities

## Object Type → pg_dump Function → System Catalogs

| Object | Function | Catalogs |
|--------|----------|----------|
| Tables & Columns | `getTables()` | `pg_class`, `pg_attribute`, `pg_type` |
| Constraints | `getConstraints()` | `pg_constraint` |
| Indexes | `getIndexes()` | `pg_index`, `pg_class` |
| Triggers | `getTriggers()` | `pg_trigger`, `pg_proc` |
| Functions | `getFuncs()` | `pg_proc` |
| Views | `getViews()` | `pg_class`, `pg_rewrite` |
| Sequences | `getSequences()` | `pg_sequence`, `pg_class` |
| Policies | `getPolicies()` | `pg_policy` |
| Types | `getTypes()` | `pg_type` |
| Aggregates | `getAggregates()` | `pg_aggregate`, `pg_proc` |
| Comments | `getComments()` | `pg_description` |

## Key Helper Functions

- `pg_get_expr(expr, relation, pretty)` - Deparse expressions (defaults, WHEN clauses, index predicates)
- `pg_get_constraintdef(oid, pretty)` - Get constraint DDL
- `pg_get_indexdef(oid, column, pretty)` - Get index DDL
- `pg_get_triggerdef(oid, pretty)` - Get full trigger DDL

**Important**: For trigger WHEN clauses, always use `pg_get_expr(t.tgqual, t.tgrelid, false)` from `pg_catalog.pg_trigger`. Do NOT use `information_schema.triggers.action_condition`.

## Workflow

1. **Identify the object type** you're implementing
2. **Find the pg_dump function** from the table above
3. **Read the system catalog query** — note which columns, joins, and helper functions are used
4. **Check version-specific handling** — pg_dump uses `fout->remoteVersion` checks
5. **Adapt for pgschema** in `ir/inspector.go` or `ir/queries/`:
   - Use pgx parameter binding
   - Handle NULLs appropriately
   - Add version detection if needed

## When pg_dump is Authoritative

Always reference for: system catalog query patterns, correct use of `pg_get_*` functions, version-specific feature detection, object dependency tracking.

## When NOT to Copy pg_dump

Don't copy: output formatting (pgschema has different conventions), archive/restore logic, full-database scope (pgschema is schema-focused), pre-PG14 compatibility.

## pgschema Adaptation Pattern

```go
// pg_dump query pattern:
// SELECT t.tgname, pg_get_expr(t.tgqual, t.tgrelid, false) as when_clause
// FROM pg_catalog.pg_trigger t WHERE ...

// pgschema adaptation (in ir/inspector.go or ir/queries/):
query := `SELECT t.tgname, pg_get_expr(t.tgqual, t.tgrelid, false)
FROM pg_catalog.pg_trigger t
WHERE t.tgrelid = $1 AND NOT t.tgisinternal`
rows, err := conn.Query(ctx, query, tableOID)
```

© pgplex · Apache-2.0 · pgplex/pgschema

Похожие скиллы

Все скиллы по теме «Данные и базы» →
golang-database samber Скилл golang-database для Claude Code задаёт правила работы с реляционными базами данных в Go через database/sql, sqlx и pgx, без ORM. Помогает писать запросы и проверять утечки соединений. CX Codex +1 43 300установок encore-go-database encoredev Скилл encore-go-database помогает создавать таблицы PostgreSQL, писать миграции и выполнять SQL-запросы в сервисах на Encore Go через пакет sqldb. CX Codex +1 609установок neon-postgres neondatabase Скилл neon-postgres для Claude Code помогает работать с базой Neon: подключениями, схемой и ветками. Агент подключает его при запросах к существующей базе, SQL или поиску. CX Codex +1 315 000установок postgres-patterns affaan-m Скилл postgres-patterns для Claude Code собирает практики PostgreSQL для проектирования схем и настройки запросов: индексы, типы данных, RLS и диагностика медленных запросов. CX Codex +1 7 200установок sql-pro https://github.com/Jeffallan Скилл sql-pro оптимизирует медленные SQL-запросы, проектирует схемы баз данных и устраняет проблемы производительности. Пригодится при разборе планов EXPLAIN и миграции диалектов. CX Codex +1 6 900установок postgres-best-practices neondatabase Скилл postgres-best-practices для Claude Code помогает писать SQL, проектировать схемы и разбирать запросы в PostgreSQL. Подключается при настройке базы, оптимизации запросов и работе с миграциями. CX Codex +1 2 100установок

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

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

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