Cette page vous explique comment remplacer la configuration de délai avant expiration par défaut et configurer une règle de nouvelle tentative à l'aide des bibliothèques clientes Spanner.
Les bibliothèques clientes utilisent les paramètres de délai d'expiration et de stratégie de nouvelle tentative définis par défaut dans les fichiers de configuration suivants.
- spanner_grpc_service_config.json
- spanner_admin_instance_grpc_service_config.json
- spanner_admin_database_grpc_service_config.json
Dans les fichiers de configuration, le délai avant expiration par défaut pour les opérations qui prennent peu de temps, telles que CreateSession, est de 30 secondes. Les opérations plus longues, telles que les requêtes ou les lectures, ont un délai avant expiration par défaut de 3 600 secondes. Nous vous recommandons d'utiliser ces valeurs par défaut. Toutefois, vous pouvez définir un délai avant expiration ou une règle de nouvelle tentative personnalisés dans votre application si nécessaire.
Si vous décidez de modifier le délai avant expiration, définissez-le sur la durée réelle pendant laquelle l'application est configurée pour attendre le résultat.
Ne configurez pas de stratégie de nouvelle tentative plus agressive que celle par défaut, car un trop grand nombre de nouvelles tentatives pourrait surcharger le backend et limiter vos requêtes.
Une règle de nouvelle tentative est définie dans chaque extrait, avec les caractéristiques suivantes :
- Un délai d'attente initial, ou de départ, avant de relancer la requête
- atteindre le délai maximal.
- Multiplicateur à utiliser avec le temps d'attente précédent pour calculer le temps d'attente suivant, jusqu'à ce que la valeur maximale soit atteinte.
- Ensemble de codes d'erreur pour les opérations de nouvelle tentative.
Dans l'exemple suivant, un délai d'expiration de 60 secondes est défini pour l'opération donnée.
Si l'opération prend plus de temps que ce délai avant expiration, elle échoue avec une erreur DEADLINE_EXCEEDED.
Si l'opération échoue avec un code d'erreur UNAVAILABLE, par exemple en cas de problème réseau temporaire, l'opération est relancée. Le client attend 500 ms avant de lancer la première nouvelle tentative. Si la première tentative échoue, le client attend 1,5 * 500 ms = 750 ms avant de lancer la deuxième tentative. Ce délai avant nouvelle tentative continue d'augmenter jusqu'à ce que l'opération réussisse ou atteigne le délai maximal de 16 secondes. L'opération échoue avec une erreur DEADLINE_EXCEEDED si le temps total passé à essayer l'opération dépasse la valeur de délai d'expiration totale de 60 secondes.