BigQuery-Regionalendpunkte

Auf dieser Seite wird beschrieben, wie Sie regionale Private Service Connect-Endpunkte verwenden können, um auf Ressourcen in BigQuery zuzugreifen. Mit regionalen Endpunkten können Sie Ihre Arbeitslasten so ausführen, dass sie den Datenstandort- und Datenhoheitsanforderungen entsprechen, wobei Ihr Anfragetraffic direkt an die im Endpunkt angegebene Region weitergeleitet wird.

Übersicht

Regionale Endpunkte sind Anfrageendpunkte, die Anfragen nur zulassen, wenn die betroffene Ressource am vom Endpunkt angegebenen Standort vorhanden ist. Wenn Sie beispielsweise den Endpunkt https://bigquery.us-central1.rep.googleapis.com in einer Anfrage zum Löschen eines Datensatzes verwenden, wird die Anfrage nur fortgesetzt, wenn sich der Datensatz in US-CENTRAL1 befindet.

Im Gegensatz zu globalen Endpunkten, bei denen Anfragen über einen anderen Standort als den der Ressource weitergeleitet werden können, können Sie mit regionalen Endpunkten Ihre Anfragen auf den vom Endpunkt angegebenen Standort (an dem sich die Ressource befindet) beschränken. Regionale Endpunkte beenden TLS-Sitzungen an dem vom Endpunkt angegebenen Standort für Anfragen aus dem Internet, anderenGoogle Cloud -Ressourcen (z. B. virtuelle Compute Engine-Maschinen), lokalen Diensten mit VPN oder Interconnect und Virtual Private Clouds (VPCs).

Regionale Endpunkte tragen dazu bei, den Datenstandort zu gewährleisten, indem die inaktiven und übertragenen Daten der Tabelle am vom Endpunkt angegebenen Standort aufbewahrt werden. Die schließt Ressourcenmetadaten wie Datasetnamen und IAM-Richtlinien aus. Weitere Informationen finden Sie unter Hinweis zu Dienstdaten.

BigQuery umfasst mehrere APIs. Die folgenden APIs können mit einem regionalen Endpunkt verwendet werden:

API URL Referenz
BigQuery API bigquery.LOCATION.rep.googleapis.com REST
BigQuery Storage API bigquerystorage.LOCATION.rep.googleapis.com RPC
BigQuery Reservations API bigqueryreservation.LOCATION.rep.googleapis.com RPC und REST
BigQuery Migration API bigquerymigration.LOCATION.rep.googleapis.com REST
BigQuery Data Transfer Service API bigquerydatatransfer.LOCATION.rep.googleapis.com RPC und REST

Unterstützte Standorte

Sie können regionale Endpunkte verwenden, um Ihre Daten an den folgenden Standorten aufzubewahren:

  • Europäische Union

    • Frankfurt (europe-west3)
    • Mailand europe-west8
    • Paris europe-west9

  • Naher Osten

    • Dammam me-central2

  • USA

    • Iowa us-central1
    • South Carolina (us-east1)
    • Northern Virginia (us-east4)
    • Columbus, Ohio us-east5
    • Dallas us-south1
    • Oregon us-west1
    • Los Angeles (us-west2)
    • Salt Lake City (us-west3)
    • Las Vegas (us-west4)

Unterstützte Vorgänge

Regionale Endpunkte können nur verwendet werden, um Vorgänge auszuführen, die auf Ressourcen zugreifen oder diese mutieren, die an dem vom Endpunkt angegebenen Speicherort gespeichert sind. Regionale Endpunkte können nicht für Vorgänge verwendet werden, die auf Ressourcen außerhalb des vom Endpunkt angegebenen Standorts zugreifen oder diese mutieren.

Wenn Sie beispielsweise den regionalen Endpunkt https://bigquery.us-central1.rep.googleapis.com verwenden, können Sie Tabellen in Datasets in US-CENTRAL1 lesen und eine Tabelle nur dann aus einem Quell-Dataset in ein Ziel-Dataset kopieren, wenn sich beide Datasets in US-CENTRAL1 befinden. Wenn Sie versuchen, eine Tabelle außerhalb von US-CENTRAL1 zu lesen oder zu kopieren, erhalten Sie eine Fehlermeldung.

Limits und Einschränkungen

Regionale Endpunkte können nicht für die folgenden Vorgänge verwendet werden:

  • Vorgänge, die außerhalb des vom Endpunkt angegebenen Standorts auf Ressourcen zugreifen oder diese mutieren
  • Ressourcen von einem Standort an einen anderen kopieren, replizieren oder neu schreiben

Beachten Sie bei der Verwendung regionaler Endpunkte die folgenden Einschränkungen:

Tools für die Verwendung regionaler Endpunkte

Console

Wenn Sie auf BigQuery-Ressourcen in einer Weise zugreifen möchten, die den Anforderungen an den Datenspeicherort oder die Datensouveränität entspricht, verwenden Sie die URL derGoogle Cloud -Konsole für Ihre Gerichtsbarkeit:

Ressource URL
Dataset-Liste für ein Projekt https://console.JURISDICTION.cloud.google.com/bigquery?project=PROJECT_ID
Tabellenliste für ein Dataset https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables
Details zu einer Tabelle https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables/TABLE_NAME

Ersetzen Sie JURISDICTION durch einen der folgenden Werte:

  • eu, wenn sich die Ressource in der Europäischen Union befindet
  • sa, wenn sich die Ressource in Saudi-Arabien befindet
  • us, wenn sich die Ressource in den USA befindet

Befehlszeile

Führen Sie die folgenden Schritte aus, um die Google Cloud CLI für die Verwendung mit regionalen Endpunkten zu konfigurieren:

  1. Achten Sie darauf, dass Sie die Google Cloud CLI 402.0.0 oder höher verwenden.

  2. Setzen Sie das Attribut api_endpoint_overrides/bigquery auf den regionalen Endpunkt, den Sie verwenden möchten:

    gcloud config set api_endpoint_overrides/bigquery https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/

    Alternativ können Sie die Umgebungsvariable CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY auf den Endpunkt festlegen:

    CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY=https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/ gcloud  alpha bq  datasets list

REST APIs

Senden Sie bei der REST API anstelle einer REST-Anfrage an einen Dienstendpunkt die Anfrage im folgenden Format an den regionalen Endpunkt: https://bigquery.LOCATION.rep.googleapis.com.