En esta página, se describen las solicitudes de escritura por lotes de Spanner y cómo puedes usarlas para modificar tus datos de Spanner.
Puedes usar la escritura por lotes de Spanner para insertar, actualizar o borrar varias filas en tus tablas de Spanner. La escritura por lotes de Spanner admite escrituras de baja latencia sin una operación de lectura y devuelve respuestas a medida que se aplican las mutaciones en lotes. Para usar la escritura por lotes, agrupa las mutaciones relacionadas y todas las mutaciones de un grupo se confirman de forma atómica. Las mutaciones en los grupos se aplican en un orden no especificado y son independientes entre sí (no atómicas). Spanner no necesita esperar a que se apliquen todas las mutaciones antes de enviar una respuesta, lo que significa que la escritura por lotes permite fallas parciales. También puedes ejecutar varias escrituras por lotes a la vez. Para obtener más información, consulta Cómo usar la escritura por lotes.
Casos de uso
La escritura por lotes de Spanner es especialmente útil si deseas confirmar una gran cantidad de escrituras sin una operación de lectura, pero no necesitas una transacción atómica para todas tus mutaciones.
Si deseas procesar por lotes tus solicitudes de DML, usa DML por lotes para modificar tus datos de Spanner. Para obtener más información sobre las diferencias entre DML y mutaciones, consulta Comparación entre DML y mutaciones.
Para las solicitudes de mutación única, te recomendamos que uses una transacción de lectura y escritura con bloqueo.
Limitaciones
La escritura por lotes de Spanner tiene las siguientes limitaciones:
La escritura por lotes de Spanner no está disponible con laGoogle Cloud consola ni con Google Cloud CLI. Solo está disponible a través de las APIs de REST y RPC, y las bibliotecas cliente de Spanner.
No se admite la protección de reproducción con la escritura por lotes. Es posible que las mutaciones se apliquen más de una vez, y una mutación que se aplica más de una vez podría provocar un error. Por ejemplo, si se vuelve a ejecutar una mutación de inserción, es posible que se produzca un error de que ya existe, o bien, si usas claves basadas en marcas de tiempo generadas o de confirmación en la mutación, es posible que se agreguen filas adicionales a la tabla. Te recomendamos que estructures tus escrituras para que sean idempotentes y evitar este problema.
No puedes revertir una solicitud de escritura por lotes completada. Puedes cancelar una solicitud de escritura por lotes en curso. Si cancelas una escritura por lotes en curso, se revertirán las mutaciones en los grupos incompletos. Las mutaciones en los grupos completados se confirman en la base de datos.
El tamaño máximo de una solicitud de escritura por lotes es el mismo que el límite de una solicitud de confirmación. Para obtener más información, consulta Límites para crear, leer, actualizar y borrar datos.
Cómo usar la escritura por lotes
Para usar la escritura por lotes, debes tener el permiso spanner.databases.write
en la base de datos que deseas modificar. Puedes escribir mutaciones por lotes de forma no atómica en una sola llamada con una llamada de solicitud de la API de REST o de la API de RPC.
Debes agrupar los siguientes tipos de mutaciones cuando uses la escritura por lotes:
- Insertar filas con el mismo prefijo de clave primaria en las tablas superior y secundaria
- Insertar filas en tablas con una relación de clave externa entre ellas
- Otros tipos de mutaciones relacionadas según el esquema de tu base de datos y la lógica de la aplicación
También puedes escribir en lotes con las bibliotecas cliente de Spanner.
En el siguiente ejemplo de código, se actualiza la tabla Singers
con filas nuevas.
Bibliotecas cliente
Java
Go
Nodo
Python
C++
¿Qué sigue?
- Obtén más información sobre las transacciones de Spanner.