...
Eroare PostgreSQL · Tranzacții, blocări și concurență

ERROR: FOR UPDATE cannot be applied to the nullable side of an outer join

Pe scurt

Interogarea cu LEFT JOIN și FOR UPDATE ar trebui să blocheze și rânduri din tabelul din dreapta, care pot lipsi (NULL). PostgreSQL nu poate bloca un rând inexistent. Limitează blocarea la tabelul din stânga: FOR UPDATE OF c.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

FOR UPDATE fără precizări încearcă să blocheze rândurile din toate tabelele din FROM. Într-un LEFT JOIN, partea dreaptă poate să nu aibă rând corespunzător (coloanele ei sunt NULL), deci nu există ce bloca, iar PostgreSQL refuză. Mesajul apare și la RIGHT JOIN sau FULL JOIN, pentru partea care poate lipsi.

Clauza FOR UPDATE OF alias spune exact ce tabele se blochează: FOR UPDATE OF c blochează doar clienții, iar comenzile sunt citite fără blocaj. Dacă ai nevoie și de rândurile din partea dreaptă, blochează-le separat, după ce știi că există. Folosirea lui OF e o practică bună și cu JOIN simplu: blocajele inutile pe tabele auxiliare cresc riscul de așteptări și de blocaje reciproce.

De ce apare: cauzele frecvente

1LEFT JOIN cu blocare pe tot

Greșit
SQL
SELECT c.id, co.id FROM clienti c LEFT JOIN comenzi co ON co.client_id = c.id FOR UPDATE;
Corect
SQL
SELECT c.id, co.id FROM clienti c LEFT JOIN comenzi co ON co.client_id = c.id FOR UPDATE OF c;

Doar rândurile din clienti sunt blocate.

2Blocarea separată a părții drepte

Greșit
SQL
-- ai nevoie și de comenzi blocate
Corect
SQL
SELECT ... FOR UPDATE OF c;
SELECT * FROM comenzi WHERE client_id = 1 FOR UPDATE;

Rândurile care există se blochează într-o interogare separată.

Repară tu

Repară eroarea, direct în pagină

Procesul care verifică clienții, inclusiv cei fără comenzi, blochează rezultatul unui LEFT JOIN cu FOR UPDATE și dă FOR UPDATE cannot be applied to the nullable side of an outer join. Blochează doar clienții și afișează numele și numărul de comenzi ale fiecăruia, într-o tranzacție.

Codul care dă eroarea
SQL
BEGIN;
SELECT x.nume, count(x.comanda) AS comenzi FROM (
  SELECT c.id, c.nume, co.id AS comanda
  FROM clienti c LEFT JOIN comenzi co ON co.client_id = c.id
  FOR UPDATE
) x GROUP BY x.id, x.nume ORDER BY x.id;
COMMIT;
După reparație, programul afișează
BEGIN
     nume      | comenzi
---------------+---------
 Ana Pop       |       2
 Mihai Ionescu |       1
 Elena Dinu    |       0
(3 rânduri)

COMMIT
Indiciu

FOR UPDATE OF c

Cum o eviți pe viitor

  • Folosește întotdeauna FOR UPDATE OF alias în interogările cu JOIN.
  • Blochează doar rândurile pe care le vei modifica.
  • Separă citirea relațiilor opționale de blocarea rândurilor principale.
  • Testează sub concurență fluxurile care iau blocaje pe mai multe tabele.

Întrebări frecvente

FOR UPDATE OF poate primi mai multe aliasuri?

Da: FOR UPDATE OF c, co, dar nu pentru partea care poate lipsi a unui JOIN extern.

Pot combina NOWAIT sau SKIP LOCKED cu OF?

Da: FOR UPDATE OF c SKIP LOCKED.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.