lockForNoKeyUpdate. Questo metodo è stato aggiunto al query builder di Laravel 13.x e genera FOR NO KEY UPDATE su PostgreSQL.
Questa pagina si basa sull’implementazione di Laravel Framework 13.x. Verifica che la funzionalità aggiunta al branch
13.x sia inclusa nella release che stai usando.Differenze rispetto a lockForUpdate
La documentazione ufficiale di Laravel descrive il lock pessimistico con sharedLock e lockForUpdate. lockForNoKeyUpdate aggiunge un’altra modalità di lock selezionabile tramite l’API comune del query builder.
FOR NO KEY UPDATE non significa che ogni operazione possa procedere senza blocchi. Usalo solo quando il lock di aggiornamento più debole è appropriato e verifica i confini della transazione e il comportamento di lock del database che usi realmente.
Usarlo all’interno di una transazione
Acquisisci il lock pessimistico ed esegui l’aggiornamento nella stessa transazione. Nell’esempio seguente, la riga dell’utente resta bloccata mentre l’aggiornamento del saldo viene preparato e scritto.lockForUpdate, racchiudere l’operazione in una transazione mantiene protetti i dati recuperati fino al completamento dell’operazione. DB::transaction esegue il commit quando la callback ritorna normalmente e il rollback quando la callback lancia un’eccezione.
lockForNoKeyUpdate aggiunge solo una clausola di lock alla query select. Non esegue alcun aggiornamento automaticamente né disattiva i vincoli di chiave esterna.
SQL generato per database
Il query builder chiede il valore del lock alla grammatica della connessione. Nell’implementazione di Laravel Framework 13.x, solo la grammatica di PostgreSQL restituiscefor no key update.
Per esempio, una connessione PostgreSQL produce un SQL come questo. I binding funzionano come in qualsiasi altra query del query builder.
lockForNoKeyUpdate su una connessione diversa da PostgreSQL non fallisce di per sé. Tuttavia non ha lo stesso significato di FOR NO KEY UPDATE di PostgreSQL: MySQL e SQL Server lo compilano nel loro equivalente del normale lock di aggiornamento, mentre SQLite non emette alcuna clausola di lock.
Elaborazione interna del framework
Il metodo delega la scelta del lock alla grammatica della connessione invece di diramarsi in base al driver del database nel query builder.Builder::lockForNoKeyUpdate()chiamagrammar->getNoKeyUpdateLock().- La classe base
Grammarrestituiscetrue, che rappresenta il ripiego sul normale lock di aggiornamento. PostgresGrammarrestituisce la stringafor no key update.compileLockmantiene invariati i valori stringa; ogni grammatica decide come compilare il ripiego booleano.
Migrare dai lock pessimistici esistenti
Quando sostituisci una chiamata esistente alockForUpdate, non cambiare solo il nome del metodo. Verifica tutti i punti seguenti:
- L’operazione ha davvero bisogno di un lock che non blocchi i controlli delle chiavi esterne.
- La connessione di produzione usa PostgreSQL.
- Ripiegare su un normale lock di aggiornamento è accettabile su MySQL o SQL Server.
- L’acquisizione del lock, l’aggiornamento e il commit avvengono in un’unica transazione.
- L’ordine in cui vengono acquisiti i lock esistenti su più righe resta coerente.
method_exists può nascondere un cambiamento di significato: un utente potrebbe aspettarsi il comportamento di PostgreSQL mentre un altro driver esegue un normale lock FOR UPDATE.
Fonti primarie consultate
- Documentazione ufficiale di Laravel sul database: Pessimistic Locking
- Implementazione di
Builder::lockForNoKeyUpdate - Implementazione di
Grammar::getNoKeyUpdateLock - Implementazione di
PostgresGrammar::getNoKeyUpdateLock - Implementazione di
SQLiteGrammar::compileLock - Test ufficiali dell’SQL generato da ciascun driver
- Commit che ha aggiunto la funzionalità a Laravel Framework