En esta página, se describe cómo establecer un tiempo de espera para las transacciones con las
bibliotecas cliente de Spanner. La transacción falla con un error DEADLINE_EXCEEDED si no puede finalizar dentro del valor de tiempo de espera determinado.
Si el error de tiempo de espera se produce durante la ejecución de la
solicitud Commit, es posible que la transacción se haya
confirmado.
Tiempos de espera de RPC y bucles de reintento de transacciones
Los tiempos de espera de RPC y de transacciones limitan diferentes alcances de trabajo:
- Un tiempo de espera de RPC limita el tiempo de ejecución de una sola solicitud, como una consulta, una lectura o
una solicitud
Commit. Un tiempo de espera de transacción que es más largo que un tiempo de espera de RPC no extiende el tiempo de espera de RPC. Para obtener más información, consulta Configura tiempos de espera y reintentos personalizados. - Un tiempo de espera de transacción limita el tiempo total que la biblioteca cliente dedica a ejecutar una transacción de lectura y escritura, incluido cada intento que realiza la biblioteca cliente después de que Spanner anula la transacción.
Cuando Spanner anula una transacción de lectura y escritura, la biblioteca cliente vuelve a ejecutar la función de transacción. Los tiempos de espera cortos de RPC no limitan el tiempo que la biblioteca cliente sigue reintentando una transacción anulada. Si no estableces un tiempo de espera de transacción, el comportamiento de reintento predeterminado dependerá de la biblioteca cliente:
- Java: El ejecutor de transacciones reintenta las transacciones anuladas durante un máximo de 24 horas, sin límite en la cantidad de intentos.
- Go: La biblioteca cliente reintenta las transacciones anuladas hasta que se confirma la transacción o hasta que el objeto
context.Contextque pasas a la transacción alcanza su fecha límite o se cancela. - Node.js: La biblioteca cliente deja de reintentar las transacciones anuladas después de
1 hora (
3600000milisegundos). Para cambiar este límite, configura el campotimeouten el objetoRunTransactionOptionsque pasas al métodorunTransactionorunTransactionAsync. - Python: La biblioteca cliente deja de reintentar las transacciones anuladas después de
30 segundos. Para cambiar este límite, pasa el argumento
timeout_secsal métodorun_in_transaction.
En las cargas de trabajo con alta contención de bloqueos, cada intento de reintento compite por los mismos bloqueos, por lo que un bucle de reintento largo puede aumentar los tiempos de espera de bloqueo para otras transacciones. Para limitar el tiempo total que puede ejecutarse una transacción, establece un tiempo de espera de transacción como se muestra en los ejemplos de esta página.
Establece un tiempo de espera para las transacciones
Puedes establecer un tiempo de espera de transacción con las bibliotecas cliente de Go, Java, Python y Node.js.
Go
Java
Node.js
Python
Establece un tiempo de espera para las transacciones asíncronas de Java
En el ejemplo de Java de esta página, se usa un objeto Context de gRPC con un plazo para establecer
el tiempo de espera de la transacción. El objeto Context de gRPC se adjunta al subproceso
actual.
Cuando ejecutas una transacción de forma asíncrona con el método AsyncRunner.runAsync(),
la biblioteca cliente ejecuta la transacción en el objeto Executor que
proporcionas. La biblioteca cliente no propaga el objeto Context del subproceso de llamada, incluida su fecha límite, a ese ejecutor. Como resultado, la transacción
se ejecuta sin el tiempo de espera y puede seguir reintentando los intentos anulados durante un máximo de
24 horas.
Para aplicar el tiempo de espera a una transacción asíncrona, realiza una de las siguientes acciones:
- Une el ejecutor llamando al método
Context.currentContextExecutor(executor)mientras el objetoContextque tiene la fecha límite esté activo y pasa el ejecutor unido al métodorunAsync(). - Usa la interfaz
AsyncTransactionManageroTransactionManageren lugar de la interfazAsyncRunner. Con un administrador de transacciones, escribes el bucle de reintento por tu cuenta y puedes dejar de reintentar cuando venza el tiempo de espera.