$ ~/registry/skill/affaan-m-docs-tr-skills-postgres-patterns

SKILL

postgres-patterns

提供 PostgreSQL 查询优化、模式设计、索引与安全实践建议

星标

★ 209,790

来源

GitHub

更新于

2026-06-07

// 安全评估低风险

仅提示词，不执行代码
开源可审计
社区验证· 209.8k

正在进行安全审计…

凭证密钥
网络外发
代码执行
数据访问
来源供应链

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "postgres-patterns" 技能：
1. 下载 https://raw.githubusercontent.com/affaan-m/ECC/main/docs/tr/skills/postgres-patterns/SKILL.md
2. 保存为 ~/.claude/skills/postgres-patterns/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

优化慢查询

输入

请分析下面的 PostgreSQL 查询并给出优化建议，包括索引、执行计划解读和 SQL 改写方案：SELECT * FROM orders WHERE customer_id = 42 AND created_at > NOW() - INTERVAL '30 days' ORDER BY created_at DESC LIMIT 50;

预期产出

返回查询瓶颈分析、推荐索引及更高效的 SQL 写法。

设计业务表结构

输入

我要为一个订阅制 SaaS 设计 PostgreSQL 数据库，请给出 users、subscriptions、invoices 三张表的表结构建议，包括主键、外键、约束、索引和命名规范。

预期产出

输出结构清晰的建表方案，并附带可扩展性与规范化建议。

检查数据库安全配置

输入

请检查 PostgreSQL/Supabase 项目的安全最佳实践，重点说明角色权限、Row Level Security、敏感数据保护和常见误配置风险。

预期产出

给出安全检查清单、风险说明和具体加固建议。

// 文档

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 = value`	B-tree (varsayılan)	`CREATE INDEX idx ON t (col)`
`WHERE col > value`	B-tree	`CREATE INDEX idx ON t (col)`
`WHERE a = x AND b > y`	Composite	`CREATE INDEX idx ON t (a, b)`
`WHERE jsonb @> '{}'`	GIN	`CREATE INDEX idx ON t USING gin (col)`
`WHERE tsv @@ query`	GIN	`CREATE INDEX idx ON t USING gin (col)`
Zaman serisi aralıkları	BRIN	`CREATE INDEX idx ON t USING brin (col)`

Veri Tipi Hızlı Referans

Kullanım Senaryosu	Doğru Tip	Kaçın
ID'ler	`bigint`	`int`, rastgele UUID
String'ler	`text`	`varchar(255)`
Timestamp'ler	`timestamptz`	`timestamp`
Para	`numeric(10,2)`	`float`
Flag'ler	`boolean`	`varchar`, `int`

Yaygın Kalıplar

Composite İndeks Sırası:

-- Ö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:

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

Partial İndeks:

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ş):

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

UPSERT:

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

Cursor Sayfalama:

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

Kuyruk İşleme:

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

-- İndekslenmemiş foreign key'leri bul
SELECT conrelid::regclass, a.attname
FROM pg_constraint c
JOIN 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ı bul
SELECT query, mean_exec_time, calls
FROM pg_stat_statements
WHERE mean_exec_time > 100
ORDER BY mean_exec_time DESC;

-- Tablo bloat'ını kontrol et
SELECT relname, n_dead_tup, last_vacuum
FROM pg_stat_user_tables
WHERE n_dead_tup > 1000
ORDER BY n_dead_tup DESC;

Yapılandırma Şablonu

-- Bağlantı limitleri (RAM için ayarla)
ALTER SYSTEM SET max_connections = 100;
ALTER SYSTEM SET work_mem = '8MB';

-- Timeout'lar
ALTER SYSTEM SET idle_in_transaction_session_timeout = '30s';
ALTER SYSTEM SET statement_timeout = '30s';

-- İzleme
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

-- Güvenlik varsayılanları
REVOKE ALL ON SCHEMA public FROM public;

SELECT pg_reload_conf();