Cette page décrit les points de terminaison de service mondiaux et régionaux de Spanner, comment les utiliser.
Un point de terminaison de service est un URL qui spécifie l'adresse réseau d'un service d'API. Spanner dispose à la fois de points de terminaison mondiaux et régionaux. Vous pouvez utiliser un service mondial ou régional pour envoyer des requêtes à Spanner.
Utilisez le point de terminaison mondial si vous n'avez pas de règles
de restrictions. Bien que les données soient stockées dans la région sélectionnée,
les données peuvent être traitées en dehors de la région. Le point de terminaison mondial
La valeur de Spanner est spanner.googleapis.com
. Le point de terminaison de l'API par défaut
au point de terminaison mondial.
Un point de terminaison régional applique des restrictions régionales. Les données sont stockées et dans la même région. Points de terminaison régionaux pour Spanner de garantir et de garantir que les données stockées et traitées sont limitées Configuration de l'instance régionale Spanner l'emplacement de la base de données. Utilisez des points de terminaison régionaux si l'emplacement de vos données doit être soumis à des restrictions et contrôlés afin de respecter les exigences réglementaires. Vous ne pouvez pas utiliser un point de terminaison régional pour accéder aux ressources appartenant à une autre instance configuration. Vous devez d'abord créer une instance dans la région configuration d'instance avant de pouvoir utiliser le point de terminaison régional configuration d'instance.
Un point de terminaison régional Spanner n'est disponible que dans la région de Dammam
me-central2
: configuration d'instance régionale. L'infrastructure sous-jacente
Les règles de stockage Spanner ne changent pas,
que vous utilisez.
Sécurité et conformité des points de terminaison régionaux
L'avantage d'utiliser un point de terminaison régional Spanner par rapport à un point de terminaison mondial est que le point de terminaison régional fournit une isolation régionale pour répondre aux exigences réglementaires, de sécurité et de conformité.
Vous ne pouvez utiliser que des points de terminaison régionaux appartenant à cette instance régionale
configuration. Par exemple, vous ne pouvez pas utiliser
spanner.me-central2.rep.googleapis.com
pour diffuser les requêtes si l'instance
auxquels vous accédez appartient à la configuration d'instance régionale us-central1
.
La requête sera rejetée avec une erreur InvalidRegionalRequest
.
Limites des points de terminaison régionaux
Vous ne pouvez pas accéder à une configuration d'instance birégionale ou multirégionale avec un compte
un point de terminaison régional. Vous devez utiliser le point de terminaison mondial pour accéder à votre emplacement birégional
ou multirégionales. Par exemple, si vous avez une instance dans
la configuration d'instance multirégionale nam7
, vous ne pouvez pas utiliser la configuration
le point de terminaison spanner.us-central1.rep.googleapis.com
pour envoyer des requêtes
dans nam7
.
Si vous avez des requêtes actives qui utilisent des points de terminaison régionaux sur l'une des les ressources de l'instance, en déplaçant l'instance a une incidence sur toutes les requêtes utilisant le point de terminaison régional, car l'application régionale bloque l'accès aux instances interrégionales. Les requêtes utilisant un point de terminaison mondial non concernées.
Convention d'attribution de noms régionale des points de terminaison
Les noms des points de terminaison régionaux Spanner suivent la même convention d'attribution de noms
comme noms de configuration d'instance régionaux. Le point de terminaison régional suit
le format spanner.<REGION>.rep.googleapis.com
. Par exemple, la version régionale
le nom de la configuration d'instance et le nom du point de terminaison régional pour Dammam sont
me-central2
Par conséquent, le point de terminaison régional
spanner.me-central2.rep.googleapis.com
Seul me-central2
est disponible comme point de terminaison régional possible.
Spécifier un point de terminaison régional
Vous pouvez spécifier un point de terminaison régional Spanner à l'aide de la méthode Requêtes API Google Cloud CLI, REST ou RPC.
gcloud
Pour spécifier un point de terminaison régional et remplacer le point de terminaison global, exécutez la commande la commande suivante:
gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/
Indiquez la valeur suivante :
REGION
- Région pour laquelle définir un point de terminaison régional. Par exemple,
me-central2
.
Par exemple, pour configurer le point de terminaison régional en tant que me-central2
, exécutez la commande
la commande suivante:
gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/
Pour reconfigurer un point de terminaison régional sur le point de terminaison mondial, exécutez la commande suivante:
gcloud config unset api_endpoint_overrides/spanner
API REST
Le point de terminaison de l'API par défaut accède au point de terminaison global. Pour utiliser un nom le point de terminaison, configurez-le avec l'adresse du point de terminaison régional à l'aide de le format suivant:
https://spanner.REGION.rep.googleapis.com
Par exemple, si vous souhaitez appliquer des garanties de données dans l'instance régionale
la configuration Dammam (me-central2
), utilisez:
https://spanner.me-central2.rep.googleapis.com
Pour en savoir plus, consultez la page API REST.
API RPC
Le point de terminaison de l'API par défaut accède au point de terminaison global. Pour utiliser un nom le point de terminaison, configurez-le avec l'adresse du point de terminaison régional à l'aide de le format suivant:
spanner.REGION.rep.googleapis.com
Par exemple, si vous souhaitez appliquer des garanties de données dans l'instance régionale
la configuration Dammam (me-central2
), utilisez:
spanner.me-central2.rep.googleapis.com
Pour en savoir plus, consultez la section API RPC.
Étape suivante
En savoir plus sur les configurations d'instances Spanner.
Apprenez-en plus sur l'API REST Spanner et Points de terminaison mondiaux et régionaux.
Apprenez-en plus sur l'API RPC Spanner et Points de terminaison mondiaux et régionaux.