Nesta página, descrevemos como usar a cláusula FOR UPDATE no
isolamento de leitura repetível.
No isolamento de leitura repetível, se a cláusula FOR UPDATE adquire bloqueios
depende do modo de controle de simultaneidade. Para mais informações, consulte
Por que usar a cláusula FOR UPDATE.
Para mais informações sobre bloqueios em FOR UPDATE, consulte Usar SELECT FOR UPDATE
em isolamento serializável.
Para saber como usar a cláusula FOR UPDATE, consulte os guias de referência do FOR UPDATE do GoogleSQL e do PostgreSQL.
Por que usar a cláusula FOR UPDATE
Quando uma transação é executada com isolamento de leitura repetível, os dados consultados
pela instrução SELECT são sempre retornados no carimbo de data/hora do snapshot
estabelecido para a transação. Se a transação fizer atualizações com base nos dados consultados, poderão ocorrer problemas de precisão se uma transação simultânea também atualizar os dados consultados. Para mais informações, consulte
Conflitos de leitura e gravação e correção.
Para garantir que os dados consultados permaneçam válidos no momento da confirmação, use a
cláusula FOR UPDATE com isolamento de leitura repetível. O uso de FOR UPDATE evita
conflitos de leitura e gravação em que outra transação atualiza os dados depois que eles são
lidos:
- Com o controle de simultaneidade otimista (padrão), o Spanner valida que os intervalos verificados não foram modificados antes da confirmação. Se um conflito for detectado, o Spanner cancelará a transação.
- Com o controle de simultaneidade pessimista, o Spanner adquire bloqueios exclusivos durante a execução da leitura, impedindo que transações simultâneas modifiquem os dados bloqueados até que a transação seja confirmada.
Sintaxe das consultas
Nesta seção, fornecemos orientações sobre a sintaxe de consulta ao usar a cláusula FOR UPDATE.
O uso mais comum é em uma instrução SELECT de nível superior. Exemplo:
SELECT SingerId, SingerInfo
FROM Singers WHERE SingerID = 5
FOR UPDATE;
A cláusula FOR UPDATE garante que os dados consultados pela instrução SELECT
e SingerID = 5 ainda sejam válidos quando a transação for confirmada,
evitando problemas de correção que podem surgir se uma transação simultânea
atualizar os dados consultados.
Uso em instruções WITH
A cláusula FOR UPDATE não verifica os intervalos verificados na instrução WITH
quando você especifica FOR UPDATE na consulta de nível externo da instrução
WITH.
Na consulta a seguir, nenhum intervalo verificado é validado porque
FOR UPDATE não é propagado para a consulta de expressões de tabela comuns (CTE).
WITH s AS (SELECT SingerId, SingerInfo FROM Singers WHERE SingerID > 5)
SELECT * FROM s
FOR UPDATE;
Se a cláusula FOR UPDATE for especificada na consulta CTE, o intervalo verificado
da consulta CTE será validado.
No exemplo a seguir, as células SingerId e SingerInfo das linhas
em que SingerId > 5 são validadas.
WITH s AS
(SELECT SingerId, SingerInfo FROM Singers WHERE SingerId > 5 FOR UPDATE)
SELECT * FROM s;
Uso em subconsultas
É possível usar a cláusula FOR UPDATE em uma consulta de nível externo que tenha uma ou mais
subconsultas. Os intervalos verificados pela consulta de nível superior e dentro de subconsultas são validados, exceto em subconsultas de expressão.
A consulta a seguir valida as células SingerId e SingerInfo para linhas
em que SingerId > 5.
(SELECT SingerId, SingerInfo FROM Singers WHERE SingerId > 5) AS t
FOR UPDATE;
A consulta a seguir não valida nenhuma célula na tabela Albums porque
está em uma subconsulta de expressão. As células SingerId e SingerInfo das
linhas retornadas pela subconsulta de expressão são validadas.
SELECT SingerId, SingerInfo
FROM Singers
WHERE SingerId = (SELECT SingerId FROM Albums WHERE MarketingBudget > 100000)
FOR UPDATE;
Usar para consultar visualizações
É possível usar a cláusula FOR UPDATE para consultar uma visualização, conforme mostrado no exemplo
a seguir:
CREATE VIEW SingerBio AS SELECT SingerId, FullName, SingerInfo FROM Singers;
SELECT * FROM SingerBio WHERE SingerId = 5 FOR UPDATE;
Não é possível usar a cláusula FOR UPDATE ao definir uma visualização.
Casos de uso não aceitos
Os seguintes casos de uso do FOR UPDATE não são compatíveis:
- Como um mecanismo de exclusão mútua para executar código fora do Spanner: não use o bloqueio no Spanner para garantir acesso exclusivo a um recurso fora do Spanner. O Spanner pode cancelar e repetir uma transação, seja explicitamente por meio do código do aplicativo ou implicitamente por meio do código do cliente, como o driver JDBC do Spanner. Para uma tentativa de transação que é confirmada, o Spanner mantém os bloqueios durante toda a tentativa, até o carimbo de data/hora de confirmação. Para uma tentativa que é cancelada, o Spanner libera os bloqueios quando cancela a transação, o que pode acontecer antes que o cliente receba o cancelamento. Como resultado, o código fora do Spanner que depende dos bloqueios pode ainda estar em execução depois que o Spanner os liberar.
- Em combinação com a dica
LOCK_SCANNED_RANGES: não é possível usar a cláusulaFOR UPDATEe a dicaLOCK_SCANNED_RANGESna mesma consulta, ou o Spanner vai retornar um erro. Para mais informações, consulte Comparação com a dicaLOCK_SCANNED_RANGES. - Em consultas de pesquisa de texto completo: não é possível usar a cláusula
FOR UPDATEem consultas que usam índices de pesquisa de texto completo. - Em transações somente leitura: a cláusula
FOR UPDATEsó é válida em consultas executadas em transações de leitura e gravação. - Em instruções DDL: não é possível usar a cláusula
FOR UPDATEem consultas em instruções DDL, que são armazenadas para execução posterior. Por exemplo, não é possível usar a cláusulaFOR UPDATEao definir uma visualização.
A seguir
- Saiba como usar a cláusula
FOR UPDATEno GoogleSQL e no PostgreSQL. - Saiba como usar
SELECT FOR UPDATEem isolamento serializável. - Saiba mais sobre a dica
LOCK_SCANNED_RANGES. - Saiba mais sobre o bloqueio no Spanner.