Globale und regionale Dienstendpunkte

Auf dieser Seite werden die globalen und regionalen Dienstendpunkte von Spanner und ihre Verwendung beschrieben.

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Spanner hat sowohl globale als auch regionale Endpunkte. Sie können einen globalen oder regionalen Dienstendpunkt verwenden, um Anfragen an Spanner zu senden.

Verwenden Sie den globalen Endpunkt, wenn keine strengen regionalen Einschränkungen gelten. Auch wenn die Daten in der ausgewählten Region gespeichert werden, können sie außerhalb der Region verarbeitet werden. Der globale Endpunkt für Spanner lautet spanner.googleapis.com. Über den Standard-API-Endpunkt wird auf den globalen Endpunkt zugegriffen.

Ein regionaler Endpunkt erzwingt regionale Einschränkungen. Die Daten werden in derselben Region gespeichert und verarbeitet. Regionale Endpunkte für Spanner sorgen dafür, dass die gespeicherten und verarbeiteten Daten auf die regionale Instanzkonfiguration von Spanner beschränkt sind, in der sich die Datenbank befindet. Verwenden Sie regionale Endpunkte, wenn der Speicherort Ihrer Daten eingeschränkt und kontrolliert werden muss, um rechtliche Anforderungen zu erfüllen. Sie können keinen regionalen Endpunkt verwenden, um auf Ressourcen zuzugreifen, die zu einer anderen Instanzkonfiguration gehören. Sie müssen zuerst eine Instanz in der regionalen Instanzkonfiguration erstellen, bevor Sie den regionalen Endpunkt für diese Instanzkonfiguration verwenden können.

Ein regionaler Spanner-Endpunkt ist nur in der me-central2 regionalen Instanzkonfiguration für Dammam verfügbar. Die zugrunde liegenden Spanner-Speicherrichtlinien ändern sich unabhängig davon, welchen Endpunkt Sie verwenden.

Sicherheit und Compliance für regionale Endpunkte

Der Vorteil eines regionalen Spanner-Endpunkts gegenüber einem globalen Endpunkt besteht darin, dass der regionale Endpunkt eine regionale Isolierung und einen Schutz bietet, um Sicherheits-, Compliance- und rechtliche Anforderungen zu erfüllen.

Sie können nur regionale Endpunkte verwenden, die zu dieser regionalen Instanzkonfiguration gehören. Sie können spanner.me-central2.rep.googleapis.com beispielsweise nicht zum Ausführen von Anfragen verwenden, wenn die Instanz, auf die Sie zugreifen, zur regionalen Instanzkonfiguration us-central1 gehört. Die Anfrage wird mit dem Fehler InvalidRegionalRequest abgelehnt.

Einschränkungen regionaler Endpunkte

Sie können nicht mit einem regionalen Endpunkt auf eine Dual- oder Multi-Region-Instanzkonfiguration zugreifen. Sie müssen den globalen Endpunkt verwenden, um auf Ihre dual-regionalen oder multiregionalen Instanzkonfigurationen zuzugreifen. Wenn Sie beispielsweise eine Instanz in der multiregionalen Instanzkonfiguration nam7 haben, können Sie nicht den regionalen Endpunkt spanner.us-central1.rep.googleapis.com verwenden, um Anfragen an Ihre Instanz in nam7 zu senden.

Wenn Sie aktive Anfragen haben, die regionale Endpunkte auf einer der Instanzressourcen verwenden, wirkt sich das Verschieben der Instanz auf alle Anfragen aus, die den regionalen Endpunkt verwenden, da die regionale Erzwingung den Zugriff auf regionsübergreifende Instanzen blockiert. Anfragen, die einen globalen Endpunkt verwenden, sind davon nicht betroffen.

Namenskonvention für regionale Endpunkte

Namen regionaler Spanner-Endpunkte folgen derselben Namenskonvention wie die Namen der regionalen Instanzkonfigurationen. Der regionale Endpunkt hat das Format spanner.<REGION>.rep.googleapis.com. Beispiel: Sowohl der Name der regionalen Instanzkonfiguration als auch der Name des regionalen Endpunkts für Dammam lautet me-central2. Der regionale Endpunkt ist daher spanner.me-central2.rep.googleapis.com.

Als regionaler Endpunkt ist nur me-central2 verfügbar.

Regionalen Endpunkt angeben

Sie können einen regionalen Spanner-Endpunkt mithilfe der Google Cloud CLI, REST- oder RPC API-Anfragen angeben.

gcloud

Führen Sie den folgenden Befehl aus, um einen regionalen Endpunkt anzugeben und den globalen Endpunkt zu überschreiben:

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

Geben Sie folgenden Wert an:

REGION
Die Region, für die ein regionaler Endpunkt festgelegt werden soll. Beispiel: me-central2

Führen Sie beispielsweise den folgenden Befehl aus, um den regionalen Endpunkt als me-central2 zu konfigurieren:

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

Wenn Sie einen regionalen Endpunkt auf den globalen Endpunkt umkonfigurieren möchten, führen Sie Folgendes aus:

gcloud config unset api_endpoint_overrides/spanner

REST API

Der Standard-API-Endpunkt greift auf den globalen Endpunkt zu. Wenn Sie einen regionalen Endpunkt verwenden möchten, konfigurieren Sie den Endpunkt mit der Adresse des regionalen Endpunkts. Verwenden Sie dabei das folgende Muster:

https://spanner.REGION.rep.googleapis.com

Wenn Sie beispielsweise Datengarantien in der regionalen Instanzkonfiguration Dammam (me-central2) erzwingen möchten, verwenden Sie Folgendes:

  https://spanner.me-central2.rep.googleapis.com

Weitere Informationen finden Sie unter REST API.

RPC API

Der Standard-API-Endpunkt greift auf den globalen Endpunkt zu. Wenn Sie einen regionalen Endpunkt verwenden möchten, konfigurieren Sie den Endpunkt mit der Adresse des regionalen Endpunkts. Verwenden Sie dabei das folgende Muster:

spanner.REGION.rep.googleapis.com

Wenn Sie beispielsweise Datengarantien in der regionalen Instanzkonfiguration Dammam (me-central2) erzwingen möchten, verwenden Sie Folgendes:

spanner.me-central2.rep.googleapis.com

Weitere Informationen finden Sie in der RPC API.

Nächste Schritte