Standortendpunkte

Auf dieser Seite werden Bigtable-Standortendpunkte beschrieben. Außerdem erfahren Sie, was Sie vor der Verwendung beachten sollten und wie Sie einen Endpunkt mit der Google Cloud CLI festlegen.

Sie können entweder einen globalen oder einen standortbezogenen Dienstendpunkt verwenden, um Anfragen an Bigtable zu senden. Mit Standortendpunkten für Bigtable wird sichergestellt, dass die Daten einer Instanz in der Bigtable-Region gespeichert und verarbeitet werden, in der sie sich befinden. Sie müssen möglicherweise Standortendpunkte für Bigtable in einer bestimmten geografischen Region verwenden, um die Sicherheits- und Complianceanforderungen Ihres Projekts zu erfüllen.

Bevor Sie dieses Dokument lesen, sollten Sie mit Instanzen, Clustern und Knoten und App-Profilen vertraut sein.

Zu den wichtigsten Konzepten gehören:

  • Dienstendpunkt: Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Bigtable hat sowohl globale als auch Standortendpunkte.

  • Globaler Endpunkt: Mit einem globalen Endpunkt können die Daten in einer Bigtable-Instanz in Bigtable gespeichert und an eine beliebige Region weitergeleitet werden, die einen der Cluster der Instanz enthält. Der globale Endpunkt für die Cloud Bigtable API (Data API) ist bigtable.googleapis.com. Der Standardendpunkt der Data API greift auf den globalen Endpunkt zu.

  • Standortendpunkt: Ein Standortendpunkt erzwingt Standorteinschränkungen, damit Daten in einer bestimmten Region gespeichert und verarbeitet werden.

Sie können Standortendpunkte nur mit der Cloud Bigtable API (Data API) verwenden. Standortendpunkte werden für die Cloud Bigtable Admin API nicht unterstützt.

Wann Standortendpunkte verwenden?

Der Vorteil eines Bigtable-Standortendpunkts gegenüber einem globalen Endpunkt besteht darin, dass der Standortendpunkt eine Standortisolierung und einen Schutz bietet, um Sicherheits-, Compliance- und rechtliche Anforderungen zu erfüllen.

Verwenden Sie einen Standortendpunkt, wenn der Standort Ihrer Daten eingeschränkt und kontrolliert werden muss, um rechtliche Anforderungen zu erfüllen.

Verwenden Sie den globalen Endpunkt, wenn keine strengen Anforderungen an die Standortbeschränkung gelten.

Überlegungen bei der Verwendung eines Standortendpunkts

Berücksichtigen Sie bei der Verwendung eines Standortendpunkts die folgenden Faktoren.

Clusterstandorte

Bevor Sie einen Standortendpunkt verwenden können, müssen Sie eine Instanz mit mindestens einem Cluster in der Region erstellen, in der Sie Ihre Daten isolieren möchten. Bigtable-Standortendpunkte sind an allen Bigtable-Standorten verfügbar.

Sie können nur einen Standortendpunkt verwenden, der zu der Region gehört, in der Sie Ihre Daten isolieren möchten. Sie können us-west1-bigtable.googleapis.com beispielsweise nicht zum Ausführen von Anfragen verwenden, wenn sich der Cluster, auf den Sie zugreifen, in der Region us-central1 befindet.

Wenn Sie versuchen, einen Standortendpunkt für den Zugriff auf einen Cluster in einer anderen Region zu verwenden, wird die Anfrage mit dem Fehler FAILED_PRECONDITION mit einer Meldung abgelehnt, dass mit dem angegebenen Cluster und Endpunkt nicht auf Cluster zugegriffen werden kann. Beispiel: Eine an us-west1-bigtable.googleapis.com gesendete Anfrage für Cluster in us-central1 schlägt mit FAILED_PRECONDITION fehl. Weitere Informationen zu FAILED_PRECONDITION finden Sie unter Bigtable-Statuscodes.

App-Profile

Nachdem Sie einen Standortendpunkt festgelegt haben, müssen Sie ein App-Profil verwenden, das für die Weiterleitung von Anfragen an einen Cluster in der Region des Endpunkts konfiguriert ist.

Wenn Sie versuchen, ein Anwendungsprofil zu verwenden, das so konfiguriert ist, dass Schreibvorgänge nur an einen Cluster (mit Single-Cluster-Routing) oder Cluster in einer anderen Region als der Endpunkt (mit Multi-Cluster-Routing) gesendet werden, erhalten Sie die Fehlerantwort für die fehlgeschlagene Vorbedingung There are no clusters accessible through this app profile and the REGION_NAME endpoint.. Weitere Informationen zum Cluster-Routing finden Sie unter Routingrichtlinie.

Wenn Sie ein Anwendungsprofil verwenden, das für die Weiterleitung an einen beliebigen Cluster in einer Instanz für Hochverfügbarkeit (High Availability, HA) konfiguriert ist, und Sie einen Standortendpunkt verwenden, sorgt der Standortendpunkt dafür, dass alle Anfragen nur an Cluster in dessen Region weitergeleitet werden, auch wenn die Instanz Cluster in anderen Regionen hat. Der automatische Failover ist eingeschränkt, sodass Anfragen nur von Clustern in der Region des Endpunkts verarbeitet werden.

