Ein Primärschlüssel ist die Spalte oder die Gruppe von Spalten, die jede Zeile identifiziert. Seine Werte müssen eindeutig und nicht NULL sein, und eine Tabelle kann nur einen haben. In PostgreSQL lässt du ihn meist von der Datenbank über eine Identity-Spalte erzeugen: id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY.
Die IDs sind 1 und 2. Die Definition des Schlüssels legt außerdem einen eindeutigen Index darauf an, mit dem Namen users_pkey.
Identity-Spalten: ALWAYS vs BY DEFAULT
Identity-Spalten sind der Weg des SQL-Standards, Zeilen zu nummerieren, verfügbar seit PostgreSQL 10. Es gibt zwei Formen:
GENERATED ALWAYS AS IDENTITYlehnt einen expliziten Wert imINSERTab, außer der Insert sagtOVERRIDING SYSTEM VALUE. Das ist der sicherere Standard.GENERATED BY DEFAULT AS IDENTITYnimmt den generierten Wert nur, wenn du keinen angibst.
Fügst du mit BY DEFAULT eigene IDs ein, bleibt die Sequenz zurück, und die nächste generierte ID kollidiert. Nach einem Import von Zeilen mit expliziten IDs schiebst du die Sequenz mit setval über die höchste ID hinaus:
Ohne die Zeile mit setval bekäme der letzte Insert die ID 1 und würde mit einem Fehler wegen doppeltem Schlüssel scheitern. Mit ihr bekommt die neue Zeile 4.
SERIAL vs Identity
serial (4 Bytes) und bigserial (8 Bytes) sind keine echten Typen. Sie sind eine Kurzform, die eine Sequenz anlegt und den Default der Spalte auf deren nextval() setzt:
Die Spalte ist ein einfaches integer mit dem Default nextval('legacy_id_seq'::regclass). Nichts hindert einen Insert daran, eine eigene ID zu schreiben, und die Sequenz braucht eigene Rechte. Identity-Spalten lösen beides, nimm sie also in neuen Tabellen. serial funktioniert weiterhin, und du triffst es in älteren Schemas und Tutorials.
Nimm bigint (oder bigserial) für Tabellen, die wachsen können. Ein integer Schlüssel geht nach etwa 2,1 Milliarden Werten aus.
UUID als Primärschlüssel
gen_random_uuid() liefert eine zufällige UUID der Version 4. Sie ist seit PostgreSQL 13 eingebaut, eine Erweiterung ist also nicht nötig:
Jeder Lauf gibt andere IDs aus, jede in Textform 36 Zeichen lang. Der Typ uuid speichert sie in 16 Bytes, nimm ihn also statt text. PostgreSQL 18 bringt uuidv7(), das zeitlich geordnete UUIDs erzeugt, die in Indexreihenfolge eingefügt werden. Unter PostgreSQL 17 erzeugst du diese in deiner Anwendung.
Zusammengesetzte Primärschlüssel
Ein Schlüssel kann mehrere Spalten umfassen und steht dann in CREATE TABLE in einer eigenen Zeile. Das ist der natürliche Schlüssel für eine Verknüpfungstabelle, in der jedes Paar nur einmal vorkommen darf:
Das wiederholte Paar (1, 10) wird übersprungen, die Anzahl ist also 3. Um einer bestehenden Tabelle einen Schlüssel zu geben, nimmst du ALTER TABLE t ADD PRIMARY KEY (col). Die Seite zu ALTER TABLE behandelt die anderen Änderungen. Andere Tabellen verweisen über Foreign Keys auf den Schlüssel.
Häufig gestellte Fragen
Hat PostgreSQL AUTO_INCREMENT?
Nicht unter diesem Namen. Der Standardweg ist eine Identity-Spalte, id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY, verfügbar seit PostgreSQL 10. Die älteren Typen serial und bigserial machen dasselbe mit einer Sequenz und einem Default.
Warum hat meine ID-Sequenz in PostgreSQL Lücken?
Eine Sequenz vergibt einen Wert auch dann, wenn der Insert danach scheitert oder seine Transaktion zurückgerollt wird, und dieser Wert wird nie wiederverwendet. Lücken sind normal und harmlos, verlass dich also nicht darauf, dass IDs lückenlos sind.
Legt ein Primärschlüssel in PostgreSQL einen Index an?
Ja. Ein Primärschlüssel (und jeder UNIQUE Constraint) legt automatisch einen eindeutigen B-Tree-Index an, für den Primärschlüssel mit dem Namen tablename_pkey.
Soll ich für einen Primärschlüssel UUID oder bigint nehmen?
bigint Identity-Schlüssel sind kleiner (8 Bytes gegenüber 16) und werden in Indexreihenfolge eingefügt. UUIDs lassen sich überall ohne Umweg über die Datenbank erzeugen und verraten nicht, wie viele Zeilen es gibt. Zufällige UUIDs verteilen Inserts über den ganzen Index, was bei großen Tabellen mehr kostet.