Postgres Patterns

affaan-m/ECC/docs/tr/skills/postgres-patterns

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

Sorgu optimizasyonu, şema tasarımı, indeksleme ve güvenlik için PostgreSQL veritabanı kalıpları. Supabase en iyi uygulamalarına dayanır.

僅含說明Data & Analytics
AI 產生的概覽

PostgreSQL 參考模式,涵蓋查詢最佳化、結構設計、索引與安全性。

功能
這是一份 PostgreSQL 最佳實務速查指南,涵蓋索引選擇、資料型別選擇、常見查詢模式、反模式偵測查詢與設定範本。它提供複合索引、涵蓋索引、部分索引、RLS 原則、UPSERT、游標分頁與佇列處理的 SQL 片段。也列出用於找出未索引外鍵、慢查詢與資料表膨脹的診斷查詢,以及連線與逾時設定。
適用情境
適用於撰寫 SQL 查詢或遷移、設計資料庫結構、排查慢查詢、實作資料列層級安全性,或設定連線池時。
執行需求
不包含指令碼或工具,僅為說明與 SQL 片段。執行診斷查詢需要 PostgreSQL 資料庫,部分範例涉及 pg_stat_statements 與 Supabase 風格的驗證函式。

PostgreSQL Kalıpları

PostgreSQL en iyi uygulamaları için hızlı referans. Detaylı kılavuz için database-reviewer agent'ını kullanın.

Ne Zaman Aktifleştirmeli

  • SQL sorguları veya migration'lar yazarken
  • Veritabanı şemaları tasarlarken
  • Yavaş sorguları troubleshoot ederken
  • Row Level Security uygularken
  • Connection pooling kurarken

Hızlı Referans

İndeks Hile Sayfası

Sorgu Kalıbıİndeks TipiÖrnek
WHERE col = valueB-tree (varsayılan)CREATE INDEX idx ON t (col)
WHERE col > valueB-treeCREATE INDEX idx ON t (col)
WHERE a = x AND b > yCompositeCREATE 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)
Zaman serisi aralıklarıBRINCREATE INDEX idx ON t USING brin (col)

Veri Tipi Hızlı Referans

Kullanım SenaryosuDoğru TipKaçın
ID'lerbigintint, rastgele UUID
String'lertextvarchar(255)
Timestamp'lertimestamptztimestamp
Paranumeric(10,2)float
Flag'lerbooleanvarchar, int

Yaygın Kalıplar

Composite İndeks Sırası:

sql
-- Önce eşitlik sütunları, sonra aralık sütunlarıCREATE INDEX idx ON orders (status, created_at);-- Şunlar için çalışır: WHERE status = 'pending' AND created_at > '2024-01-01'

Covering İndeks:

sql
CREATE INDEX idx ON users (email) INCLUDE (name, created_at);-- SELECT email, name, created_at için tablo aramasını önler

Partial İndeks:

sql
CREATE INDEX idx ON users (email) WHERE deleted_at IS NULL;-- Daha küçük indeks, sadece aktif kullanıcıları içerir

RLS Policy (Optimize Edilmiş):

sql
CREATE POLICY policy ON orders  USING ((SELECT auth.uid()) = user_id);  -- SELECT'e sar!

UPSERT:

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

Cursor Sayfalama:

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

Kuyruk İşleme:

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 *;

Anti-Kalıp Tespiti

sql
-- İndekslenmemiş foreign key'leri bulSELECT 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)  );
-- Yavaş sorguları bulSELECT query, mean_exec_time, callsFROM pg_stat_statementsWHERE mean_exec_time > 100ORDER BY mean_exec_time DESC;
-- Tablo bloat'ını kontrol etSELECT relname, n_dead_tup, last_vacuumFROM pg_stat_user_tablesWHERE n_dead_tup > 1000ORDER BY n_dead_tup DESC;

Yapılandırma Şablonu

sql
-- Bağlantı limitleri (RAM için ayarla)ALTER SYSTEM SET max_connections = 100;ALTER SYSTEM SET work_mem = '8MB';
-- Timeout'larALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';ALTER SYSTEM SET statement_timeout = '30s';
-- İzlemeCREATE EXTENSION IF NOT EXISTS pg_stat_statements;
-- Güvenlik varsayılanlarıREVOKE ALL ON SCHEMA public FROM public;
SELECT pg_reload_conf();

İlgili

  • Agent: database-reviewer - Tam veritabanı inceleme iş akışı
  • Skill: clickhouse-io - ClickHouse analytics kalıpları
  • Skill: backend-patterns - API ve backend kalıpları

Supabase Agent Skills'e dayanır (kredi: Supabase ekibi) (MIT License)

來源與署名

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

授權條款: 無授權條款

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

檢舉或申請下架