Extremos regionales

En esta página, se describen los extremos regionales de Cloud Spanner. Puedes usar un extremo de servicio global o regional para realizar solicitudes a Spanner. Usa un extremo regional para aplicar la restricción regional y asegurarte de que los datos se almacenen y procesen dentro de la misma región.

Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. Spanner tiene extremos globales y regionales.

Usa el extremo global si no tienes requisitos de restricción regional estrictos. Aunque los datos se almacenan dentro de la región seleccionada, en casos excepcionales, los datos pueden procesarse fuera de la región. El extremo global de Spanner es spanner.googleapis.com. El extremo predeterminado de la API accede al extremo global.

Un extremo regional aplica restricciones regionales. Los datos se almacenan y procesan en la misma región. Los extremos regionales para Spanner garantizan y garantizan que los datos almacenados y procesados estén restringidos a la configuración de instancias regional de Spanner donde reside la base de datos. Usa extremos regionales si la ubicación de tus datos debe restringirse y controlarse para cumplir con los requisitos normativos. No puedes usar un extremo regional para acceder a los recursos que pertenecen a una configuración de instancia diferente. Debes crear una instancia en la configuración de la instancia regional antes de poder usar el extremo regional para esa configuración.

Los extremos regionales de Spanner están disponibles en todas las configuraciones de instancias regionales. No están disponibles en las configuraciones de instancias multirregionales. Las políticas de almacenamiento subyacentes de Spanner no cambian sin importar el extremo que uses.

Seguridad y cumplimiento

El beneficio de usar un extremo regional de Spanner en lugar de un extremo global es que el extremo regional proporciona aislamiento y protección regionales para cumplir con los requisitos normativos, de seguridad y de cumplimiento.

Solo debes usar extremos regionales que pertenezcan a esa configuración de instancias regional. Por ejemplo, no puedes usar us-west1-spanner.googleapis.com para entregar solicitudes si la instancia a la que accedes pertenece a la configuración de la instancia regional us-central1. La solicitud se rechazará con un error InvalidRegionalRequest.

Limitaciones

No puedes acceder a una configuración de instancias multirregional con un extremo regional. Debes usar el extremo global para acceder a la configuración de las instancias multirregionales. Por ejemplo, si tienes una instancia en la configuración de instancias multirregión nam7, que tiene us-central1 como una de sus ubicaciones de réplica, no puedes usar el extremo regional us-central1-spanner.googleapis.com para enviar solicitudes a tu instancia en nam7.

Si tienes solicitudes activas que usan extremos regionales en cualquiera de los recursos de la instancia, el traslado de la instancia afecta a todas las solicitudes que usan el extremo regional porque la aplicación regional bloquea el acceso a las instancias entre regiones. Las solicitudes que usan un extremo global no se ven afectadas.

Semántica de los extremos regionales

Los nombres de los extremos regionales de Spanner siguen la misma convención de nombres que los nombres de la configuración de las instancias regionales. El extremo regional sigue el formato <REGION>-spanner.googleapis.com. Por ejemplo, el nombre de la configuración de la instancia regional y el nombre del extremo regional de Iowa son us-central1. En este caso, el extremo regional es us-central1-spanner.googleapis.com. Para obtener una lista de todas las opciones de configuración de instancias regionales disponibles, consulta Configuraciones regionales.

cómo especificar un extremo regional

Puedes especificar un extremo regional de Spanner que use Google Cloud CLI y las solicitudes de la API de REST o RPC.

gcloud

Para especificar un extremo regional y anular el extremo global, ejecuta el siguiente comando:

gcloud config set api_endpoint_overrides/spanner https://REGION-spanner.googleapis.com/

Ingresa el siguiente valor:

REGION
La región para la que se configura un extremo regional. Por ejemplo, us-central1 o europe-west1.

Por ejemplo, para configurar el extremo regional como us-central1, ejecuta el siguiente comando:

gcloud config set api_endpoint_overrides/spanner https://us-central1-spanner.googleapis.com/

Para volver a configurar un extremo regional en el extremo global, ejecuta el siguiente comando:

gcloud config unset api_endpoint_overrides/spanner

API de REST

El extremo predeterminado de la API accede al extremo global. Para usar un extremo regional, configura el extremo con la dirección del extremo regional mediante el siguiente patrón:

https://REGION-spanner.googleapis.com

Por ejemplo, si quieres aplicar garantías de datos en la configuración de la instancia regional Iowa (us-central1), usa este comando:

  https://us-central1-spanner.googleapis.com

Consulta la API de REST para obtener más información.

API de RPC

El extremo predeterminado de la API accede al extremo global. Para usar un extremo regional, configura el extremo con la dirección del extremo regional mediante el siguiente patrón:

REGION-spanner.googleapis.com

Por ejemplo, si quieres aplicar garantías de datos en la configuración de la instancia regional Iowa (us-central1), usa este comando:

us-central1-spanner.googleapis.com

Consulta la API de RPC para obtener más información.

¿Qué sigue?