Навыки postgres-best-practices
📦

postgres-best-practices

Безопасно

Оптимизация запросов и схем PostgreSQL

Страдаете от медленных запросов к базе данных и низкой производительности? Этот навык предоставляет проверенные временем правила оптимизации PostgreSQL от Supabase с конкретными примерами SQL и измеримыми улучшениями производительности.

Поддерживает: Claude Codex Code(CC)
📊 71 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «postgres-best-practices». This query takes 5 seconds on 100k rows: SELECT * FROM orders WHERE customer_id = 42 AND status = 'pending'

Ожидаемый результат:

Create a composite index: CREATE INDEX idx_orders_customer_status ON orders (customer_id, status). This changes the execution plan from sequential scan to index scan, reducing query time to under 10ms. The column order matters: place the equality filter (customer_id) before the status filter for optimal index usage.

Использование «postgres-best-practices». How do I prevent N+1 queries when fetching users with their profile data?

Ожидаемый результат:

Replace individual queries with a JOIN: SELECT u.*, p.bio, p.avatar_url FROM users u LEFT JOIN user_profiles p ON p.user_id = u.id. Add an index on user_profiles(user_id) for fast lookups. This reduces 101 queries (1 for users + 100 for profiles) to a single query.

Аудит безопасности

Безопасно
v1 • 2/24/2026

This skill contains educational documentation for PostgreSQL best practices from Supabase. All 711 static analysis findings are false positives: the 'external_commands' detections are SQL code blocks in markdown documentation (not shell commands), 'network' URLs are reference links to postgresql.org and supabase.com, 'scripts' findings are SQL WITH clauses (CTEs), and 'crypto' warnings are text pattern matches in documentation. No executable code or security risks present.

37
Просканировано файлов
3,490
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Бэкенд-разработчик оптимизирует медленные запросы

Определить недостающие индексы, исправить паттерны N+1 и применить методы оптимизации запросов для сокращения времени отклика от секунд до миллисекунд.

Архитектор баз данных проектирует новые схемы

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

DevOps-инженер настраивает продакшн-базы данных

Настраивать ограничения соединений, параметры vacuum и мониторинг для поддержания здоровья базы данных под нагрузкой.

Попробуйте эти промпты

Базовая оптимизация запросов 
Review this PostgreSQL query for performance issues and suggest improvements: [paste query]
Рекомендация по индексам 
Analyze this table schema and query workload. What indexes should I create for optimal performance? Schema: [paste schema], Queries: [paste queries]
Исправление N+1 запроса 
I'm fetching users and their orders with separate queries. Show me how to rewrite this as a single efficient JOIN with proper indexing.
Политика Row-Level Security 
Create a Row-Level Security policy for a multi-tenant SaaS where users can only access data belonging to their organization. Table structure: [paste schema]

Лучшие практики

  • Всегда добавляйте индексы на столбцы WHERE, JOIN и ORDER BY
  • Используйте EXPLAIN ANALYZE для проверки планов выполнения запросов перед развёртыванием
  • Реализуйте пул соединений для предотвращения исчерпания базы данных

Избегать

  • Запуск неиндексированных запросов на больших таблицах, вызывающий последовательное сканирование
  • Получение всех столбцов с помощью SELECT * вместо конкретных полей
  • Использование LIKE с ведущими подстановочными символами, что предотвращает использование индексов

Часто задаваемые вопросы

Как узнать, какие столбцы нуждаются в индексах?
Индексируйте столбцы, используемые в условиях WHERE, JOIN, ORDER BY и внешних ключах. Используйте pg_stat_user_tables для определения часто используемых столбцов без индексов.
Что такое N+1 и как это исправить?
N+1 происходит, когда вы получаете родительскую запись, а затем делаете N дополнительных запросов для дочерних записей. Исправьте это с помощью JOIN или пакетной загрузки с предложениями IN для получения всех дочерних записей за один запрос.
Когда следует использовать частичные индексы?
Используйте частичные индексы, когда запросы часто фильтруют по определённому условию (например, WHERE status='active'). Это создаёт меньшие, более быстрые индексы, охватывающие только релевантные строки.
Как работает Row-Level Security?
RLS применяет политики доступа на уровне базы данных. Включите с помощью ALTER TABLE ... ENABLE ROW LEVEL SECURITY, затем создайте политики, которые фильтруют строки на основе атрибутов пользователя, таких как organization_id.
Какой размер пула соединений следует использовать?
Начните с 10-20 подключений на экземпляр приложения. Отслеживайте pg_stat_activity и корректируйте на основе: (ядра CPU * 2) + effective_spindle_count для рабочих нагрузок, ограниченных CPU.
Почему мои запросы медленные после добавления индексов?
Возможные причины: неправильный порядок столбцов в композитных индексах, использование функций над индексированными столбцами, устаревшая статистика (запустите ANALYZE) или индексы на столбцах с низкой селективностью. Используйте EXPLAIN ANALYZE для диагностики.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/postgres-best-practices

Ссылка

main

Структура файлов

📁 rules/

📄 _contributing.md

📄 _sections.md

📄 _template.md

📄 advanced-full-text-search.md

📄 advanced-jsonb-indexing.md

📄 conn-idle-timeout.md

📄 conn-limits.md

📄 conn-pooling.md

📄 conn-prepared-statements.md

📄 data-batch-inserts.md

📄 data-n-plus-one.md

📄 data-pagination.md

📄 data-upsert.md

📄 lock-advisory.md

📄 lock-deadlock-prevention.md

📄 lock-short-transactions.md

📄 lock-skip-locked.md

📄 monitor-explain-analyze.md

📄 monitor-pg-stat-statements.md

📄 monitor-vacuum-analyze.md

📄 query-composite-indexes.md

📄 query-covering-indexes.md

📄 query-index-types.md

📄 query-missing-indexes.md

📄 query-partial-indexes.md

📄 schema-data-types.md

📄 schema-foreign-key-indexes.md

📄 schema-lowercase-identifiers.md

📄 schema-partitioning.md

📄 schema-primary-keys.md

📄 security-privileges.md

📄 security-rls-basics.md

📄 security-rls-performance.md

📄 AGENTS.md

📄 metadata.json

📄 README.md

📄 SKILL.md