Usa SELECT FOR UPDATE en el aislamiento de lectura repetible

En esta página, se describe cómo usar la cláusula FOR UPDATE en el aislamiento de lectura repetible.

En el aislamiento de lectura repetible, si la cláusula FOR UPDATE adquiere bloqueos depende del modo de control de simultaneidad. Para obtener más información, consulta Por qué usar la cláusula FOR UPDATE.

Para obtener más información sobre los bloqueos en FOR UPDATE, consulta Usa SELECT FOR UPDATE en el aislamiento serializable.

Para aprender a usar la cláusula FOR UPDATE, consulta las guías de referencia de GoogleSQL y PostgreSQL para FOR UPDATE.

Por qué usar la cláusula FOR UPDATE

Cuando una transacción se ejecuta con aislamiento de lectura repetible, los datos que consulta la sentencia SELECT siempre se devuelven en la marca de tiempo de la instantánea establecida para la transacción. Si la transacción realiza actualizaciones basadas en los datos consultados, puede haber problemas de corrección si una transacción simultánea también actualiza los datos consultados. Para obtener más información, consulta Conflictos de lectura y escritura, y corrección.

Para garantizar que los datos consultados sigan siendo válidos en el momento de la confirmación, puedes usar la cláusula FOR UPDATE con aislamiento de lectura repetible. El uso de FOR UPDATE evita los conflictos de lectura y escritura en los que otra transacción actualiza los datos después de que se leen:

  • Con el control de simultaneidad optimista (el predeterminado), Spanner valida que los rangos analizados no se hayan modificado antes de confirmar. Si se detecta un conflicto, Spanner anula la transacción.
  • Con el control de simultaneidad pesimista, Spanner adquiere bloqueos exclusivos durante la ejecución de la lectura, lo que evita que las transacciones simultáneas modifiquen los datos bloqueados hasta que se confirme la transacción.

Sintaxis de las consultas

En esta sección, se proporciona orientación sobre la sintaxis de las consultas cuando se usa la cláusula FOR UPDATE.

El uso más común es en una sentencia SELECT de nivel superior. Por ejemplo:

SELECT SingerId, SingerInfo
FROM Singers WHERE SingerID = 5
FOR UPDATE;

La cláusula FOR UPDATE garantiza que los datos consultados por la sentencia SELECT y SingerID = 5 sigan siendo válidos cuando se confirme la transacción, lo que evita problemas de corrección que podrían surgir si una transacción simultánea actualiza los datos consultados.

Uso en sentencias WITH

La cláusula FOR UPDATE no verifica los rangos analizados dentro de la declaración WITH cuando especificas FOR UPDATE en la consulta de nivel externo de la declaración WITH.

En la siguiente consulta, no se valida ningún rango analizado porque el FOR UPDATE no se propaga a la consulta de expresiones de tabla comunes (CTE).

WITH s AS (SELECT SingerId, SingerInfo FROM Singers WHERE SingerID > 5)
SELECT * FROM s
FOR UPDATE;

Si se especifica la cláusula FOR UPDATE en la consulta de CTE, se valida el rango analizado de la consulta de CTE.

En el siguiente ejemplo, se validan las celdas SingerId y SingerInfo de las filas en las que SingerId > 5.

WITH s AS
  (SELECT SingerId, SingerInfo FROM Singers WHERE SingerId > 5 FOR UPDATE)
SELECT * FROM s;

Usa en subconsultas

Puedes usar la cláusula FOR UPDATE en una consulta de nivel externo que tenga una o más subconsultas. Se validan los rangos analizados por la consulta de nivel superior y dentro de las subconsultas, excepto en las subconsultas de expresión.

La siguiente consulta valida las celdas SingerId y SingerInfo para las filas en las que SingerId > 5.

(SELECT SingerId, SingerInfo FROM Singers WHERE SingerId > 5) AS t
FOR UPDATE;

La siguiente consulta no valida ninguna celda de la tabla Albums porque está dentro de una subconsulta de expresión. Se validan las celdas SingerId y SingerInfo de las filas que devuelve la subconsulta de expresión.

SELECT SingerId, SingerInfo
FROM Singers
WHERE SingerId = (SELECT SingerId FROM Albums WHERE MarketingBudget > 100000)
FOR UPDATE;

Se usa para consultar vistas.

Puedes usar la cláusula FOR UPDATE para consultar una vista, como se muestra en el siguiente ejemplo:

CREATE VIEW SingerBio AS SELECT SingerId, FullName, SingerInfo FROM Singers;

SELECT * FROM SingerBio WHERE SingerId = 5 FOR UPDATE;

No puedes usar la cláusula FOR UPDATE cuando defines una vista.

Casos de uso no admitidos

No se admiten los siguientes casos de uso de FOR UPDATE:

  • Como mecanismo de exclusión mutua para ejecutar código fuera de Spanner: No uses el bloqueo en Spanner para garantizar el acceso exclusivo a un recurso fuera de Spanner. Spanner puede anular y reintentar una transacción, ya sea de forma explícita a través del código de la aplicación o de forma implícita a través del código del cliente, como el controlador de JDBC de Spanner. En el caso de un intento de transacción que se confirma correctamente, Spanner mantiene los bloqueos durante todo el intento, hasta la marca de tiempo de confirmación. En el caso de un intento que se anula, Spanner libera los bloqueos cuando anula la transacción, lo que puede ocurrir antes de que el cliente reciba la anulación. Como resultado, es posible que el código fuera de Spanner que depende de los bloqueos siga ejecutándose después de que Spanner los libere.
  • En combinación con la sugerencia LOCK_SCANNED_RANGES: No puedes usar la cláusula FOR UPDATE y la sugerencia LOCK_SCANNED_RANGES en la misma consulta, o Spanner mostrará un error. Para obtener más información, consulta Comparación con la sugerencia LOCK_SCANNED_RANGES.
  • En las consultas de búsqueda en el texto completo: No puedes usar la cláusula FOR UPDATE en las consultas que usan índices de búsqueda en el texto completo.
  • En transacciones de solo lectura: La cláusula FOR UPDATE solo es válida en las consultas que se ejecutan dentro de transacciones de lectura y escritura.
  • En las declaraciones de DDL: No puedes usar la cláusula FOR UPDATE en las consultas dentro de las declaraciones de DDL, que se almacenan para su ejecución posterior. Por ejemplo, no puedes usar la cláusula FOR UPDATE cuando defines una vista.

Pasos siguientes