Standortendpunkte

Auf dieser Seite werden die geografischen Endpunkte von Bigtable beschrieben, erklärt, was Sie die Sie vor der Verwendung beachten sollten, und zeigt, wie Sie mit der Google Cloud CLI

Sie können entweder einen globalen oder einen standortbezogenen Dienstendpunkt verwenden, um Anfragen an Bigtable zu senden. Standortendpunkte für Bigtable sorgen dass die Daten einer Instanz in Bigtable gespeichert und verarbeitet werden Region, in der sich die Daten 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.

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 standortbasierter Endpunkt erzwingt eine Standortbestimmung. So wird sichergestellt, dass die Daten in einem bestimmten Region

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 werden standortbezogene Endpunkte verwendet?

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 Sie keine strenge Standortbeschränkung haben Anforderungen.

Überlegungen bei der Verwendung eines standortbezogenen Endpunkts

Berücksichtigen Sie bei der Verwendung eines standortbezogenen Endpunkts 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. Die Standortendpunkte von Bigtable sind in allen Bigtable-Standorte

Sie können nur einen Standortendpunkt verwenden, der zu der Region gehört, in der Sie Ihre Daten isolieren möchten. Beispielsweise können Sie nicht us-west1-bigtable.googleapis.com zum Verarbeiten von Anfragen, wenn der Cluster, den Sie sind, Der Zugriff befindet sich in der Region us-central1.

Wenn Sie versuchen, Endpunkt für den Zugriff auf einen Cluster in einer anderen Region verwendet, wird die Anfrage mit Einen FAILED_PRECONDITION-Fehler mit der Meldung, dass keine Cluster vorhanden sind über den angegebenen Cluster und Endpunkt zugänglich sein. Beispiel: Eine gesendete Anfrage bis us-west1-bigtable.googleapis.com für Cluster in us-central1 schlägt fehl mit FAILED_PRECONDITION Weitere Informationen zu FAILED_PRECONDITION finden Sie unter Bigtable-Statuscodes.

App-Profile

Nachdem Sie einen standortbezogenen Endpunkt festgelegt haben, müssen Sie ein Anwendungsprofil verwenden, das so konfiguriert, dass Anfragen an einen Cluster in der Region des Endpunkts weitergeleitet werden.

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 das Weiterleiten an einen beliebigen Cluster in einem z. B. für Hochverfügbarkeit. Außerdem verwenden Sie einen standortbezogenen Endpunkt, des geografischen Endpunkts sorgt, dass alle Anfragen nur an Cluster in der Region auch dann, wenn die Instanz Cluster in anderen Regionen hat. Automatisch Failover eingeschränkt sind, sodass Anfragen nur von Clustern in der Region des Endpunkts bereitgestellt 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 beeinflussen oder verhindern die Replikation 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.

Damit keine Daten in eine andere Region repliziert werden, erstellen Sie Cluster nur in der gewünschten Region.

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 standortbezogene Endpunkte verwenden, können Sie Bigtable nicht so konfigurieren, eine monatliche Verfügbarkeit von >= 99,999%. Eine monatliche Betriebszeit von >= 99,999% erfordert ein automatisches Failover von Anfragen über Standortgrenzen, die ein standortbezogener Endpunkt verhindert. da alle Anfragen auf eine einzige Region beschränkt sind. 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 der Google Cloud-Region. Ein Standortendpunkt hat das Format REGION-bigtable.googleapis.com, wobei REGION ein Regionsname ist, z. B. northamerica-northeast2.

Wenn Sie z. B. Ihre Daten in der Region Iowa isolieren möchten, Name der Region für Iowa lautet us-central1, die URL des geografischen Endpunkts für Iowa Region ist us-central1-bigtable.googleapis.com. Eine Liste der verfügbaren Regionen finden Sie unter Bigtable-Standorte.

Standortendpunkt angeben

Sie können mit der Methode Google Cloud CLI, cbt CLI oder Cloud Bigtable Client Bibliotheken.

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

So geben Sie einen Standortendpunkt an und überschreiben den globalen Endpunkt mit der cbt-Befehlszeile: können Sie die Option --data-endpoint in Ihrer Anfrage verwenden oder die der Datei ~/.cbtrc hinzu. Weitere Informationen zum Erstellen eines ~/.cbtrc-Datei finden Sie in der cbt-CLI-Referenz.

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

Ersetzen Sie REGION durch die Region, für die Sie eine eines geografischen Endpunkts wie us-central1 oder europe-west1

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

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 zuvor eine data-endpoint-Zeile hinzugefügt haben in die Datei ~/.cbtrc ein und löschen Sie sie.

Nächste Schritte