lockForNoKeyUpdate。這個方法是 Laravel 13.x 的 Query Builder 新增的,在 PostgreSQL 中會產生 FOR NO KEY UPDATE。
本頁以 Laravel Framework 13.x 的實作 為基礎。請確認
13.x 分支新增的功能已包含在你使用的版本中。與 lockForUpdate 的差異
Laravel 官方文件介紹了使用 sharedLock 與 lockForUpdate 的悲觀鎖定。lockForNoKeyUpdate 新增了另一種可以透過 Query Builder 共通 API 選擇的鎖定模式。
FOR NO KEY UPDATE 並不代表所有操作都能不受阻擋地進行。只有在較弱的更新鎖定合適時才使用它,並確認你實際使用的資料庫的交易邊界與鎖定行為。
在交易中使用
在同一個交易中取得悲觀鎖定並執行更新。在下面的範例中,準備並寫入餘額更新的期間,使用者列會一直保持鎖定。lockForUpdate 的建議,將操作包在交易中,可以讓取得的資料在操作完成前持續受到保護。DB::transaction 會在回呼正常返回時提交,並在回呼拋出例外時回滾。
lockForNoKeyUpdate 只會為 select 查詢加上鎖定子句。它不會自動執行更新,也不會停用外鍵限制。
各資料庫的產生結果
Query Builder 會向連線的 grammar 詢問鎖定值。在 Laravel Framework 13.x 的實作中,只有 PostgreSQL grammar 會回傳for no key update。
例如,PostgreSQL 連線會產生如下的 SQL。繫結參數的處理方式與其他 Query Builder 查詢相同。
lockForNoKeyUpdate 本身不會失敗。但它與 PostgreSQL 的 FOR NO KEY UPDATE 意義並不相同:MySQL 與 SQL Server 會將其編譯為各自的一般更新鎖定,而 SQLite 則不輸出鎖定子句。
Framework 內部的處理
這個方法不在 Query Builder 中依資料庫驅動程式分支,而是將鎖定的選擇交給連線的 grammar。Builder::lockForNoKeyUpdate()呼叫grammar->getNoKeyUpdateLock()。- 基礎
Grammar回傳true,代表退回為一般更新鎖定。 PostgresGrammar回傳字串for no key update。compileLock會原樣使用字串值;布林退回值要如何編譯則由各個 grammar 決定。
從既有的悲觀鎖定遷移
替換既有的lockForUpdate 呼叫時,不要只修改方法名稱。請確認以下所有事項:
- 該操作確實需要不阻擋外鍵檢查的鎖定。
- 正式環境的連線使用 PostgreSQL。
- 在 MySQL 或 SQL Server 上退回為一般更新鎖定是可以接受的。
- 取得鎖定、更新與提交都在同一個交易中完成。
- 對多列取得既有鎖定的順序保持一致。
method_exists 檢查可能會掩蓋語意上的變化:使用者可能預期 PostgreSQL 的行為,但其他驅動程式實際執行的是一般的 FOR UPDATE 鎖定。