Usar SELECT FOR UPDATE no isolamento de leitura repetível

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áusula FOR UPDATE e a dica LOCK_SCANNED_RANGES na mesma consulta, ou o Spanner vai retornar um erro. Para mais informações, consulte Comparação com a dica LOCK_SCANNED_RANGES.
  • Em consultas de pesquisa de texto completo: não é possível usar a cláusula FOR UPDATE em consultas que usam índices de pesquisa de texto completo.
  • Em transações somente leitura: a cláusula FOR UPDATE só é 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 UPDATE em consultas em instruções DDL, que são armazenadas para execução posterior. Por exemplo, não é possível usar a cláusula FOR UPDATE ao definir uma visualização.

A seguir