Postgres Patterns

affaan-m/ECC/docs/zh-TW/skills/postgres-patterns

by affaan-mef648e01899ba3e8dc6371642deaaf64b4477775No license275K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 4 days ago

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

AI-generated overview

Reference guide for PostgreSQL query optimization, schema design, indexing, and security patterns.

What it does
This skill is a quick-reference document of PostgreSQL patterns covering index selection, data type choices, common query patterns, anti-pattern detection queries, and configuration templates. It includes SQL snippets for composite, covering, and partial indexes, Row Level Security policies, upserts, cursor pagination, and queue processing, plus diagnostic queries for unindexed foreign keys, slow queries, and table bloat. It produces guidance and example SQL rather than executing anything.
When to use it
Use it when writing SQL queries or migrations, designing a database schema, troubleshooting slow queries, implementing Row Level Security, or setting up connection pooling. It is meant as a fast lookup during PostgreSQL work, with a fuller review workflow delegated to a separate database-reviewer agent.
Requirements
No scripts or tooling are required; it is instructions and SQL examples only. Applying the configuration and diagnostic snippets assumes a PostgreSQL database, and the monitoring examples reference the pg_stat_statements extension.

PostgreSQL 模式

PostgreSQL 最佳實務快速參考。詳細指南請使用 database-reviewer agent。

何時啟用

  • 撰寫 SQL 查詢或 migrations
  • 設計資料庫 schema
  • 疑難排解慢查詢
  • 實作 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)

資料類型快速參考

使用情況正確類型避免
IDsbigintint、隨機 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 授權)

Source and attribution

Source:affaan-m/ECCindocs/zh-TW/skills/postgres-patternsat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal