Die wichtigsten Neuerungen in PostgreSQL 19 für API-Entwickler: INSERT ... ON CONFLICT DO SELECT für Get-or-Create-Endpunkte mit einer einzigen Anweisung, WAIT FOR LSN für Read-your-writes auf Replikas, REPACK (CONCURRENTLY) für Online-Bloat-Bereinigung, JSON-Ausgabe von COPY, neue jsonpath-String-Methoden und schnellere Fremdschlüssel-Prüfungen bei Bulk-Inserts.
Dieser Leitfaden behandelt, was sich an Ihren Handlern, Replikas und Ihrem Upgrade-Plan ändert. Jedes Syntaxbeispiel stammt aus den Release-Notes zu PostgreSQL 19 und den zugehörigen Referenzseiten.
PostgreSQL 19: Die wichtigsten Neuerungen auf einen Blick
PostgreSQL 19 ist das jährliche Major-Release der Open-Source-Datenbank, angekündigt von der PostgreSQL Global Development Group am 19. November 2026. Es bringt Get-or-Create-Inserts, Replika-Waits für Read-your-writes, Online-Table-Repacking, Plan-Advice und logische Replikation von Sequenzen mit – und ändert mehrere Standardeinstellungen, die Sie vor dem Upgrade prüfen sollten.
| Feature | Was es ersetzt | Wo Sie es merken |
|---|---|---|
ON CONFLICT DO SELECT |
SELECT-then-INSERT mit Retry-Schleifen | Idempotente POST- und Signup-Endpunkte |
WAIT FOR LSN |
Sticky Routing von Lesezugriffen zum Primary | Read-Replikas hinter einer API |
REPACK (CONCURRENTLY) |
VACUUM FULL, CLUSTER, pg_repack |
Geblähte Hot Tables, ohne Downtime |
COPY ... (FORMAT json) |
Row-to-JSON-Konvertierung im Anwendungscode | Export- und Bulk-Download-Endpunkte |
jsonpath-String-Methoden |
Nachbearbeitung von JSONB im Anwendungscode | Filtern und Normalisieren von JSON-Spalten |
pg_plan_advice + pg_stash_advice |
Umschreiben von Queries, um den Planner zu steuern | Plan-Regressionen in der Produktion |
FOR ALL SEQUENCES-Publications |
Manuelles Zurücksetzen von Sequenzen nach dem Cutover | Blue-Green-Upgrades per logischer Replikation |
Die offizielle Release-Ankündigung nennt außerdem paralleles Index-Vacuuming und automatisch skalierende Async-I/O-Worker. Diese ändern nichts am SQL, das Ihre API sendet, daher werden sie in diesem Beitrag nicht behandelt.
ON CONFLICT DO SELECT: Get-or-Create in einer einzigen Anweisung
Jede API hat einen Endpunkt, der eine Zeile zurückgeben muss, egal ob sie existiert oder nicht: ein Gerät registrieren, einen Tag anlegen, einen idempotenten Checkout starten. Vor Version 19 führten Sie erst ein SELECT und dann ein INSERT aus (und verloren Races unter Last), oder Sie schrieben ein Dummy-ON CONFLICT DO UPDATE, nur damit RETURNING feuert – was umsonst eine neue Zeilenversion schreibt.
PostgreSQL 19 führt eine vierte Conflict-Action ein. Die INSERT-Referenz nennt sie ein „idempotent insert or get or create“:
INSERT INTO distributors (did, dname) VALUES (11, 'Global Electronics')
ON CONFLICT (did) DO SELECT
RETURNING *;
Ist did = 11 frei, wird die Zeile eingefügt und zurückgegeben. Ist sie belegt, kommt die vorhandene Zeile zurück und nichts wird geändert. Drei Regeln aus der Doku:
- Eine
RETURNING-Klausel ist beiDO SELECTerforderlich. - Ein
conflict_targetist erforderlich, genau wie beiDO UPDATE. - Exclusion Constraints können nicht als Arbiter dienen; verwenden Sie einen Unique Index oder ein
NOT DEFERRABLE-Unique-Constraint.

