Postgres Patterns

affaan-m/ECC/docs/ja-JP/skills/postgres-patterns

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

PostgreSQL database patterns for query optimization, schema design, indexing, and security. Based on Supabase best practices.

AI 生成的概览

PostgreSQL 参考模式,涵盖查询优化、架构设计、索引与安全。

功能
该技能是一份 PostgreSQL 最佳实践速查指南,涵盖索引选择、数据类型选择、常见查询模式、反模式检测查询以及配置模板。它提供复合索引与覆盖索引、部分索引、RLS 策略、UPSERT、游标分页和队列处理的 SQL 片段。它还列出用于查找缺失外键索引、慢查询和表膨胀的诊断查询。它产出的是指导与示例 SQL,本身不执行任何操作。
适用场景
适用于编写 SQL 查询或迁移、设计数据库架构、排查慢查询、实现行级安全或配置连接池时。它被用作数据库工作中的查阅参考。
运行要求
无需脚本或运行时依赖,仅为说明与 SQL 示例。应用这些示例需要 PostgreSQL 数据库,部分诊断查询依赖 pg_stat_statements 等扩展。

PostgreSQL パターン

PostgreSQLベストプラクティスのクイックリファレンス。詳細なガイダンスについては、database-reviewer エージェントを使用してください。

起動タイミング

  • SQLクエリまたはマイグレーションの作成時
  • データベーススキーマの設計時
  • 低速クエリのトラブルシューティング時
  • Row Level Securityの実装時
  • コネクションプーリングの設定時

クイックリファレンス

インデックスチートシート

クエリパターンインデックスタイプ例
WHERE col = valueB-tree(デフォルト)CREATE INDEX idx ON t (col)
WHERE col > valueB-treeCREATE INDEX idx ON t (col)
WHERE a = x AND b > y複合CREATE INDEX idx ON t (a, b)
WHERE jsonb @> '{}'GINCREATE INDEX idx ON t USING gin (col)
WHERE tsv @@ queryGINCREATE INDEX idx ON t USING gin (col)
時系列範囲BRINCREATE INDEX idx ON t USING brin (col)

データタイプクイックリファレンス

用途正しいタイプ避けるべき
IDbigintint、ランダムUUID
文字列textvarchar(255)
タイムスタンプtimestamptztimestamp
金額numeric(10,2)float
フラグbooleanvarchar、int

一般的なパターン

複合インデックスの順序:

sql
-- 等価列を最初に、次に範囲列CREATE INDEX idx ON orders (status, created_at);-- 次の場合に機能: WHERE status = 'pending' AND created_at > '2024-01-01'

カバリングインデックス:

sql
CREATE INDEX idx ON users (email) INCLUDE (name, created_at);-- SELECT email, name, created_at のテーブル検索を回避

部分インデックス:

sql
CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL;-- より小さなインデックス、アクティブユーザーのみを含む

RLSポリシー(最適化):

sql
CREATE POLICY policy ON orders  USING ((SELECT auth.uid()) = user_id);  -- SELECTでラップ!

UPSERT:

sql
INSERT INTO settings (user_id, key, value)VALUES (123, 'theme', 'dark')ON CONFLICT (user_id, key)DO UPDATE SET value = EXCLUDED.value;

カーソルページネーション:

sql
SELECT * FROM products WHERE id > $last_id ORDER BY id LIMIT 20;-- O(1) vs OFFSET は O(n)

キュー処理:

sql
UPDATE jobs SET status = 'processing'WHERE id = (  SELECT id FROM jobs WHERE status = 'pending'  ORDER BY created_at LIMIT 1  FOR UPDATE SKIP LOCKED) RETURNING *;

アンチパターン検出

sql
-- インデックスのない外部キーを検索SELECT conrelid::regclass, a.attnameFROM pg_constraint cJOIN pg_attribute a ON a.attrelid = c.conrelid AND a.attnum = ANY(c.conkey)WHERE c.contype = 'f'  AND NOT EXISTS (    SELECT 1 FROM pg_index i    WHERE i.indrelid = c.conrelid AND a.attnum = ANY(i.indkey)  );
-- 低速クエリを検索SELECT query, mean_exec_time, callsFROM pg_stat_statementsWHERE mean_exec_time > 100ORDER BY mean_exec_time DESC;
-- テーブル肥大化をチェックSELECT relname, n_dead_tup, last_vacuumFROM pg_stat_user_tablesWHERE n_dead_tup > 1000ORDER BY n_dead_tup DESC;

設定テンプレート

sql
-- 接続制限(RAMに応じて調整)ALTER SYSTEM SET max_connections = 100;ALTER SYSTEM SET work_mem = '8MB';
-- タイムアウトALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';ALTER SYSTEM SET statement_timeout = '30s';
-- モニタリングCREATE EXTENSION IF NOT EXISTS pg_stat_statements;
-- セキュリティデフォルトREVOKE ALL ON SCHEMA public FROM public;
SELECT pg_reload_conf();

関連

  • Agent: database-reviewer - 完全なデータベースレビューワークフロー
  • Skill: clickhouse-io - ClickHouse分析パターン
  • Skill: backend-patterns - APIとバックエンドパターン

[Supabase Agent Skills](Supabase Agent Skills (credit: Supabase team))(MITライセンス)に基づく

来源与署名

来源:affaan-m/ECC位于docs/ja-JP/skills/postgres-patterns提交ef648e0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架