Cette page explique comment définir un délai avant expiration pour les transactions à l'aide des bibliothèques clientes Spanner. La transaction échoue avec une erreur DEADLINE_EXCEEDED si elle ne peut pas se terminer dans le délai imparti.
Si l'erreur de délai avant expiration se produit lors de l'exécution de la requête Commit, il est toujours possible que la transaction ait été validée.
Délais d'expiration RPC et boucles de nouvelles tentatives de transaction
Les délais avant expiration des RPC et des transactions limitent différents champs d'application :
- Un délai avant expiration RPC limite la durée d'exécution d'une seule requête, telle qu'une requête, une lecture ou une requête
Commit. Un délai avant expiration de transaction plus long qu'un délai avant expiration RPC ne prolonge pas le délai avant expiration RPC. Pour en savoir plus, consultez Configurer des délais avant expiration et des nouvelles tentatives personnalisés. - Un délai avant expiration de transaction limite la durée totale que la bibliothèque cliente passe à exécuter une transaction en lecture-écriture, y compris chaque tentative effectuée par la bibliothèque cliente après l'abandon de la transaction par Spanner.
Lorsque Spanner annule une transaction en lecture-écriture, la bibliothèque cliente réexécute la fonction de transaction. Les délais avant expiration courts des RPC ne limitent pas la durée pendant laquelle la bibliothèque cliente continue de relancer une transaction abandonnée. Si vous ne définissez pas de délai avant expiration de la transaction, le comportement de nouvelle tentative par défaut dépend de la bibliothèque cliente :
- Java : l'exécuteur de transactions relance les transactions abandonnées pendant 24 heures maximum, sans limite du nombre de tentatives.
- Go : la bibliothèque cliente relance les transactions abandonnées jusqu'à ce que la transaction soit validée, ou jusqu'à ce que l'objet
context.Contextque vous transmettez à la transaction atteigne son échéance ou soit annulé. - Node.js : la bibliothèque cliente arrête de relancer les transactions abandonnées après une heure (
3600000millisecondes). Pour modifier cette limite, définissez le champtimeoutdans l'objetRunTransactionOptionsque vous transmettez à la méthoderunTransactionourunTransactionAsync. - Python : la bibliothèque cliente arrête de relancer les transactions abandonnées après 30 secondes. Pour modifier cette limite, transmettez l'argument
timeout_secsà la méthoderun_in_transaction.
Dans les charges de travail présentant un conflit de verrouillage élevé, chaque nouvelle tentative est en concurrence pour les mêmes verrous. Par conséquent, une longue boucle de nouvelles tentatives peut augmenter les temps d'attente de verrouillage pour les autres transactions. Pour limiter la durée totale d'exécution d'une transaction, définissez un délai avant expiration de la transaction, comme indiqué dans les exemples de cette page.
Définir un délai avant expiration de transaction
Vous pouvez définir un délai avant expiration des transactions à l'aide des bibliothèques clientes Go, Java, Python et Node.js.
Go
Java
Node.js
Python
Définir un délai avant expiration pour les transactions Java asynchrones
L'exemple Java de cette page utilise un objet gRPC Context avec un délai avant expiration pour définir le délai avant expiration de la transaction. L'objet gRPC Context est associé au thread actuel.
Lorsque vous exécutez une transaction de manière asynchrone à l'aide de la méthode AsyncRunner.runAsync(), la bibliothèque cliente exécute la transaction sur l'objet Executor que vous fournissez. La bibliothèque cliente ne propage pas l'objet Context du thread appelant, y compris son délai avant expiration, vers cet exécuteur. Par conséquent, la transaction s'exécute sans délai avant expiration et peut continuer à relancer les tentatives abandonnées pendant 24 heures au maximum.
Pour appliquer le délai avant expiration à une transaction asynchrone, effectuez l'une des opérations suivantes :
- Encapsulez l'exécuteur en appelant la méthode
Context.currentContextExecutor(executor)pendant que l'objetContextqui a le délai avant expiration est actif, puis transmettez l'exécuteur encapsulé à la méthoderunAsync(). - Utilisez l'interface
AsyncTransactionManagerouTransactionManagerau lieu de l'interfaceAsyncRunner. Avec un gestionnaire de transactions, vous écrivez vous-même la boucle de nouvelle tentative et pouvez arrêter les nouvelles tentatives lorsque le délai d'expiration est écoulé.