Utiliser SELECT FOR UPDATE dans l'isolation de lecture reproductible

Cette page explique comment utiliser la clause FOR UPDATE dans l'isolation de lecture reproductible.

Dans l'isolation de lecture reproductible, l'acquisition de verrous par la clause FOR UPDATE dépend du mode de contrôle de simultanéité. Pour en savoir plus, consultez Pourquoi utiliser la clause FOR UPDATE.

Pour en savoir plus sur les verrous dans FOR UPDATE, consultez Utiliser SELECT FOR UPDATE dans l'isolation sérialisable.

Pour savoir comment utiliser la clause FOR UPDATE, consultez les guides de référence GoogleSQL et PostgreSQL sur FOR UPDATE.

Pourquoi utiliser la clause FOR UPDATE ?

Lorsqu'une transaction s'exécute avec une isolation de lecture reproductible, les données interrogées par l'instruction SELECT sont toujours renvoyées au code temporel de l'instantané établi pour la transaction. Si la transaction effectue ensuite des mises à jour en fonction des données interrogées, des problèmes d'exactitude peuvent survenir si une transaction simultanée met également à jour les données interrogées. Pour en savoir plus, consultez Conflits de lecture-écriture et exactitude.

Pour vous assurer que les données interrogées restent valides au moment du commit, vous pouvez utiliser la clause FOR UPDATE avec l'isolation de lecture reproductible. L'utilisation de FOR UPDATE évite les conflits de lecture/écriture lorsqu'une autre transaction met à jour les données après leur lecture :

  • Avec le contrôle de simultanéité optimiste (par défaut), Spanner vérifie que les plages analysées n'ont pas été modifiées avant de valider. Si un conflit est détecté, Spanner annule la transaction.
  • Avec le contrôle de simultanéité pessimiste, Spanner acquiert des verrous exclusifs pendant l'exécution de la lecture, ce qui empêche les transactions simultanées de modifier les données verrouillées jusqu'à ce que la transaction soit validée.

Syntaxe des requêtes

Cette section fournit des conseils sur la syntaxe des requêtes lorsque vous utilisez la clause FOR UPDATE.

L'utilisation la plus courante se fait dans une instruction SELECT de premier niveau. Exemple :

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

La clause FOR UPDATE garantit que les données interrogées par l'instruction SELECT et SingerID = 5 sont toujours valides lorsque la transaction est validée, ce qui évite les problèmes d'exactitude qui pourraient survenir si une transaction simultanée met à jour les données interrogées.

Utilisation dans les instructions WITH

La clause FOR UPDATE ne vérifie pas les plages analysées dans l'instruction WITH lorsque vous spécifiez FOR UPDATE dans la requête de niveau externe de l'instruction WITH.

Dans la requête suivante, aucune plage analysée n'est validée, car FOR UPDATE n'est pas propagé à la requête d'expression de table commune (CTE).

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

Si la clause FOR UPDATE est spécifiée dans la requête CTE, la plage analysée de la requête CTE est validée.

Dans l'exemple suivant, les cellules SingerId et SingerInfo des lignes où SingerId > 5 sont validées.

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

Utilisation dans les sous-requêtes

Vous pouvez utiliser la clause FOR UPDATE dans une requête de niveau externe comportant une ou plusieurs sous-requêtes. Les plages analysées par la requête de niveau supérieur et dans les sous-requêtes sont validées, sauf dans les sous-requêtes d'expression.

La requête suivante valide les cellules SingerId et SingerInfo pour les lignes où SingerId > 5.

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

La requête suivante ne valide aucune cellule de la table Albums, car elle se trouve dans une sous-requête d'expression. Les cellules SingerId et SingerInfo des lignes renvoyées par la sous-requête d'expression sont validées.

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

Utiliser pour interroger des vues

Vous pouvez utiliser la clause FOR UPDATE pour interroger une vue, comme illustré dans l'exemple suivant :

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

SELECT * FROM SingerBio WHERE SingerId = 5 FOR UPDATE;

Vous ne pouvez pas utiliser la clause FOR UPDATE lors de la définition d'une vue.

Cas d'utilisation non compatibles

Les cas d'utilisation FOR UPDATE suivants ne sont pas acceptés :

  • En tant que mécanisme d'exclusion mutuelle pour l'exécution de code en dehors de Spanner : n'utilisez pas le verrouillage dans Spanner pour garantir un accès exclusif à une ressource en dehors de Spanner. Spanner peut annuler une transaction et la relancer, soit explicitement via le code de l'application, soit implicitement via le code client, tel que le pilote JDBC Spanner. Pour une tentative de transaction qui est validée, Spanner conserve les verrous pendant toute la durée de la tentative, jusqu'au code temporel de commit. Pour une tentative qui est abandonnée, Spanner libère les verrous lorsqu'il abandonne la transaction, ce qui peut se produire avant que votre client ne reçoive l'abandon. Par conséquent, le code en dehors de Spanner qui repose sur les verrous peut toujours s'exécuter après que Spanner les a libérés.
  • En combinaison avec l'indice LOCK_SCANNED_RANGES : vous ne pouvez pas utiliser à la fois la clause FOR UPDATE et l'indice LOCK_SCANNED_RANGES dans la même requête, sinon Spanner renvoie une erreur. Pour en savoir plus, consultez Comparaison avec l'indice LOCK_SCANNED_RANGES.
  • Dans les requêtes de recherche en texte intégral : vous ne pouvez pas utiliser la clause FOR UPDATE dans les requêtes utilisant des index de recherche en texte intégral.
  • Dans les transactions en lecture seule : la clause FOR UPDATE n'est valide que dans les requêtes exécutées dans des transactions en lecture-écriture.
  • Dans les instructions LDD : vous ne pouvez pas utiliser la clause FOR UPDATE dans les requêtes des instructions LDD, qui sont stockées pour une exécution ultérieure. Par exemple, vous ne pouvez pas utiliser la clause FOR UPDATE lorsque vous définissez une vue.

Étape suivante