Globale und regionale Dienstendpunkte

Auf dieser Seite werden globale und regionale 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 Sie keine strengen regionalen Einschränkungen haben. Obwohl die Daten in der ausgewählten Region gespeichert werden, können sie außerhalb der Region verarbeitet werden. Der globale Endpunkt für Spanner ist spanner.googleapis.com. Der Standard-API-Endpunkt greift auf den globalen Endpunkt zu.

Ein regionaler Endpunkt erzwingt regionale Einschränkungen. 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 Ihr Datenspeicherort eingeschränkt und kontrolliert werden muss, um gesetzliche Anforderungen zu erfüllen. Sie können einen regionalen Endpunkt nicht für den Zugriff auf Ressourcen verwenden, 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 regionalen Instanzkonfiguration me-central2 von Dammam verfügbar. Die zugrunde liegenden Spanner-Speicherrichtlinien ändern sich nicht, unabhängig davon, welchen Endpunkt Sie verwenden.

Sicherheit und Compliance für regionale Endpunkte

Der Vorteil der Verwendung eines regionalen Spanner-Endpunkts gegenüber einem globalen Endpunkt besteht darin, dass der regionale Endpunkt regionale Isolation und Schutz bietet, um Sicherheits-, Compliance- und regulatorische 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 Verarbeiten 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 auf eine multiregionale Instanzkonfiguration mit einem regionalen Endpunkt zugreifen. Sie müssen den globalen Endpunkt verwenden, um auf Ihre multiregionalen Instanzkonfigurationen zuzugreifen. Wenn Sie beispielsweise eine Instanz in der multiregionalen Instanzkonfiguration nam7 haben, können Sie den regionalen Endpunkt spanner.us-central1.rep.googleapis.com nicht 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 an den regionalen Endpunkt aus, da die regionale Erzwingung den Zugriff auf regionsübergreifende Instanzen blockiert. Anfragen über einen globalen Endpunkt sind davon nicht betroffen.

Namenskonvention für regionale Endpunkte

Die Namen regionaler Spanner-Endpunkte folgen derselben Namenskonvention wie die Namen der regionalen Instanzkonfigurationen. Der regionale Endpunkt hat das Format spanner.<REGION>.rep.googleapis.com. Der Name der regionalen Instanzkonfiguration und der Name des regionalen Endpunkts für Dammam sind beispielsweise me-central2. Daher ist der regionale Endpunkt spanner.me-central2.rep.googleapis.com.

Nur me-central2 ist als möglicher regionaler Endpunkt verfügbar.

Regionalen Endpunkt angeben

Sie können einen regionalen Spanner-Endpunkt über die 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/

Führen Sie folgenden Befehl aus, um einen regionalen Endpunkt für den globalen Endpunkt neu zu konfigurieren:

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 nach dem folgenden Muster für die Adresse des regionalen Endpunkts:

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 nach dem folgenden Muster für die Adresse des regionalen Endpunkts:

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 unter RPC API.

Nächste Schritte