Questa pagina mostra come eseguire l'override della configurazione di timeout predefinita e configurare una policy di ripetizione utilizzando le librerie client di Spanner.
Le librerie client utilizzano le impostazioni predefinite delle policy di timeout e di ripetizione dei tentativi, definite nei seguenti file di configurazione.
- spanner_grpc_service_config.json
- spanner_admin_instance_grpc_service_config.json
- spanner_admin_database_grpc_service_config.json
Nei file di configurazione, il timeout predefinito per le operazioni che richiedono poco tempo, come CreateSession, è di 30 secondi. Le operazioni più lunghe, come query o letture, hanno un timeout predefinito di 3600 secondi. Ti consigliamo di utilizzare queste impostazioni predefinite. Tuttavia, se necessario, puoi impostare un criterio di timeout o di nuovo tentativo personalizzato nella tua applicazione.
Se decidi di modificare il timeout, impostalo sul tempo effettivo che l'applicazione è configurata per attendere il risultato.
Non configurare una policy di ripetizione dei tentativi più aggressiva di quella predefinita, perché un numero eccessivo di tentativi potrebbe sovraccaricare il backend e limitare le richieste.
In ogni snippet è definita una policy di ripetizione con le seguenti caratteristiche:
- La durata del tempo di attesa iniziale prima di riprovare la richiesta.
- Un ritardo massimo.
- Un moltiplicatore da utilizzare con il tempo di attesa precedente per calcolare il tempo di attesa successivo, fino al raggiungimento del valore massimo.
- Un insieme di codici di errore per le operazioni di nuovo tentativo.
Nell'esempio seguente, viene impostato un timeout di 60 secondi per l'operazione specificata.
Se l'operazione richiede più tempo di questo timeout, non va a buon fine e viene restituito un errore DEADLINE_EXCEEDED.
Se l'operazione non va a buon fine con un codice di errore UNAVAILABLE, ad esempio se si verifica un problema di rete temporaneo, l'operazione viene ripetuta. Il client attende 500 ms prima di avviare il primo tentativo di ripetizione. Se il primo tentativo non va a buon fine, il client attende 1,5 * 500 ms = 750 ms prima di avviare il secondo tentativo. Questo ritardo dei nuovi tentativi continua ad aumentare finché l'operazione non va a buon fine o non raggiunge il ritardo massimo di 16 secondi. L'operazione non riesce e viene visualizzato un errore DEADLINE_EXCEEDED se il tempo totale impiegato per provare l'operazione supera il valore di timeout totale di 60 secondi.