Ihr Handler muss meist wissen, welcher Zweig ausgeführt wurde, um 201 Created oder 200 OK antworten zu können. Die Doku weist darauf hin, dass die RETURNING-Werte der alten Zeile nicht NULL sind, wenn es zum Konflikt kam – eine Spalte verrät es Ihnen also:
INSERT INTO users (email, name) VALUES ($1, $2)
ON CONFLICT (email) DO SELECT
RETURNING *, (old.id IS NULL) AS created;
Müssen Sie die vorhandene Zeile sperren, bevor Sie verwandte Tabellen anfassen? Fügen Sie eine Locking-Klausel hinzu: ON CONFLICT (did) DO SELECT FOR UPDATE RETURNING *. Sie können auch mit WHERE filtern, etwa DO SELECT WHERE d.dname != EXCLUDED.dname – nur Zeilen, die die Bedingung erfüllen, kommen zurück.
Berechtigungen: DO SELECT benötigt SELECT auf der Tabelle, und die Formen FOR UPDATE/FOR SHARE benötigen zusätzlich UPDATE auf mindestens einer Spalte.
WAIT FOR LSN: Read-your-writes auf Replikas
Der klassische Replika-Bug: Ein Nutzer speichert sein Profil, der nächste GET trifft ein asynchrones Replika, das die Änderung noch nicht abgespielt hat – und alte Daten kommen zurück. Die meisten Teams pinnen Lesezugriffe nach einem Schreibvorgang an den Primary, was das Replika vergeudet.
PostgreSQL 19 führt den Befehl WAIT FOR ein. Nach einem Schreibvorgang holen Sie sich die WAL-Position des Primary:
UPDATE movie SET genre = 'Dramatic' WHERE genre = 'Drama';
SELECT pg_current_wal_insert_lsn(); -- returns 0/0306EE20
Speichern Sie diesen LSN in der Session des Nutzers (Simon Willison empfiehlt in seinem Beitrag ein signiertes Cookie). Beim nächsten Request führen Sie das auf dem Replika vor dem Lesezugriff aus:
WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '100ms', NO_THROW);
SELECT * FROM movie WHERE genre = 'Drama';

