En esta página, se describen los extremos de servicios globales y regionales de Spanner y cómo usarlos.
Un extremo de servicio es una base Es una URL que especifica la dirección de red de un servicio de API. Spanner tiene extremos globales y regionales. Puedes usar un servicio global o regional para enviar solicitudes a Spanner.
Usa el extremo global si no tienes una configuración regional estricta
restricciones de uso. Aunque los datos se almacenan dentro de la región seleccionada,
es posible que los datos se procesen 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 procesados dentro de la misma región. Extremos regionales para Spanner garantizar y garantizar que los datos almacenados y procesados se limiten al Configuración de instancias regional de Spanner donde reside la base de datos. Use extremos regionales si la ubicación de sus datos debe ser restringidas y controladas para cumplir con los requisitos reglamentarios. No puedes usar que un extremo regional acceda a los recursos que pertenecen a una instancia diferente configuración. Primero debes crear una instancia en el directorio de la instancia de Compute Engine antes de que puedas usar el extremo regional para esa la configuración de una instancia de Compute Engine.
Un extremo regional de Spanner solo está disponible en Dammam.
me-central2
Configuración de instancias regionales. El enfoque
Las políticas de almacenamiento de Spanner no cambian, independientemente de la
del extremo que usas.
Seguridad y cumplimiento para extremos regionales
El beneficio de usar un extremo regional de Spanner en lugar de uno global extremo es que el extremo regional proporciona aislamiento regional y para satisfacer los requisitos de seguridad, cumplimiento y reglamentaciones.
Solo puedes usar extremos regionales que pertenezcan a esa instancia regional
configuración. Por ejemplo, no puedes usar
spanner.me-central2.rep.googleapis.com
para entregar solicitudes si la instancia a la que
pertenece a la configuración de la instancia regional us-central1
.
La solicitud se rechazará con un error InvalidRegionalRequest
.
Limitaciones de los extremos regionales
No puedes acceder a una configuración de instancia de doble región o multirregión con un extremo regional. Debes usar el extremo global para acceder
de instancias regionales o multirregionales. Por ejemplo, si tienes una instancia en la configuración de instancias multirregionales nam7
, no puedes usar el extremo regional spanner.us-central1.rep.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, ya que la aplicación bloquea el acceso a instancias entre regiones. Las solicitudes que usan un extremo global se no se vean afectados.
Convención de nomenclatura del extremo regional
Los nombres de los extremos regionales de Spanner siguen la misma convención de nomenclatura
que los nombres
de configuración de instancias regionales. El extremo regional sigue el formato spanner.<REGION>.rep.googleapis.com
. Por ejemplo, tanto el sistema regional
el nombre de la configuración de instancia y el nombre del extremo regional para Dammam
me-central2
Por lo tanto, el extremo regional
spanner.me-central2.rep.googleapis.com
Solo me-central2
está disponible como un extremo regional posible.
Especifica un extremo regional
Puedes especificar un extremo regional de Spanner con las solicitudes de la API de Google Cloud CLI, REST o RPC.
gcloud
Para especificar un extremo regional y anular el global, ejecuta el comando siguiente comando:
gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/
Ingresa el siguiente valor:
REGION
- Es la región para la que se configura un extremo regional. Por ejemplo:
me-central2
Por ejemplo, para configurar el extremo regional como me-central2
, ejecuta el comando
siguiente comando:
gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/
Para volver a configurar un extremo regional en el 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 servidor configura el extremo en la dirección del extremo regional mediante el siguiente patrón:
https://spanner.REGION.rep.googleapis.com
Por ejemplo, si quieres aplicar garantías de datos en la instancia regional
configuración Dammam (me-central2
), usa lo siguiente:
https://spanner.me-central2.rep.googleapis.com
Consulta la API de REST para obtener más información.
API de RPC
El extremo de la API predeterminado accede al extremo global. Para usar un extremo regional, configura el extremo en la dirección del extremo regional con el siguiente patrón:
spanner.REGION.rep.googleapis.com
Por ejemplo, si quieres aplicar garantías de datos en la instancia regional
configuración Dammam (me-central2
), usa lo siguiente:
spanner.me-central2.rep.googleapis.com
Consulta la API de RPC para obtener más información.
¿Qué sigue?
Obtén más información sobre la configuración de instancias de Spanner.
Obtén más información sobre la API de REST de Spanner y Extremos globales y regionales.
Obtén más información sobre la API de RPC de Spanner y Extremos globales y regionales.