Postgres Patterns

affaan-m/ECC/docs/zh-TW/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 模式速查文件,涵蓋索引選擇、資料型別選擇、常見查詢模式、反模式偵測查詢與設定範本。它提供複合索引、覆蓋索引、部分索引、資料列層級安全政策、UPSERT、游標分頁與佇列處理的 SQL 片段,以及未建索引外鍵、慢查詢與資料表膨脹的診斷查詢。它產出的是指引與範例 SQL,而非實際執行操作。
適用情境
適用於撰寫 SQL 查詢或遷移、設計資料庫結構、排查慢查詢、實作資料列層級安全或設定連線池的情境。它用於 PostgreSQL 工作中的快速查閱,較完整的審查流程交由獨立的 database-reviewer 代理處理。
執行需求
不需要指令碼或工具,僅為說明與 SQL 範例。套用設定與診斷片段需要 PostgreSQL 資料庫,監控範例涉及 pg_stat_statements 擴充功能。

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 授權)

來源與署名

來源:affaan-m/ECC位於docs/zh-TW/skills/postgres-patterns提交ef648e0

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架