Die Details, die bei einer API zählen:
- Modi. Der Standardmodus
MODE 'standby_replay'wartet, bis die Änderung angewendet wurde – genau das, was Read-your-writes braucht.standby_write,standby_flushundprimary_flushgibt es für Durability-Prüfungen. - Timeouts. Ohne
TIMEOUToder mitTIMEOUT '0'wartet er ewig. Setzen Sie in Request-Pfaden immer einen Timeout. NO_THROW. Ohne diese Option wirft ein Timeout einen Fehler ab und bricht Ihre Transaktion ab. Mit ihr erhalten Sie einen Status vonsuccess,timeoutodernot in recovery, und Sie können auf den Primary ausweichen.- Platzierung.
WAITmuss ein Top-Level-Befehl sein, nicht innerhalb einer Funktion oder einesDO-Blocks. Führen Sie ihn außerhalb einer Transaktion oder als erste Anweisung aus, bevor irgendetwas eine Sperre anfordert – sonst wird er abgelehnt.
REPACK (CONCURRENTLY) ersetzt VACUUM FULL für Live-Tabellen
Tabellen hinter stark frequentierten Endpunkten, etwa sessions oder webhook_deliveries, blähen sich schnell auf. VACUUM FULL und CLUSTER beheben das, sperren aber die Tabelle. PostgreSQL 19 bringt eine Online-Option:
REPACK (CONCURRENTLY) webhook_deliveries;
REPACK (CONCURRENTLY, ANALYZE) orders USING INDEX orders_created_at_idx;
Laut den Release-Notes holt REPACK (CONCURRENTLY) Speicherplatz zurück und kann eine Tabelle nach einem Index neu anordnen, ohne Lese- oder Schreibzugriffe zu blockieren. VACUUM FULL und CLUSTER bleiben aus Kompatibilitätsgründen erhalten. Den Fortschritt verfolgen Sie in der neuen View pg_stat_progress_repack; achten Sie beim Tunen des Clusters auf die neue Servereinstellung max_repack_replication_slots.
JSON-Ausgabe von COPY und neue jsonpath-String-Methoden
Export-Endpunkte streamen Zeilen oft durch Anwendungscode, nur um sie in JSON umzuwandeln. COPY TO kann das jetzt direkt in der Datenbank, laut der COPY-Referenz:
COPY (SELECT * FROM (VALUES(1),(2)) val(id)) TO STDOUT (FORMAT JSON, FORCE_ARRAY);
Das gibt [, {"id":1}, ,{"id":2} und ] in separaten Zeilen aus – das Ergebnis ist also ein gültiges JSON-Array. Ohne FORCE_ARRAY erhalten Sie ein JSON-Objekt pro Zeile, was NDJSON-freundlich ist. SQL-NULL wird zu JSON-null, und das json-Format funktioniert nur mit COPY TO.
Für JSONB-Spalten gewinnt jsonpath String-Methoden: lower(), upper(), initcap(), ltrim(), rtrim(), btrim(), replace() und split_part(). Die Doku zeigt:
jsonb_path_query('"TOM"', '$.lower()') -- "tom"
jsonb_path_query('" hello "', '$.btrim()') -- "hello"
jsonb_path_query('"abc,def,ghi,jkl"', '$.split_part(",", 3)') -- "ghi"
Die Release-Notes kennzeichnen sie als immutable, und damit können Sie ein JSONB-Feld (trimmen, in Kleinbuchstaben umwandeln, splitten) direkt in der Query normalisieren statt in Ihrem Handler.
Außerdem gibt json_array() über null Zeilen jetzt [] statt NULL zurück – was einen Client brechen kann, der auf null prüft.
Weitere PostgreSQL-19-Änderungen, die API-Teams kennen sollten
- Schnellere Fremdschlüssel-Prüfungen. Laut Ankündigung wurden Bulk-Inserts in Tests fast 2x schneller. Nützlich für Import-Endpunkte, die Kindzeilen schreiben.
- Plan-Advice. Die Erweiterung
pg_plan_advicepinnen Planner-Entscheidungen fest, undpg_stash_advicewendet diese Advice per Query-ID an – so lassen sich regressierte Queries fixen, ohne neu zu deployen. - UUID und Encoding. Sie können zwischen
byteaunduuidcasten, undencode()/decode()unterstützenbase64url– das URL-sichere Format für IDs in Pfaden und Tokens. - Logische Replikation für Upgrades.
CREATE PUBLICATION all_sequences FOR ALL SEQUENCES;synchronisiert Sequenzen, undFOR ALL TABLES EXCEPT (TABLE users, departments)schließt Tabellen aus. Damit ist die Lücke „IDs kollidieren nach dem Cutover“ in Blue-Green-Migrationen geschlossen.
Breaking Changes, die Sie vor dem Upgrade prüfen sollten
Der Migrationsabschnitt der Release-Notes listet Änderungen auf, die eine API treffen können, ohne dass eine einzige Query in der Staging-Umgebung fehlschlägt:
| Änderung in PostgreSQL 19 | Was zu prüfen ist |
|---|---|
max_locks_per_transaction: Standard von 64 auf 128, bestehende Einstellungen müssen verdoppelt werden |
Eigene Werte in Ihrer Config oder in der Parameter-Gruppe Ihres Managed Service |
| JIT standardmäßig deaktiviert | Analytics-Endpunkte, die für lange Queries auf JIT setzten |
Standard-TOAST-Kompression von pglz auf lz4 |
Nichts bricht, aber Storage- und CPU-Profile verschieben sich |
standard_conforming_strings erzwungen auf on |
Alte Dumps, die mit off erstellt wurden, lassen sich nicht wiederherstellen |
| MD5-Passwortauthentifizierung loggt eine Warnung; RADIUS entfernt | App-Rollen auf SCRAM-SHA-256 umstellen |
json_array() über null Zeilen gibt [] zurück |
Clients, die auf null testen |
READ ONLY wird an postgres_fdw durchgereicht |
Read-only-Transaktionen, die über eine Foreign Table schrieben |
log_lock_waits standardmäßig aktiviert |
Log-Volumen und Alert-Rauschen |
Ein Upgrade von einer früheren Major-Version erfordert weiterhin pg_upgrade, einen pg_dumpall-Dump mit Restore oder logische Replikation. Planen Sie den Umzug jetzt, wenn Sie auf PostgreSQL 14 sind: Laut der Versionierungs-Policy war deren finales Release am 12. November 2026.
Lassen Sie Ihren Coding-Agent Ihre API nach dem Upgrade mit Apidog CLI regressions-testen
Ein Major-Postgres-Upgrade bricht selten die SQL-Syntax. Es bricht Verhalten: ein json_array(), das [] zurückgibt, ein Lock-Limit, ein langsamerer Plan. Finden Sie es heraus, indem Sie die Testszenarien Ihrer API gegen eine PostgreSQL-19-Staging-Datenbank laufen lassen und sowohl die HTTP-Antwort als auch die dahinterliegenden Zeilen prüfen. Überlassen Sie das Ihrem Coding-Agent mit der Apidog CLI.
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Geben Sie Ihrem Agenten dann einen Prompt:
In Apidog project <projectId>, add a test case for POST /users that sends the same
email twice and asserts the first call returns 201 and the second returns 200 with the
same id. Then run test scenario <scenarioId> against the pg19-staging environment with
database assertions, and summarize every failure next to the PostgreSQL 19 change
that could explain it.
Der Agent liest das Payload-Schema, validiert es, erstellt den Testfall und führt das Szenario anschließend mit Ihrer Datenbank-Verbindungsdatei aus, damit Datenbankschritte den neuen Cluster treffen:
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run -t <scenarioId> --project <projectId> -e <envId> \
--database-connection ./database-connections.json -r cli,junit
Apidogs Datenbankoperationen unterstützen PostgreSQL bereits im Free-Plan, sodass Sie nach jedem Request die Tabelle abfragen und prüfen können, dass der Get-or-Create-Endpunkt genau eine Zeile geschrieben hat. Die Dokumentation führt durch Datenbank-Queries in API-Tests und das Ausführen von Szenarien mit Datenbankverbindungen über die CLI. Nehmen Sie denselben Befehl apidog run ... -r junit in Ihre CI-Pipeline auf, dann erhält jedes spätere Minor-Release dieselbe Prüfung. Wenn Ihr Agent lieber direkt Postgres abfragen soll, lesen Sie die Anleitung zum PostgreSQL-MCP-Server.
FAQ
Wann wurde PostgreSQL 19 veröffentlicht? Am 19. November 2026. Das PostgreSQL-Projekt unterstützt jede Major-Version 5 Jahre lang, Version 19 erhält also Fixes bis zum 19. November 2031.
Ist ON CONFLICT DO SELECT dasselbe wie ein Upsert? Nein. DO UPDATE ändert die vorhandene Zeile; DO SELECT gibt sie unverändert zurück. Verwenden Sie es für Get-or-Create und idempotente POSTs. Es erfordert eine RETURNING-Klausel und ein Conflict-Target.
Funktioniert WAIT FOR LSN auf dem Primary? Der Standardmodus standby_replay funktioniert nur auf einem Standby während der Recovery. Auf einem Primary erhalten Sie einen Fehler – oder not in recovery mit NO_THROW. Verwenden Sie MODE 'primary_flush', wenn Sie auf dem Primary selbst warten müssen.
Kann ich von PostgreSQL 18 direkt auf 19 upgraden? Ja, mit pg_upgrade. Alternativ Dump und Restore oder logische Replikation, die Sequenzen jetzt mit FOR ALL SEQUENCES repliziert. Sehen Sie sich vorher unbedingt die Tabelle mit den Breaking Changes oben an.
Ersetzt PostgreSQL 19 pg_repack? In den meisten Fällen: ja. REPACK (CONCURRENTLY) baut Bloat ab und ordnet Tabellen nach Index neu an, ohne Lese- oder Schreibzugriffe zu blockieren – und es ist direkt im Core enthalten.
