Menu

PostgreSQL CREATE TABLE: Syntax und Beispiele

CREATE TABLE legt die Spalten, Typen und Constraints einer Tabelle fest. Mit Identity-Schlüsseln, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS und LIKE.

Diese Seite enthält ausführbare Editoren. Bearbeiten, ausführen und Ausgabe sofort sehen.

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

ConstraintWirkung
PRIMARY KEYEindeutig und nicht null; einer pro Tabelle
NOT NULLDie Spalte muss einen Wert haben
DEFAULT exprWert, der genommen wird, wenn ein Insert die Spalte weglässt
UNIQUEKeine 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.

Illustration der Programmiersprachen bei Coddy

Lerne mit Coddy zu programmieren

Los geht's