Menu

PostgreSQL Primärschlüssel: Identity, SERIAL und UUID

Wie du in PostgreSQL einen Primärschlüssel definierst und wie du ihn erzeugst: Identity-Spalten, das ältere SERIAL und UUIDs mit gen_random_uuid(). Dazu zusammengesetzte Schlüssel und das Zurücksetzen einer Sequenz.

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

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 IDENTITY lehnt einen expliziten Wert im INSERT ab, außer der Insert sagt OVERRIDING SYSTEM VALUE. Das ist der sicherere Standard.
  • GENERATED BY DEFAULT AS IDENTITY nimmt 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.

Illustration der Programmiersprachen bei Coddy

Lerne mit Coddy zu programmieren

Los geht's