Postgresql

Cursor-Regel für PostgreSQL: Schema, Indizes und Migrations-Konventionen für sauberen KI-generierten SQL-Code.

Original-Beschreibung der Autoren: PostgreSQL production rules. Safe migrations, parameterized queries, TIMESTAMPTZ, proper indexing strategy.

Die Regel

---
description: "PostgreSQL production rules. Safe migrations, parameterized queries, TIMESTAMPTZ, proper indexing strategy."
globs: **/*.sql, **/migrations/**/*.sql, **/schema.sql, **/seed.sql
alwaysApply: false
---
# PostgreSQL Rules

Expert PostgreSQL developer. Safe migrations, parameterized queries, proper indexing.

## Schema
- TIMESTAMPTZ for all timestamps (not TIMESTAMP without timezone)
- UUID for public IDs, BIGSERIAL for internal keys
- NOT NULL by default — nullable only when intentional
- FK with explicit ON DELETE behavior
- Check constraints for domain invariants

## Queries
- Parameterized always — never string interpolation
- SELECT explicit columns, never SELECT *
- LIMIT on all potentially large result sets
- EXPLAIN ANALYZE before shipping complex queries

## Indexes
- Index every FK column
- CREATE INDEX CONCURRENTLY for live tables (non-blocking)
- Partial indexes for frequently filtered subsets
- Remove unused indexes

## Migrations
- Versioned files: V001__create_table.sql
- Large column additions: multi-step with backfill
- Test rollback before deploying

## Transactions
- Explicit BEGIN/COMMIT for multi-statement changes
- statement_timeout to prevent runaway queries
- SELECT ... FOR UPDATE for row locking

## Forbidden
- No SELECT *
- No string-interpolated SQL
- No schema changes during peak traffic
- No plaintext passwords in DB
- No TRUNCATE in app code

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Diese Cursor-Regel bündelt PostgreSQL-Best-Practices für den KI-Editor: sauberes Schema-Design, sinnvolle Indizierung, Vermeidung von N+1-Queries und Migrations-Konventionen. Der Editor schlägt darauf basierend Code vor, der sich an diese Standards hält, statt generischen SQL-Code zu generieren. Sinnvoll für Teams, die mit Cursor an Backend-Code mit PostgreSQL arbeiten und konsistente Datenbankzugriffe ohne manuelles Nachkorrigieren wollen. Ersetzt keine DB-Review, reduziert aber offensichtliche Anti-Patterns im generierten Code.

Praxis-Tipp

Datei nach .cursor/rules/postgresql.mdc legen und Cursor bei DB-Migrationen oder Query-Code aktiv mitschreiben lassen, z. B. mit dem Prompt „Lege eine Migration für eine neue orders-Tabelle mit Index auf customer_id an“.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …