postgres-pro - Запросы и обслуживание PostgreSQL

Когда звать

• Когда запрос PostgreSQL замедлился и нужно разобрать план, статистику и выбор индекса.
• Когда требуется проверить JSONB, отставание реплики или обслуживание часто меняющихся таблиц.

Чем PostgreSQL Pro отличается от общего SQL-скилла

PostgreSQL Pro сосредоточен на возможностях PostgreSQL: планах выполнения, типах индексов, JSONB, репликации и обслуживании таблиц. В прочитанном файле указана версия 1.1.0. В справочном перечне автора названы PostgreSQL 12-16; это граница описания, а не проверка совместимости со всеми новыми версиями.

Один сценарий применения - запрос, который стал медленным после роста таблицы. Другой - приложение с JSONB, где нужно понять соответствие оператора и индекса. Скилл требует начинать с наблюдаемой нагрузки, поэтому добавление индекса без разбора запросов прямо запрещено.

Что нужно измерить

Основной порядок работы начинается с EXPLAIN (ANALYZE, BUFFERS). Затем автор предлагает выбрать B-tree, GIN, GiST или BRIN под характер запроса, переписать неудачный SQL и обновить статистику при необходимости. После каждой правки нужно подтвердить изменение плана и поведения.

В примере медленные запросы ищутся через pg_stat_statements. Для отдельного запроса показан частичный индекс и повторный просмотр плана. Смысл этой последовательности - сравнить конкретный запрос до и после, а не считать любое появление Index Scan доказательством общего ускорения базы.

Вызовы с ANALYZE не следует воспринимать как просмотр текста без выполнения: они запускают запрос. Поэтому первую задачу лучше ограничить тестовой базой или заранее согласованным чтением. Сам скилл не выдаёт доступ к рабочим данным.

JSONB, обслуживание и реплики

Пример JSONB связывает GIN-индекс с запросом containment через @>. Ещё один фрагмент показывает извлечение вложенных полей. В справочниках отдельно выделены JSONB, производительность, расширения, репликация и обслуживание.

Для таблиц с частыми изменениями автор предлагает смотреть мёртвые строки и работу autovacuum через pg_stat_user_tables. Глобальное отключение autovacuum запрещено. После массовых изменений требуется обновить статистику; запуск обслуживания должен учитывать размер таблицы и режим работы системы.

Для репликации инструкция различает потоковый и логический варианты и требует наблюдать отставание. В примере используются позиции WAL из pg_stat_replication. Настроенная реплика без контроля задержки не считается завершённым решением по правилам этого скилла.

Что получить от агента

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

Автор также требует пул соединений, подготовленные выражения и настоящий тип uuid для UUID. Запрет SELECT * в рабочих запросах записан отдельно, хотя он встречается в учебном примере файла. Такой пример лучше обсуждать по назначению, не копируя его механически.

Мы проверили SKILL.md и MIT-лицензию; подключение и запросы к базе не выполнялись. Установка в Codex не испытана. Для общего разбора SQL есть SQL Pro, для широкого анализа базы - Database Optimizer.