Nehmen wir beispielsweise an, Sie senden Anfragen mit einem Anwendungsprofil, das für Multi-Cluster-Routing an eine Instanz mit Clustern in us-west1-a (Oregon), us-west1-b (Oregon) und us-central1-a (Iowa) konfiguriert ist. Wenn Sie diese Anfragen an den Standortendpunkt von us-central1-bigtable.googleapis.com senden, werden alle Anfragen von us-central1-a verarbeitet, auch wenn Sie das App-Profil nicht neu konfigurieren. Anfragen, die von us-central1-a nicht verarbeitet werden können, schlagen fehl.

Replikation

Standortendpunkte wirken sich nicht auf die Replikation aus und verhindern sie auch nicht. Wenn Sie einen Standortendpunkt in Region A konfigurieren und Ihrer Instanz in Region B dann einen Cluster hinzufügen, werden Ihre Daten genauso in Region B repliziert wie bei Verwendung des globalen Endpunkts.

Erstellen Sie Cluster nur in der gewünschten Region, um eine Replikation von Daten in eine andere Region zu vermeiden.

Wenn Sie verhindern möchten, dass Nutzer in Ihrer Organisation Cluster außerhalb der Endpunktregion hinzufügen, können Sie eine Organisationsrichtlinie mit Standorteinschränkungen festlegen. Weitere Informationen finden Sie unter Ressourcenstandorte einschränken.

Verfügbarkeit

Wenn Sie Standortendpunkte verwenden, können Sie Bigtable nicht so konfigurieren, dass eine monatliche Verfügbarkeit von mindestens 99,999 % erreicht wird. Für eine monatliche Verfügbarkeit von mindestens 99,999 % ist ein automatischer Failover von Anfragen über Standortgrenzen hinweg erforderlich.Dies wird durch einen Standortendpunkt verhindert, da er alle Anfragen auf eine einzige Region beschränkt. Weitere Informationen zu den monatlichen Prozentsätzen der Verfügbarkeit finden Sie im Bigtable-Service Level Agreement (SLA).

Semantik von Standortendpunkten

Das erste Segment des Namens eines Bigtable-Standortendpunkts ist der Name derGoogle Cloud Region. Ein Standortendpunkt hat das Format REGION-bigtable.googleapis.com, wobei REGION ein Regionsname ist, z. B. northamerica-northeast2.

Wenn Sie beispielsweise Ihre Daten in der Region Iowa isolieren möchten, weil der Regionsname für Iowa us-central1 lautet, lautet die URL des Standortendpunkts für die Region Iowa us-central1-bigtable.googleapis.com. Eine Liste der verfügbaren Regionen finden Sie unter Bigtable-Standorte.

Standortendpunkt angeben

Sie können einen Bigtable-Standortendpunkt mit der Google Cloud CLI, der cbt CLI oder den Cloud Bigtable-Clientbibliotheken angeben.

gcloud

Führen Sie den folgenden Befehl aus, um einen standortbezogenen Endpunkt anzugeben und den globalen Endpunkt mit der gcloud CLI zu überschreiben:

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

Ersetzen Sie REGION durch die Region, für die Sie einen Standortendpunkt festlegen möchten, z. B. us-central1 oder europe-west1.

Wenn Sie den Standortendpunkt beispielsweise als us-central1 konfigurieren möchten, führen Sie den folgenden Befehl aus:

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

cbt

Wenn Sie einen standortbezogenen Endpunkt angeben und den globalen Endpunkt mit der cbt-Befehlszeile überschreiben möchten, können Sie in Ihrer Anfrage die Option --data-endpoint verwenden oder der Datei ~/.cbtrc Folgendes hinzufügen. Weitere Informationen zum Erstellen einer ~/.cbtrc-Datei finden Sie in der Referenz zur cbt-Befehlszeile.

data-endpoint = https://REGION-bigtable.googleapis.com/

Ersetzen Sie REGION durch die Region, für die Sie einen Standortendpunkt festlegen möchten, z. B. us-central1 oder europe-west1.

Wenn Sie den Standortendpunkt beispielsweise als us-central1 konfigurieren möchten, fügen Sie der Datei ~/.cbtrc Folgendes hinzu:

data-endpoint = https://us-central1-bigtable.googleapis.com/

Globalen Endpunkt angeben

gcloud

Führen Sie diesen Befehl aus, um einen Standortendpunkt auf den globalen Endpunkt umzustellen:

gcloud config unset api_endpoint_overrides/bigtable

cbt

Wenn Sie den globalen Endpunkt angeben möchten, senden Sie Ihre Anfrage ohne die Option --data-endpoint. Wenn Sie Ihrer Datei ~/.cbtrc zuvor eine data-endpoint-Zeile hinzugefügt haben, löschen Sie sie.

Nächste Schritte