lockForNoKeyUpdate. Diese Methode wurde dem Query Builder von Laravel 13.x hinzugefügt und erzeugt für PostgreSQL FOR NO KEY UPDATE.
Diese Seite basiert auf der Implementierung von Laravel Framework 13.x. Prüfen Sie, ob die Funktion aus dem Branch
13.x in der von Ihnen verwendeten Release enthalten ist.Unterschied zu lockForUpdate
Die offizielle Laravel-Dokumentation beschreibt pessimistisches Sperren mit sharedLock und lockForUpdate. lockForNoKeyUpdate fügt einen weiteren Sperrmodus hinzu, der über die gemeinsame API des Query Builders ausgewählt werden kann.
FOR NO KEY UPDATE bedeutet nicht, dass alle Operationen ohne Blockierung ablaufen. Verwenden Sie es nur, wenn die schwächere Update-Sperre angemessen ist, und prüfen Sie die Transaktionsgrenzen und das Sperrverhalten der Datenbank, die Sie tatsächlich einsetzen.
Innerhalb einer Transaktion verwenden
Erwerben Sie die pessimistische Sperre und führen Sie das Update in derselben Transaktion aus. Im folgenden Beispiel bleibt die Benutzerzeile gesperrt, während die Aktualisierung des Guthabens vorbereitet und geschrieben wird.lockForUpdate empfiehlt, bleiben die abgerufenen Daten durch das Einschließen in eine Transaktion geschützt, bis die Operation abgeschlossen ist. DB::transaction committet, wenn der Callback normal zurückkehrt, und führt ein Rollback aus, wenn der Callback eine Exception wirft.
lockForNoKeyUpdate fügt der select-Abfrage nur eine Sperrklausel hinzu. Es führt weder automatisch ein Update aus noch deaktiviert es Fremdschlüssel-Constraints.
Erzeugtes SQL je Datenbank
Der Query Builder fragt die Grammar der Verbindung nach dem Sperrwert. In der Implementierung von Laravel Framework 13.x gibt nur die PostgreSQL-Grammarfor no key update zurück.
Eine PostgreSQL-Verbindung erzeugt zum Beispiel folgendes SQL. Bindings funktionieren wie bei jeder anderen Query-Builder-Abfrage.
lockForNoKeyUpdate auf einer Nicht-PostgreSQL-Verbindung schlägt selbst nicht fehl. Er hat jedoch nicht dieselbe Bedeutung wie FOR NO KEY UPDATE in PostgreSQL: MySQL und SQL Server kompilieren ihn zu ihrer normalen Update-Sperre, während SQLite keine Sperrklausel ausgibt.
Interne Verarbeitung im Framework
Die Methode überlässt die Wahl der Sperre der Grammar der Verbindung, statt im Query Builder nach Datenbanktreibern zu verzweigen.Builder::lockForNoKeyUpdate()ruftgrammar->getNoKeyUpdateLock()auf.- Die Basisklasse
Grammargibttruezurück, was den Fallback auf die normale Update-Sperre darstellt. PostgresGrammargibt den Stringfor no key updatezurück.compileLockübernimmt String-Werte unverändert; jede Grammar entscheidet selbst, wie sie den booleschen Fallback kompiliert.
Von bestehenden pessimistischen Sperren migrieren
Wenn Sie einen bestehenden Aufruf vonlockForUpdate ersetzen, ändern Sie nicht nur den Methodennamen. Prüfen Sie Folgendes:
- Die Operation benötigt wirklich eine Sperre, die Fremdschlüsselprüfungen nicht blockiert.
- Die Produktionsverbindung verwendet PostgreSQL.
- Der Fallback auf eine normale Update-Sperre ist unter MySQL oder SQL Server akzeptabel.
- Erwerb der Sperre, Update und Commit erfolgen in einer Transaktion.
- Die Reihenfolge, in der bestehende Sperren auf mehrere Zeilen erworben werden, bleibt konsistent.
method_exists-Prüfung kann eine Bedeutungsänderung verbergen: Ein Benutzer erwartet vielleicht das PostgreSQL-Verhalten, während ein anderer Treiber eine normale FOR UPDATE-Sperre ausführt.
Verwendete Primärquellen
- Offizielle Laravel-Datenbankdokumentation: Pessimistic Locking
- Implementierung von
Builder::lockForNoKeyUpdate - Implementierung von
Grammar::getNoKeyUpdateLock - Implementierung von
PostgresGrammar::getNoKeyUpdateLock - Implementierung von
SQLiteGrammar::compileLock - Offizielle Tests für das von jedem Treiber erzeugte SQL
- Commit, mit dem die Funktion zu Laravel Framework hinzugefügt wurde