En esta página, se describen las lecturas dirigidas de Spanner y cómo usarlas.
Las lecturas dirigidas en Spanner proporcionan la flexibilidad para enrutar transacciones de solo lectura y lecturas únicas a un tipo o región de réplica específico dentro de una configuración de instancia birregional o multirregional o una configuración regional personalizada con regiones de solo lectura opcionales.
Beneficios
Las lecturas dirigidas ofrecen los siguientes beneficios:
- Proporcionan más control sobre las cargas de trabajo de balanceo de cargas en varias regiones para lograr un uso más uniforme de la CPU y evitar el aprovisionamiento excesivo de instancias de Spanner.
- Permiten el aislamiento de la carga de trabajo. Puedes dirigir tus cargas de trabajo de análisis y lecturas de flujos de cambios a réplicas específicas de Spanner para minimizar el impacto en las cargas de trabajo transaccionales que se ejecutan en la misma base de datos de Spanner.
Operaciones de consulta admitidas
| Operaciones de consulta | ¿Se admiten las lecturas dirigidas? |
|---|---|
| Lectura inactiva | Sí |
| Lectura sólida | Sí |
| Transacción de lectura o escritura | No |
Las lecturas dirigidas no se admiten para las transacciones de lectura y escritura
ni para los tipos de DML particionados de actualizaciones masivas. Esto se debe a que las transacciones de lectura y escritura deben procesarse en la región líder. Si se usan lecturas dirigidas en una transacción de lectura y escritura, la transacción falla con un error BAD_REQUEST.
Limitaciones
Las lecturas dirigidas de Spanner tienen las siguientes limitaciones:
- Solo puedes usar lecturas dirigidas en una instancia de Spanner que se encuentre en una configuración de instancia birregional o configuración de instancia multirregional o en una configuración regional personalizada con regiones de solo lectura opcionales.
- No puedes usar lecturas dirigidas con solicitudes de lectura y escritura porque la región líder siempre entrega las solicitudes de escritura.
- No puedes usar lecturas dirigidas en la Google Cloud consola o Google Cloud CLI. Está disponible con las APIs de REST y RPC, y las bibliotecas cliente de Spanner.
- Puedes especificar un máximo de 10 réplicas en una sola lectura dirigida.
Antes de comenzar
Ten en cuenta lo siguiente antes de usar las lecturas dirigidas:
- La aplicación puede incurrir en una latencia adicional si enrutas las lecturas a una réplica o región que no sea la más cercana a la aplicación.
- Puedes enrutar el tráfico según lo siguiente:
- Nombre de la región (por ejemplo,
us-central1). - Tipo de réplica (valores posibles:
READ_ONLYyREAD_WRITE).
- Nombre de la región (por ejemplo,
- La opción de conmutación por error automática en las lecturas dirigidas está habilitada de forma predeterminada. Cuando la opción de conmutación por error automática está habilitada y todas las réplicas especificadas no están disponibles o no son correctas, Spanner enruta las solicitudes a una réplica fuera de la lista
includeReplicas. Si inhabilitas la opción de conmutación por error automática y todas las réplicas especificadas no están disponibles o no son correctas, falla la solicitud de lecturas dirigidas.
Parámetros de lecturas dirigidas
Si usas la API de REST o RPC para realizar lecturas dirigidas, debes definir estos campos en el parámetro directedReadOptions. Solo puedes incluir uno de includeReplicas o excludeReplicas, no ambos.
includeReplicas: Contiene un conjunto repetido dereplicaSelections. Esta lista indica el orden en el que se deben considerar las lecturas dirigidas a regiones o tipos de réplicas específicos. Puedes especificar un máximo de 10includeReplicas.replicaSelections: Consta de lalocationo eltypede réplica que entrega la solicitud de lecturas dirigidas. Si usasincludeReplicas, debes proporcionar al menos uno de los siguientes campos:location: La ubicación que entrega la solicitud de lecturas dirigidas. La ubicación debe ser una de las regiones dentro de la configuración birregional o multirregional de tu base de datos. Si la ubicación no es una de las regiones dentro de la configuración birregional o multirregional de tu base de datos, las solicitudes no se enrutarán como se espera. En cambio, se entregan en la región más cercana. Por ejemplo, puedes dirigir las lecturas a la ubicaciónus-central1en una base de datos en la configuración de instancia multirregionalnam6.También puedes especificar el
locationparámetro con unleaderonon-leaderliteral de cadena. Si ingresas el valorleader, Spanner dirige tus solicitudes a la réplica líder de la base de datos. Por el contrario, si ingresas el valornon-leader, Spanner cumple con la solicitud en la réplica no líder más cercana.type: El tipo de réplica que entrega la solicitud de lecturas dirigidas. Entre los tipos posibles, se incluyenREAD_WRITEyREAD_ONLY.
autoFailoverDisabled: De forma predeterminada, se establece enFalse, lo que significa que la conmutación por error automática está habilitada. Cuando la opción de conmutación por error automática está habilitada y todas las réplicas especificadas no están disponibles o no son correctas, Spanner enruta las solicitudes a una réplica fuera de la listaincludeReplicas. Si inhabilitas la opción de conmutación por error automática y todas las réplicas especificadas no están disponibles o no son correctas, falla la solicitud de lecturas dirigidas. Los valores posibles incluyenTRUEpara inhabilitado yFALSEpara habilitado.
excludeReplicas: Contiene un conjunto repetido dereplicaSelectionsque se excluye de la entrega de solicitudes. Spanner no enruta las solicitudes a las réplicas de esta lista.replicaSelections: La ubicación o el tipo de réplica que se excluye de la entrega de la solicitud de lecturas dirigidas. Si usasexcludeReplicas, debes proporcionar al menos uno de los siguientes campos:location: La ubicación que se excluye de la entrega de la solicitud de lecturas dirigidas.type: El tipo de réplica que se excluye de la entrega de la solicitud de lecturas dirigidas. Entre los tipos posibles, se incluyenREAD_WRITEyREAD_ONLY.
Para ver un ejemplo de cómo se ve un cuerpo de solicitud de REST, haz clic en la pestaña REST en la sección Usa lecturas dirigidas.
Usa lecturas dirigidas
Puedes usar las bibliotecas cliente de Spanner y las APIs de REST y RPC para realizar lecturas dirigidas.
Bibliotecas cliente
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
REST
Puedes usar las siguientes APIs de REST para realizar lecturas dirigidas:
Por ejemplo, para realizar lecturas dirigidas en us-central1 con executeSQL, haz lo siguiente:
Haz clic en
projects.instances.databases.sessions.executeSql.Para sesión, ingresa lo siguiente:
projects/<VAR>PROJECT-ID</VAR>/instances/<VAR>INSTANCE-ID</VAR>/databases/<VAR>DATABASE-ID</VAR>/sessions/<VAR>SESSION-ID</VAR>Reemplaza lo siguiente:
- PROJECT-ID: Es el ID del proyecto.
- INSTANCE-ID: Es el ID de la instancia.
- DATABASE-ID: Es el ID de la base de datos.
- SESSION-ID: Es el ID de la sesión.
Recibes el valor
SESSION-IDcuando creas una sesión.
En el cuerpo de la solicitud, usa lo siguiente:
{ "directedReadOptions": { "includeReplicas": { "replicaSelections": [ { "location": "us-central1", } ] } }, "sql": "SELECT SingerId, AlbumId, AlbumTitle FROM Albums" }Haz clic en Ejecutar. En la respuesta, se muestran los resultados de la consulta.
RPC
Puedes usar las siguientes APIs de RPC para realizar lecturas dirigidas:
Supervisión
Spanner proporciona una métrica de latencia para ayudarte a supervisar las actividades de lecturas dirigidas en tus instancias. La métrica está disponible en Cloud Monitoring.
spanner.googleapis.com/api/read_request_latencies_by_serving_location
Puedes filtrar esta métrica con los campos /serving_location o /is_directed_read. El campo /serving location indica la ubicación del servidor de Spanner desde el que se entrega la solicitud. El campo /is_directed_read indica si la opción de lecturas dirigidas está habilitada.
Para obtener una lista completa de las métricas disponibles, consulta la lista de métricas de Spanner.
¿Qué sigue?
- Obtén información para realizar lecturas fuera de las transacciones.