lockForNoKeyUpdate. Deze methode is toegevoegd aan de query builder van Laravel 13.x en genereert FOR NO KEY UPDATE voor PostgreSQL.
Deze pagina is gebaseerd op de implementatie van Laravel Framework 13.x. Controleer of de functionaliteit die aan de branch
13.x is toegevoegd, in de release zit die je gebruikt.Verschil met lockForUpdate
De officiële Laravel-documentatie beschrijft pessimistische vergrendeling met sharedLock en lockForUpdate. lockForNoKeyUpdate voegt een extra vergrendelingsmodus toe die je via de gemeenschappelijke API van de query builder kunt kiezen.
FOR NO KEY UPDATE betekent niet dat elke bewerking zonder blokkering kan doorgaan. Gebruik het alleen wanneer de zwakkere update-lock geschikt is, en controleer de transactiegrenzen en het vergrendelingsgedrag van de database die je daadwerkelijk gebruikt.
Gebruik het binnen een transactie
Verkrijg de pessimistische lock en voer de update uit in dezelfde transactie. In het volgende voorbeeld blijft de gebruikersrij vergrendeld terwijl de saldo-update wordt voorbereid en weggeschreven.lockForUpdate, blijven de opgehaalde gegevens beschermd tot de bewerking is voltooid wanneer je de bewerking in een transactie verpakt. DB::transaction commit wanneer de callback normaal terugkeert en voert een rollback uit wanneer de callback een exception gooit.
lockForNoKeyUpdate voegt alleen een lock-clausule toe aan de select-query. Het voert niet automatisch een update uit en schakelt geen foreign key-constraints uit.
Gegenereerde SQL per database
De query builder vraagt de lock-waarde op bij de grammar van de verbinding. In de implementatie van Laravel Framework 13.x geeft alleen de PostgreSQL-grammarfor no key update terug.
Een PostgreSQL-verbinding produceert bijvoorbeeld SQL zoals hieronder. Bindings werken net als bij elke andere query builder-query.
lockForNoKeyUpdate aanroepen op een verbinding die geen PostgreSQL is, faalt op zich niet. Het heeft echter niet dezelfde betekenis als FOR NO KEY UPDATE in PostgreSQL: MySQL en SQL Server compileren het naar hun equivalent van de gewone update-lock, terwijl SQLite geen lock-clausule uitgeeft.
Interne verwerking in het framework
De methode laat de keuze van de lock over aan de grammar van de verbinding, in plaats van in de query builder te vertakken op databasedriver.Builder::lockForNoKeyUpdate()roeptgrammar->getNoKeyUpdateLock()aan.- De basisklasse
Grammargeefttrueterug, wat de terugval op de gewone update-lock voorstelt. PostgresGrammargeeft de stringfor no key updateterug.compileLockneemt stringwaarden ongewijzigd over; elke grammar bepaalt zelf hoe de booleaanse terugval wordt gecompileerd.
Migreren vanaf bestaande pessimistische locks
Wanneer je een bestaande aanroep vanlockForUpdate vervangt, verander dan niet alleen de methodenaam. Controleer al het volgende:
- De bewerking heeft echt een lock nodig die foreign key-controles niet blokkeert.
- De productieverbinding gebruikt PostgreSQL.
- Terugvallen op een gewone update-lock is acceptabel op MySQL of SQL Server.
- Het verkrijgen van de lock, de update en de commit gebeuren in één transactie.
- De volgorde waarin bestaande locks op meerdere rijen worden verkregen, blijft consistent.
method_exists-controle kan een betekenisverandering verbergen: een gebruiker verwacht misschien PostgreSQL-gedrag terwijl een andere driver een gewone FOR UPDATE-lock uitvoert.
Geraadpleegde primaire bronnen
- Officiële Laravel-databasedocumentatie: Pessimistic Locking
- Implementatie van
Builder::lockForNoKeyUpdate - Implementatie van
Grammar::getNoKeyUpdateLock - Implementatie van
PostgresGrammar::getNoKeyUpdateLock - Implementatie van
SQLiteGrammar::compileLock - Officiële tests voor de SQL die elke driver genereert
- Commit waarmee de functionaliteit aan Laravel Framework is toegevoegd