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은 문자열 값을 그대로 사용하며, boolean 대체를 어떻게 컴파일할지는 각 grammar가 결정합니다.
기존 비관적 잠금에서 마이그레이션하기
기존lockForUpdate 호출을 대체할 때는 메서드 이름만 바꾸지 마세요. 다음을 모두 확인하세요.
- 해당 작업에 정말로 외래 키 검사를 막지 않는 잠금이 필요한가.
- 프로덕션 연결이 PostgreSQL을 사용하는가.
- MySQL이나 SQL Server에서 일반 업데이트 잠금으로 대체되어도 괜찮은가.
- 잠금 획득, 업데이트, 커밋이 하나의 트랜잭션 안에서 이루어지는가.
- 여러 행에 대한 기존 잠금의 획득 순서가 일관되게 유지되는가.
method_exists 확인만으로는 의미의 변화가 가려질 수 있습니다. 사용자는 PostgreSQL의 동작을 기대하는데, 다른 드라이버에서는 일반 FOR UPDATE 잠금이 실행될 수 있습니다.