psql-Befehle
Meta-Befehle laufen in psql (dem Terminal-Client von PostgreSQL), nicht auf dem Server. Sie beginnen mit einem Backslash und brauchen kein Semikolon.
| Was es tut | Befehl |
|---|
| Datenbanken auflisten | \l |
| Mit einer anderen Datenbank verbinden | \c shop |
| Tabellen auflisten | \dt |
| Tabellen in allen Schemas auflisten | \dt *.* |
| Eine Tabelle beschreiben (Spalten, Indizes, Schlüssel) | \d users |
| Mit Speicher und Kommentaren beschreiben | \d+ users |
| Schemas auflisten | \dn |
| Views auflisten | \dv |
| Indizes auflisten | \di |
| Funktionen auflisten | \df |
| Rollen (Benutzer) auflisten | \du |
| Die aktuelle Verbindung anzeigen | \conninfo |
| SQL aus einer Datei ausführen | \i setup.sql |
| Zeitmessung für Abfragen umschalten | \timing |
| Erweiterte Ausgabe (eine Spalte pro Zeile) | \x |
| Die letzte Abfrage in deinem Editor bearbeiten | \e |
| Hilfe zur SQL-Syntax | \h CREATE TABLE |
| Alle Meta-Befehle auflisten | \? |
| psql beenden | \q |
Verbinden im Terminal
| Was es tut | Befehl |
|---|
| Als Benutzer mit einer Datenbank verbinden | psql -U postgres -d shop |
| Mit einem entfernten Host und Port verbinden | psql -h db.example.com -p 5432 -U app -d shop |
| Mit einer Verbindungs-URL verbinden | psql postgresql://app:secret@localhost:5432/shop |
| Eine Abfrage ausführen und beenden | psql -d shop -c "SELECT count(*) FROM users;" |
| Eine SQL-Datei ausführen | psql -d shop -f setup.sql |
| Eine Datenbank in der Shell erstellen | createdb shop |
| Eine Datenbank in der Shell löschen | dropdb shop |
Datenbanken und Schemas
| Was es tut | SQL |
|---|
| Eine Datenbank erstellen | CREATE DATABASE shop; |
| Eine Datenbank löschen | DROP DATABASE shop; |
| Die aktuelle Datenbank anzeigen | SELECT current_database(); |
| Ein Schema erstellen | CREATE SCHEMA sales; |
| Die Suchreihenfolge der Schemas anzeigen | SHOW search_path; |
| Zuerst in einem Schema suchen | SET search_path TO sales, public; |
| Die Serverversion anzeigen | SELECT version(); |
Tabellen und Datentypen
| Was es tut | SQL |
|---|
| Eine Tabelle mit Identity-Schlüssel erstellen | CREATE TABLE products (id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY, name text NOT NULL, price numeric(10,2) CHECK (price >= 0), created_at timestamptz DEFAULT now()); |
| Eine Spalte hinzufügen | ALTER TABLE users ADD COLUMN phone text; |
| Eine Spalte umbenennen | ALTER TABLE users RENAME COLUMN country TO country_code; |
| Den Typ einer Spalte ändern | ALTER TABLE users ALTER COLUMN age TYPE smallint; |
| Einen Standardwert setzen | ALTER TABLE users ALTER COLUMN active SET DEFAULT false; |
| Eine Spalte löschen | ALTER TABLE users DROP COLUMN tags; |
| Eine Tabelle leeren und ihre Identity zurücksetzen | TRUNCATE orders, users RESTART IDENTITY; |
| Eine Tabelle löschen, falls vorhanden | DROP TABLE IF EXISTS products; |
| Exakte Dezimalzahl für Geldbeträge | numeric(10,2) |
| Datum und Uhrzeit mit Zeitzone | timestamptz |
| Zufällige UUID | SELECT gen_random_uuid(); |
| Enum-Typ | CREATE TYPE mood AS ENUM ('happy', 'sad'); |
Constraints und Schlüssel
| Was es tut | SQL |
|---|
| Einen Primärschlüssel hinzufügen | ALTER TABLE logs ADD PRIMARY KEY (id); |
| Fremdschlüssel, der Kindzeilen mitlöscht | CREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE); |
| Einen CHECK-Constraint hinzufügen | ALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0); |
| Unique, bei dem NULLs als gleich gelten (15+) | CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT); |
| Eine Spalte zur Pflicht machen | ALTER TABLE users ALTER COLUMN country SET NOT NULL; |
| Einen Constraint löschen | ALTER TABLE users DROP CONSTRAINT users_email_key; |
Standard-SELECT, WHERE und JOIN stehen im SQL-Spickzettel; hier sind die PostgreSQL-Varianten.
| Was es tut | SQL |
|---|
| Vergleich ohne Beachtung der Groß-/Kleinschreibung | SELECT * FROM users WHERE name ILIKE 'a%'; |
| Vergleich mit regulärem Ausdruck | SELECT * FROM users WHERE email ~ '@example\.com$'; |
| Erste Zeile pro Gruppe | SELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC; |
| Limit und Offset | SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20; |
| Zeilenlimit nach SQL-Standard | SELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY; |
| Umwandlung mit :: | SELECT '42'::integer + 1; |
| Ersatzwert für NULL | SELECT name, COALESCE(email, 'none') FROM users; |
| Vergleichen, wobei NULLs als gleich gelten | SELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com'; |
| Eine Zahlenreihe erzeugen | SELECT * FROM generate_series(1, 5); |
| Zu einem String aggregieren | SELECT string_agg(name, ', ' ORDER BY name) FROM users; |
| Bedingte Aggregation | SELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders; |
Einfügen, Aktualisieren, Löschen und Upsert
| Was es tut | SQL |
|---|
| Einfügen und die neue id zurückbekommen | INSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id; |
| Mehrere Zeilen einfügen | INSERT INTO users (name) VALUES ('Eli'), ('Femi'); |
| Upsert (einfügen oder aktualisieren) | INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; |
| Einfügen, Duplikate ignorieren | INSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING; |
| Aktualisieren und die geänderten Zeilen sehen | UPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary; |
| Aus einer anderen Tabelle aktualisieren | UPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN'; |
| Löschen und sehen, was gelöscht wurde | DELETE FROM orders WHERE status = 'refunded' RETURNING id; |
| Mithilfe einer anderen Tabelle löschen | DELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false; |
| Zeilen in eine neue Tabelle kopieren | CREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid'; |
JSONB
| Was es tut | SQL |
|---|
| Ein Feld als JSON lesen | SELECT profile -> 'plan' FROM users; |
| Ein Feld als Text lesen | SELECT profile ->> 'plan' FROM users; |
| Ein verschachteltes Feld als Text lesen | SELECT profile #>> '{address,city}' FROM users; |
| Zeilen, deren JSON einen Wert enthält | SELECT * FROM users WHERE profile @> '{"plan": "pro"}'; |
| Zeilen mit einem bestimmten Schlüssel | SELECT * FROM users WHERE profile ? 'city'; |
| Einen Schlüssel setzen | UPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2; |
| Objekte zusammenführen | UPDATE users SET profile = profile || '{"beta": true}'; |
| Einen Schlüssel entfernen | UPDATE users SET profile = profile - 'city'; |
| JSON aus Spalten bauen | SELECT jsonb_build_object('id', id, 'name', name) FROM users; |
| Zeilen als JSON-Array | SELECT jsonb_agg(users) FROM users; |
| Index für Abfragen mit @> und ? | CREATE INDEX users_profile_idx ON users USING gin (profile); |
Arrays
| Was es tut | SQL |
|---|
| Array-Literal | SELECT ARRAY[1, 2, 3]; |
| Zeilen, deren Array einen Wert enthält | SELECT * FROM users WHERE 'sql' = ANY(tags); |
| Zeilen, deren Array alle diese Werte enthält | SELECT * FROM users WHERE tags @> ARRAY['sql', 'python']; |
| Eine Zeile pro Element | SELECT name, unnest(tags) FROM users; |
| Ein Element anhängen | UPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2; |
| Array-Länge | SELECT name, cardinality(tags) FROM users; |
Datum und Uhrzeit
| Was es tut | SQL |
|---|
| Jetzt, mit Zeitzone | SELECT now(); |
| Heute | SELECT current_date; |
| Ein Intervall addieren | SELECT current_date + INTERVAL '7 days'; |
| Zeilen der letzten 30 Tage | SELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days'; |
| Auf den Monat abschneiden | SELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1; |
| Einen Teil extrahieren | SELECT EXTRACT(YEAR FROM hired_on) FROM employees; |
| Differenz zwischen Daten (Tage) | SELECT DATE '2026-12-25' - DATE '2026-11-17'; |
| Alter zwischen zwei Daten | SELECT name, age(current_date, hired_on) FROM employees; |
| Ein Datum als Text formatieren | SELECT to_char(hired_on, 'DD Mon YYYY') FROM employees; |
| Text in ein Datum umwandeln | SELECT to_date('17/11/2026', 'DD/MM/YYYY'); |
| In eine Zeitzone umrechnen | SELECT now() AT TIME ZONE 'Asia/Kolkata'; |
Textfunktionen
| Was es tut | SQL |
|---|
| Verketten (NULL ergibt NULL) | SELECT name || ' <' || email || '>' FROM users; |
| Verketten und NULLs überspringen | SELECT concat_ws(' ', name, email) FROM users; |
| Groß- und Kleinbuchstaben | SELECT upper(name), lower(name) FROM users; |
| Länge | SELECT name, length(name) FROM users; |
| Teil eines Strings | SELECT substring(name FROM 1 FOR 2) FROM users; |
| Ersetzen | SELECT replace(email, '@example.com', '') FROM users; |
| Aufteilen und einen Teil nehmen | SELECT split_part(email, '@', 2) FROM users; |
| Ersetzen mit regulärem Ausdruck | SELECT regexp_replace('a1b22c', '[0-9]+', '', 'g'); |
| Leerzeichen entfernen | SELECT trim(' hi '); |
CTEs und Window-Funktionen
| Was es tut | SQL |
|---|
| Eine Unterabfrage mit WITH benennen | WITH paid AS (SELECT user_id, sum(amount) AS total FROM orders WHERE status = 'paid' GROUP BY user_id) SELECT * FROM paid WHERE total > 50; |
| Rekursive CTE (bis 5 zählen) | WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n; |
| Zeilen pro Gruppe nummerieren | SELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees; |
| Rang mit Gleichständen | SELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees; |
| Laufende Summe | SELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders; |
| Wert der vorherigen Zeile | SELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees; |
| Jede Zeile mit ihrer eigenen Unterabfrage joinen | SELECT u.name, o.amount FROM users u CROSS JOIN LATERAL (SELECT amount FROM orders WHERE user_id = u.id ORDER BY amount DESC LIMIT 1) o; |
Indizes
| Was es tut | SQL |
|---|
| B-Tree-Index (der Standard) | CREATE INDEX orders_user_idx ON orders (user_id); |
| Unique-Index | CREATE UNIQUE INDEX employees_name_idx ON employees (name); |
| Mehrspaltiger Index | CREATE INDEX orders_user_created_idx ON orders (user_id, created_at); |
| Partieller Index | CREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid'; |
| Ausdrucksindex | CREATE INDEX users_lower_email_idx ON users (lower(email)); |
| Covering Index (Index-Only-Scans) | CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount); |
| Erstellen, ohne Schreibzugriffe zu blockieren | CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status); |
| Einen Index löschen | DROP INDEX IF EXISTS orders_user_idx; |
| Den Plan ansehen | EXPLAIN SELECT * FROM orders WHERE user_id = 1; |
| Den Plan mit echten Laufzeiten ansehen | EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1; |
Transaktionen und Sperren
| Was es tut | SQL |
|---|
| Starten, dann behalten oder rückgängig machen | BEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK; |
| Einen Teil einer Transaktion rückgängig machen | BEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT; |
| Strengere Isolation | BEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT; |
| Die gelesenen Zeilen sperren | BEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT; |
| Job-Queue: gesperrte Zeilen überspringen | BEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT; |
Benutzer, Rollen und Rechte
| Was es tut | SQL |
|---|
| Eine Login-Rolle erstellen | CREATE ROLE app LOGIN PASSWORD 'change-me'; |
| Nur-Lese-Zugriff auf eine Tabelle | GRANT SELECT ON users TO app; |
| Lesezugriff auf alle Tabellen eines Schemas | GRANT SELECT ON ALL TABLES IN SCHEMA public TO app; |
| Ein Recht wieder entziehen | REVOKE SELECT ON users FROM app; |
| Ein Passwort ändern | ALTER ROLE app PASSWORD 'new-secret'; |
| Den aktuellen Benutzer anzeigen | SELECT current_user; |
Wartung und Monitoring
| Was es tut | SQL |
|---|
| Laufende Abfragen | SELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle'; |
| Eine Abfrage abbrechen | SELECT pg_cancel_backend(12345); |
| Eine Verbindung beenden | SELECT pg_terminate_backend(12345); |
| Größe einer Tabelle samt Indizes | SELECT pg_size_pretty(pg_total_relation_size('orders')); |
| Größe der Datenbank | SELECT pg_size_pretty(pg_database_size(current_database())); |
| Planer-Statistiken aktualisieren | ANALYZE orders; |
| Tote Zeilen freigeben | VACUUM orders; |
| Eine Tabelle auf minimale Größe neu schreiben (sperrt sie) | VACUUM FULL orders; |
| Eine Einstellung anzeigen | SHOW work_mem; |
| Eine Einstellung für diese Sitzung ändern | SET work_mem = '64MB'; |
Backup und Wiederherstellung
Shell-Befehle aus den PostgreSQL-Client-Tools.
| Was es tut | Befehl |
|---|
| Eine Datenbank in eine SQL-Datei dumpen | pg_dump -U postgres shop > shop.sql |
| Im Custom-Format dumpen | pg_dump -Fc -U postgres shop > shop.dump |
| Eine einzelne Tabelle dumpen | pg_dump -t orders shop > orders.sql |
| Einen SQL-Dump wiederherstellen | psql -d shop -f shop.sql |
| Einen Dump im Custom-Format wiederherstellen | pg_restore -d shop shop.dump |
| Alle Datenbanken und Rollen dumpen | pg_dumpall > cluster.sql |
| Eine Abfrage als CSV exportieren (aus psql) | \copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER |
| Eine CSV importieren (aus psql) | \copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER |
Jeder psql-Befehl und jede PostgreSQL-Anweisung, die du brauchst, in Tabellen zum Kopieren: zuerst das Verbinden und die \d-Befehle, dann Tabellen, Upserts, JSONB, Datum und Uhrzeit, Window-Funktionen, Indizes, Rollen, Backups und Wartung.
Das SQL hier ist PostgreSQL-17-Syntax, und das meiste davon funktioniert auch in älteren Versionen. Die SQL-Anweisungen wurden auf PostgreSQL 17 geprüft; um eine auszuprobieren, füge sie in den PostgreSQL-Playground ein, der Beispieltabellen mitbringt.