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.

Testen Sie Apidog noch heute

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 bei DO SELECT erforderlich.
  • Ein conflict_target ist erforderlich, genau wie bei DO UPDATE.
  • Exclusion Constraints können nicht als Arbiter dienen; verwenden Sie einen Unique Index oder ein NOT DEFERRABLE-Unique-Constraint.

Flowchart of a POST /users request using INSERT ON CONFLICT (email) DO SELECT RETURNING: no conflict inserts and returns the row (201), a conflict returns the existing row unmodified (200)

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'; 

Sequence diagram: API server commits an UPDATE on the primary, reads pg_current_wal_insert_lsn 0/0306EE20, stores it in the session, then on the next request sends WAIT FOR LSN to the read replica, gets success, and SELECTs the fresh row

Die Details, die bei einer API zählen:

  1. Modi. Der Standardmodus MODE 'standby_replay' wartet, bis die Änderung angewendet wurde – genau das, was Read-your-writes braucht. standby_write, standby_flush und primary_flush gibt es für Durability-Prüfungen.
  2. Timeouts. Ohne TIMEOUT oder mit TIMEOUT '0' wartet er ewig. Setzen Sie in Request-Pfaden immer einen Timeout.
  3. NO_THROW. Ohne diese Option wirft ein Timeout einen Fehler ab und bricht Ihre Transaktion ab. Mit ihr erhalten Sie einen Status von success, timeout oder not in recovery, und Sie können auf den Primary ausweichen.
  4. Platzierung. WAIT muss ein Top-Level-Befehl sein, nicht innerhalb einer Funktion oder eines DO-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_advice pinnen Planner-Entscheidungen fest, und pg_stash_advice wendet diese Advice per Query-ID an – so lassen sich regressierte Queries fixen, ohne neu zu deployen.
  • UUID und Encoding. Sie können zwischen bytea und uuid casten, und encode()/decode() unterstützen base64url – 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, und FOR 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 langsamer 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.