CREATE TABLE name (column type constraints, ...) legt eine Tabelle an. Jede Spalte bekommt einen Namen und einen Datentyp, danach optionale Constraints wie PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE oder CHECK.
Die Spalte id nummeriert sich selbst, plan fällt auf 'free' zurück, wenn der Insert sie weglässt, und created_at hält den Zeitpunkt des Inserts fest. Die Seite zu den Datentypen listet die gängigen Spaltentypen auf.
Constraints für Spalten
| Constraint | Wirkung |
|---|---|
PRIMARY KEY | Eindeutig und nicht null; einer pro Tabelle |
NOT NULL | Die Spalte muss einen Wert haben |
DEFAULT expr | Wert, der genommen wird, wenn ein Insert die Spalte weglässt |
UNIQUE | Keine zwei Zeilen teilen sich einen Wert (mehrere NULL sind erlaubt) |
CHECK (expr) | Lehnt Zeilen ab, bei denen der Ausdruck falsch ist |
REFERENCES t (col) | Foreign Key auf eine andere Tabelle |
Seit PostgreSQL 15 behandelt UNIQUE NULLS NOT DISTINCT NULL Werte als gleich, sodass nur eine Zeile in dieser Spalte NULL haben darf.
Regeln über mehrere Spalten
Ein Constraint über mehr als eine Spalte steht in einer eigenen Zeile nach den Spalten. Gibst du ihm mit CONSTRAINT name einen Namen, werden Fehlermeldungen lesbar, und du kannst ihn später über den Namen löschen.
Die Abfrage listet die drei Constraints auf. Die unbenannten haben generierte Namen bekommen, bookings_guests_check und bookings_pkey.
Tabelle nur anlegen, wenn sie noch nicht existiert
IF NOT EXISTS macht aus dem zweiten CREATE TABLE einen Hinweis statt eines Fehlers. Es prüft nur den Namen. Gibt es schon eine Tabelle logs mit anderen Spalten, ändert sich nichts.
Tabelle aus einer Abfrage oder einer anderen Tabelle anlegen
CREATE TABLE ... AS legt eine Tabelle aus dem Ergebnis eines SELECT an, mit dessen Spalten und Typen. LIKE kopiert die Definition einer anderen Tabelle ohne ihre Zeilen, und INCLUDING ALL übernimmt Defaults, Constraints, Identity und Indizes.
big_orders hat eine Zeile. orders_archive hat die Spalten und Constraints von orders und keine Zeilen.
Generierte Spalten
Eine generierte Spalte wird aus anderen Spalten derselben Zeile berechnet, und Inserts können sie nicht schreiben. In PostgreSQL 17 muss sie STORED sein: Der Wert wird beim Schreiben berechnet und auf der Platte gespeichert.
Die Summen sind 13.5 und 20.
Temporäre und unlogged Tabellen
CREATE TEMP TABLE legt eine Tabelle an, die nur die aktuelle Sitzung sieht und die am Ende der Sitzung gelöscht wird. Das passt für Zwischenergebnisse in einem langen Skript. CREATE UNLOGGED TABLE umgeht das Write-Ahead-Log, Schreibvorgänge sind also schneller. Die Tabelle wird nach einem Absturz geleert und nicht auf Replikate kopiert. Nimm sie also nur für Daten, die du neu aufbauen kannst.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Um eine Tabelle nachträglich zu ändern, nimmst du ALTER TABLE. Alle Optionen stehen in der Referenz zu CREATE TABLE.
Häufig gestellte Fragen
Unterscheidet PostgreSQL bei Tabellennamen Groß- und Kleinschreibung?
Namen ohne Anführungszeichen werden kleingeschrieben, CREATE TABLE Users legt also users an. Ein Name in Anführungszeichen wie "Users" behält seine Schreibweise und muss dann in jeder Abfrage in Anführungszeichen stehen. Deshalb sind kleingeschriebene snake_case Namen üblich.
Wie sehe ich die Struktur einer Tabelle in PostgreSQL?
In psql zeigt \d table_name die Spalten, Typen, Defaults, Indizes und Constraints. Per SQL fragst du information_schema.columns WHERE table_name = 'table_name' ab.
Wie kopiere ich eine Tabelle in PostgreSQL?
CREATE TABLE copy AS TABLE original; kopiert Spalten und Zeilen, aber keine Constraints und Indizes. CREATE TABLE copy (LIKE original INCLUDING ALL); kopiert die Struktur mit Defaults, Constraints und Indizes, aber ohne Zeilen.
Wie lösche ich eine Tabelle in PostgreSQL?
DROP TABLE table_name; entfernt die Tabelle samt Daten. DROP TABLE IF EXISTS table_name; überspringt den Fehler, wenn sie nicht existiert, und CASCADE löscht auch Views und Foreign Keys, die von ihr abhängen.