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 de réplica o región específicos dentro de una configuración de instancia birregional o multirregional, o bien una configuración regional personalizada con regiones de solo lectura opcionales.
Beneficios
Las lecturas dirigidas ofrecen los siguientes beneficios:
- Proporcionar más control sobre las cargas de trabajo de balanceo de cargas en varias regiones para lograr un uso de CPU más uniforme y evitar el aprovisionamiento excesivo de instancias de Spanner
- Habilita el aislamiento de la carga de trabajo. Puedes dirigir tus cargas de trabajo de análisis y las lecturas de transmisiones 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 y escritura | No |
Las lecturas dirigidas no se admiten para las transacciones de lectura y escritura ni los tipos de DML particionado 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, una configuración de instancia multirregional o una configuración regional personalizada con regiones opcionales de solo lectura.
- No puedes usar lecturas dirigidas con solicitudes de lectura y escritura porque las solicitudes de escritura siempre se entregan desde la región líder.
- No puedes usar lecturas dirigidas en la consola de Google Cloud ni en Google Cloud CLI. Está disponible a través de 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:
- Es posible que la aplicación incurra en 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 los siguientes criterios:
- Nombre de la región (por ejemplo,
us-central1
) - Tipo de réplica (los valores posibles son
READ_ONLY
yREAD_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 están en buen estado, Spanner enruta las solicitudes a una réplica fuera de la lista de
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 están en buen estado, la solicitud de lecturas dirigidas fallará.
Parámetros de lecturas dirigidas
Si usas la API de REST o de RPC para realizar lecturas dirigidas, debes definir estos campos en el parámetro directedReadOptions
. Solo puedes incluir uno de los parámetros 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 dellocation
o la réplicatype
que procesa la solicitud de lecturas dirigidas. Si usasincludeReplicas
, debes proporcionar, al menos, uno de los siguientes campos:location
: Es la ubicación que entrega la solicitud de lecturas dirigidas. La ubicación debe ser una de las regiones dentro de la configuración de región doble o múltiple 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 según lo previsto. En cambio, se publican desde la región más cercana. Por ejemplo, puedes dirigir las lecturas a la ubicaciónus-central1
en una base de datos de la configuración de instancia multirregionalnam6
.También puedes especificar el parámetro
location
con un literal de cadenaleader
onon-leader
. Si ingresas el valor deleader
, Spanner dirige tus solicitudes a la réplica principal de la base de datos. Por el contrario, si ingresas el valor denon-leader
, Spanner cumple con la solicitud en la réplica no líder más cercana.type
: Es el tipo de réplica que procesa la solicitud de lecturas dirigidas. Los tipos posibles incluyenREAD_WRITE
yREAD_ONLY
.
autoFailoverDisabled
: De forma predeterminada, este parámetro se establece enFalse
, lo que significa que la conmutación por error automática está habilitada. Cuando se habilita la opción de conmutación por error automática y todas las réplicas especificadas no están disponibles o están en mal estado, Spanner enruta las solicitudes a una réplica fuera de la lista deincludeReplicas
. Si inhabilitas la opción de conmutación por error automática y todas las réplicas especificadas no están disponibles o no están en buen estado, la solicitud de lecturas dirigidas fallará. Los valores posibles incluyenTRUE
para inhabilitado yFALSE
para habilitado.
excludeReplicas
: Contiene un conjunto repetido dereplicaSelections
que se excluyen de las solicitudes de publicación. Spanner no enruta las solicitudes a las réplicas de esta lista.replicaSelections
: Es la ubicación o el tipo de réplica que se excluye de la publicación de la solicitud de lecturas dirigidas. Si usasexcludeReplicas
, debes proporcionar, al menos, uno de los siguientes campos:location
: Es la ubicación que se excluye de la publicación de la solicitud de lecturas dirigidas.type
: Es el tipo de réplica que se excluye de la publicación de la solicitud de lecturas dirigidas. Los tipos posibles incluyenREAD_WRITE
yREAD_ONLY
.
Para ver un ejemplo de cómo se ve el cuerpo de una solicitud de REST, haz clic en la pestaña REST en la sección Usa lecturas dirigidas.
Cómo usar las lecturas dirigidas
Puedes usar las bibliotecas cliente y las APIs de REST y RPC de Spanner 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
.En 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: El ID del proyecto.
- INSTANCE-ID: El ID de la instancia.
- DATABASE-ID: Es el ID de la base de datos.
- SESSION-ID: Es el ID de la sesión.
Recibirás el valor de
SESSION-ID
cuando crees 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 lectura 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.