Ce que la version 19 de PostgreSQL change dans le code de vos applications
Ou : Comment arrêter de mettre à jour une ligne dans le seul but de pouvoir la relire
Le jeudi 19 novembre 2026, le PostgreSQL Global Development Group a publié PostgreSQL 19, la nouvelle version majeure du serveur de base de données libre. La date venait de l’annonce de la première version candidate, le 15 octobre : sortie prévue le 19 novembre, « unless an issue is discovered that requires a delay », sauf problème découvert d’ici là1. Le calendrier initial visait le 29 octobre2 ; l’équipe de publication a préféré attendre la mise à jour des branches stables du 12 novembre pour intégrer ses nombreux correctifs, d’où une seconde version candidate ce jour-là3. Le résumé officiel met en avant une commande REPACK, un module pour orienter le planificateur, la réplication logique des séquences et un autovacuum parallèle4. Pour qui écrit du SQL dans une application Django ou Go, la liste utile est plus courte, et plus concrète.
Les notes de version d’une version majeure ressemblent au registre d’une grande bibliothèque : des centaines de lignes, presque toutes destinées au personnel. Le lecteur, lui, cherche trois ou quatre fiches qui changent sa façon d’emprunter. Les voici.
Les nouveautés de PostgreSQL 19 pour les développeurs : SQL, réplication, JSON et maintenance
ON CONFLICT DO SELECT : le get-or-create en une seule requête
Le besoin est banal : insérer une étiquette ou une clé d’idempotence si elle n’existe pas, et récupérer la ligne dans tous les cas. Jusqu’ici, INSERT ... ON CONFLICT DO NOTHING RETURNING * ne renvoyait rien pour les lignes déjà présentes, puisque la documentation précise que seules les lignes insérées, mises à jour ou sélectionnées sont renvoyées5. Il fallait donc une seconde requête SELECT, avec la fenêtre de concurrence que cela suppose, ou l’astuce répandue d’un DO UPDATE factice, qui réécrit une colonne avec sa propre valeur. Cette astuce fonctionne. Elle crée aussi une nouvelle version de la ligne, déclenche les triggers de mise à jour et laisse du travail à l’autovacuum, le tout pour lire une donnée qui n’avait pas changé.
PostgreSQL 19 ajoute une troisième action, DO SELECT, que la documentation décrit elle-même comme un « get or create » : l’issue est atomique, soit une insertion, soit une sélection5. L’exemple officiel :
| |
Deux variantes méritent l’attention. La première filtre la ligne renvoyée avec un WHERE qui compare l’existant (d) et la proposition (EXCLUDED) ; la seconde verrouille la ligne existante, comme un SELECT ... FOR UPDATE :
| |
Les règles du jeu sont strictes : RETURNING est obligatoire, la cible du conflit aussi, et la variante FOR UPDATE exige le droit UPDATE sur au moins une colonne en plus du droit SELECT5. Côté ORM, la documentation de Django rappelle que get_or_create() n’est atomique que si la base impose l’unicité des champs recherchés6 ; la contrainte reste indispensable, mais la base sait désormais tout faire en un aller-retour.
WAIT FOR LSN : relire ses propres écritures sur une réplique
Voici la nouveauté qui m’intéresse le plus. L’application écrit sur le serveur principal, puis relit sur une réplique asynchrone pour le soulager. Si la réplique a quelques millisecondes de retard, l’utilisateur qui vient d’enregistrer son profil voit l’ancienne version. Les contournements habituels consistent à relire sur le principal pendant un moment, ou à espérer.
La nouvelle commande WAIT attend qu’une position du journal des transactions (le LSN) soit atteinte sur la réplique avant de rendre la main. Les notes de version la présentent comme le support de la cohérence « read-your-writes » sur les serveurs secondaires4. L’exemple de la documentation, d’abord sur le principal :
| |
Puis sur la réplique, avec la position transmise par l’application :
| |
Le mode par défaut, standby_replay, attend que les changements soient appliqués. Les options TIMEOUT et NO_THROW transforment l’erreur de délai dépassé en un statut timeout que l’application peut traiter, par exemple en se rabattant sur le principal7 :
| |
Les limites sont écrites noir sur blanc. Le LSN doit être conservé côté application ou côté pooler de connexions ; WAIT doit être une commande de premier niveau, jamais dans une fonction, une procédure ou un bloc DO ; et il faut l’émettre avant toute instruction qui prend des verrous, faute de quoi le serveur peut la refuser7. Autrement dit, PostgreSQL fournit le guichet, pas le carnet où noter son numéro.
DevOps Dave : Super, je mets
WAIT FOR LSNdans une fonction PL/pgSQL et on n’en parle plus.Security Sarah : La documentation l’interdit.
DevOps Dave : Alors dans un middleware, juste après la première requête de la transaction.
Security Sarah : Avant, Dave. Avant la première requête.
Le JSON devient un format de sortie de COPY
COPY TO sait maintenant écrire du JSON, une ligne par objet, ou un seul tableau avec l’option FORCE_ARRAY8. L’exemple officiel :
| |
| |
Pour un export vers un autre service, plus besoin d’un script qui relit tout pour le sérialiser. Deux détails : le format JSON n’existe qu’en sortie, et un NULL SQL comme un null JSON stocké dans une colonne jsonb sortent tous deux en null, sans distinction possible8. En sens inverse, COPY FROM gagne l’option ON_ERROR set_null, qui remplace une valeur invalide par NULL au lieu d’interrompre la commande ou d’écarter la ligne entière8.
Le langage jsonpath reçoit huit méthodes de chaînes : ltrim(), rtrim(), btrim(), lower(), upper(), initcap(), replace() et split_part(), immuables comme leurs équivalents SQL4. Deux exemples de la documentation9 :
| |
Dans le même esprit, le type uuid se convertit désormais vers et depuis bytea, ce qui ouvre encode() et decode() aux identifiants10. Si vous avez déjà pesé le choix d’un UUID v7 en clé primaire, voici de quoi le raccourcir dans une URL :
| |
Le nouveau format base64url de encode(), sans +, / ni =, se colle tel quel dans une adresse11.
REPACK (CONCURRENTLY) : récupérer l’espace sans bloquer la table
VACUUM rend réutilisable l’espace des lignes mortes sans le restituer au système. Pour le restituer, il fallait VACUUM FULL ou CLUSTER, qui posent un verrou exclusif pendant toute la réécriture : ni lecture ni écriture. PostgreSQL 19 les unifie sous REPACK, garde les anciennes pour la compatibilité, et ajoute surtout l’option CONCURRENTLY12 :
| |
En mode concurrent, l’essentiel du travail se fait sous un verrou qui laisse passer lectures et écritures ; les changements survenus pendant la copie sont captés par décodage logique, et le verrou exclusif n’intervient qu’à la fin, pour échanger les fichiers. La documentation est franche sur le prix : la commande n’est pas sûre au sens MVCC, et une transaction dont l’instantané précède le début de l’opération verra la table vide après coup ; il faut assez de disque pour une copie de la table et de ses index ; l’opération échoue au-delà d’environ 104 millions de lignes modifiées pendant son exécution ; et elle refuse les tables partitionnées, non journalisées ou sans clé primaire ni identité de réplique12. Pas un geste à automatiser sans réfléchir, donc, mais le cœur de PostgreSQL fait enfin ce que des extensions externes faisaient jusqu’ici.
Des optimisations qui ne demandent aucune ligne de code
Le reste de la liste profite à l’application sans qu’elle le sache. Une sélection, tirée des notes de version4 :
| Changement | Ce que cela change pour l’application |
|---|---|
NOT IN converti en anti-jointure quand aucun NULL n’est possible | Les vieilles requêtes NOT IN (SELECT ...) peuvent changer de plan, en mieux |
| Vérifications de clés étrangères plus rapides | Insertions et mises à jour moins chères sur les tables liées |
NOTIFY ne réveille plus que les sessions à l’écoute | LISTEN/NOTIFY coûte moins cher avec beaucoup de connexions |
Compression TOAST par défaut en lz4 au lieu de pglz | Grandes valeurs text et jsonb compressées par une méthode plus efficace, selon le projet |
| JIT désactivé par défaut | Moins de surprises sur les requêtes courtes ; à réactiver pour l’analytique lourde |
IGNORE NULLS pour lag(), lead(), first_value(), last_value() et nth_value() | Plus besoin de sous-requête pour « la dernière valeur non nulle » |
Le JIT mérite une phrase de plus : il était activé par défaut et déclenché selon les coûts estimés par le planificateur, une estimation que le projet juge maintenant peu fiable4. Les bases très analytiques devront le rallumer elles-mêmes.
Avant de migrer : version majeure, pg_upgrade et tests
PostgreSQL 19 est une version majeure : le format de stockage interne peut changer, et passer de la 18 à la 19 demande pg_dumpall, pg_upgrade ou la réplication logique, pas un simple remplacement des binaires4. La documentation propose pg_upgrade --check pour vérifier la compatibilité des deux clusters sans rien modifier, même avec l’ancien serveur en marche13. Depuis la 18, pg_upgrade conserve la plupart des statistiques du planificateur ; il reste à lancer vacuumdb comme il l’indique à la fin13.
La section « Migration to Version 19 » des notes de version contient les changements qui peuvent casser une application4 :
| Changement | Risque |
|---|---|
standard_conforming_strings toujours activé | Les dumps faits avec un pg_dump antérieur à la 19 et ce paramètre désactivé ne se rechargent pas correctement |
| Avertissement après chaque authentification par mot de passe MD5 | Rappel que MD5 est déprécié depuis la 18 ; désactivable avec md5_password_warnings |
json_array() sur une requête sans résultat renvoie [] au lieu de NULL | Code applicatif qui testait NULL |
max_locks_per_transaction passe de 64 à 128, avec une nouvelle allocation | Une valeur personnalisée doit être doublée pour garder la même capacité |
Recherche plein texte et pg_trgm suivent le fournisseur de locale de la base | Index à reconstruire après pg_upgrade si la locale n’est pas libc |
Si vous avez testé les préversions : la RC 2 a retiré l’usage de JSON_ARRAY() et JSON_OBJECT() sur des tableaux, types composites ou intervalles dans les index d’expression, colonnes générées et clés de partition. Les objets créés ainsi doivent être supprimés ou redéfinis avant la mise à niveau, sinon pg_dump et pg_upgrade échoueront à les recréer3.
Reste ce que personne ne fera à votre place : passer votre suite de tests sur la nouvelle version. La documentation conseille d’installer l’ancienne et la nouvelle côte à côte et de tester les applications clientes avant de basculer13. Une suite de tests d’intégration qui lancent un vrai PostgreSQL dans un conteneur rend l’exercice presque gratuit : changer l’étiquette de l’image, relancer, lire ce qui casse. Rien ne presse non plus : le projet maintient chaque version majeure cinq ans14, et c’est la 14, pas la 18, qui a reçu sa dernière mise à jour le 12 novembre 20263.
Pendant des années, pour relire une ligne qui existait déjà, on l’a réécrite, parce que c’était la façon la plus simple de la faire sortir du RETURNING. PostgreSQL 19 ajoute la façon évidente, et une autre pour attendre qu’une réplique ait rattrapé le principal au lieu de l’espérer. La première ne figure même pas dans le résumé officiel ; la seconde y arrive en avant-dernière ligne. Les fiches qui changent le code d’une application se trouvent rarement en tête du registre.
L’annonce de PostgreSQL 19 RC 1, publiée le 15 octobre 2026, avec la date prévue et le calendrier. ↩︎
Le message de Jonathan S. Katz sur la liste pgsql-hackers, le 28 septembre 2026, fixait la RC 1 au 15 octobre et la sortie au jeudi 29 octobre 2026, sauf problème important. ↩︎
L’annonce du 12 novembre 2026 : versions 18.7, 17.12, 16.16, 15.20 et 14.25, et PostgreSQL 19 RC 2. ↩︎ ↩︎ ↩︎
Les notes de version de PostgreSQL 19, consultées dans leur état du 9 octobre 2026. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
La documentation de la commande INSERT de PostgreSQL 19, section « ON CONFLICT Clause » et exemples. Elle précise aussi que, sur le chemin
DO SELECT, les valeursNEWrenvoyées sont identiques aux valeursOLD, puisque rien n’est modifié. ↩︎ ↩︎ ↩︎La référence de l’API QuerySet de Django, section
get_or_create(): sans contrainte d’unicité sur les champs recherchés, des appels concurrents peuvent insérer plusieurs lignes identiques. ↩︎La documentation de la commande WAIT décrit ses quatre modes et ses restrictions. Si la réplique est promue pendant l’attente, le statut renvoyé est
not in recovery. ↩︎ ↩︎La documentation de la commande COPY, options
FORMAT,FORCE_ARRAYetON_ERROR. ↩︎ ↩︎ ↩︎La page des fonctions JSON de PostgreSQL 19, tableau des méthodes jsonpath. ↩︎
La page du type UUID de PostgreSQL 19, dont sont tirés les deux exemples de conversion. ↩︎
La page des fonctions sur les chaînes binaires :
base64urly suit la RFC 4648, section 5. ↩︎La documentation de la commande REPACK, en particulier la section « Notes on Concurrent Operation » et son avertissement sur la sécurité MVCC. ↩︎ ↩︎
La section « Upgrading a PostgreSQL Cluster » et la documentation de pg_upgrade. ↩︎ ↩︎ ↩︎
La politique de versions du projet : une version majeure par an environ, cinq ans de maintenance chacune. ↩︎