Endpoint regionali di BigQuery

In questa pagina viene descritto come utilizzare gli endpoint regionali di Private Service Connect per accedere alle risorse in BigQuery. Gli endpoint regionali ti consentono di eseguire i workload in modo conforme ai requisiti di residenza dei dati e sovranità dei dati, in cui il traffico delle richieste viene instradato direttamente alla regione specificata nell'endpoint.

Panoramica

Gli endpoint a livello di regione sono endpoint di richiesta che consentono di limitare le richieste in modo che vengano elaborate solo se la risorsa interessata esiste nella località specificata dall'endpoint. Ad esempio, se utilizzi l'endpoint https://bigquery.us-central1.rep.googleapis.com in una richiesta di eliminazione del set di dati, la richiesta procede solo se il set di dati si trova in US-CENTRAL1.

A differenza degli endpoint globali, in cui le richieste possono essere instradate attraverso una località diversa da quella in cui si trova la risorsa, gli endpoint regionali possono aiutarti a limitare le richieste alla località specificata dall'endpoint in cui si trova la risorsa. Gli endpoint regionali terminano le sessioni TLS nella località specificata dall'endpoint per le richieste ricevute da internet, da altre risorseGoogle Cloud (come le macchine virtuali di Compute Engine), da servizi on-premise che utilizzano VPN o Interconnect e da Virtual Private Cloud (VPC).

Gli endpoint regionali contribuiscono a garantire la residenza dei dati mantenendo i dati delle tabelle at-rest e in transito all'interno della località specificata dall'endpoint. Sono esclusi i metadati delle risorse, come i nomi dei set di dati e le policy IAM. Per saperne di più, consulta Nota sui dati di servizio.

BigQuery include più API. Le seguenti API sono disponibili per l'utilizzo con l'endpoint regionale:

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

Località supportate

Puoi utilizzare gli endpoint regionali per conservare i dati nelle seguenti località:

  • Asia Pacifico

    • Delhi asia-south2
    • Mumbai asia-south1

  • Europa

    • Belgio europe-west1
    • Berlino europe-west10
    • Francoforte europe-west3
    • Londra europe-west2
    • Milano europe-west8
    • Paesi Bassi europe-west4
    • Parigi europe-west9
    • Zurigo europe-west6

  • Medio Oriente

    • Dammam me-central2

  • Americhe

    • Columbus, Ohio us-east5
    • Dallas us-south1
    • Iowa us-central1
    • Las Vegas us-west4
    • Los Angeles us-west2
    • Montréal northamerica-northeast1
    • Virginia del Nord us-east4
    • Oregon us-west1
    • Salt Lake City us-west3
    • Carolina del Sud us-east1
    • Toronto northamerica-northeast2

Operazioni supportate

Gli endpoint regionali possono essere utilizzati solo per eseguire operazioni che accedono o modificano le risorse archiviate nella località specificata dall'endpoint. Gli endpoint regionali non possono essere utilizzati per eseguire operazioni che accedono o modificano risorse al di fuori della località specificata dall'endpoint.

Ad esempio, quando utilizzi l'endpoint regionale https://bigquery.us-central1.rep.googleapis.com, puoi leggere le tabelle nei set di dati che si trovano in US-CENTRAL1 e copiare una tabella da un set di dati di origine a un set di dati di destinazione solo se entrambi i set di dati si trovano in US-CENTRAL1. Se provi a leggere o copiare una tabella dall'esterno di US-CENTRAL1, ricevi un errore.

Limitazioni e restrizioni

Gli endpoint regionali non possono essere utilizzati per eseguire le seguenti operazioni:

  • Operazioni che accedono o modificano le risorse al di fuori della località specificata dall'endpoint
  • Copia, replica o riscrittura di risorse da una località a un'altra.

Tieni presente le seguenti limitazioni quando utilizzi gli endpoint regionali:

Strumenti per l'utilizzo degli endpoint regionali

Console

Per accedere alle risorse BigQuery in modo conforme ai requisiti di residenza o sovranità dei dati, utilizza gli URL della consoleGoogle Cloud giurisdizionali:

Risorsa URL
Elenco dei set di dati per un progetto https://console.JURISDICTION.cloud.google.com/bigquery?project=PROJECT_ID
Elenco di tabelle per un set di dati https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables
Dettagli di una tabella https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables/TABLE_NAME

Sostituisci JURISDICTION con uno dei seguenti valori:

  • eu se la risorsa si trova nell'Unione Europea
  • sa se la risorsa si trova nel Regno dell'Arabia Saudita
  • us se la risorsa si trova negli Stati Uniti

Riga di comando

Per configurare Google Cloud CLI per l'utilizzo con gli endpoint regionali, completa i seguenti passaggi:

  1. Assicurati di utilizzare Google Cloud CLI 402.0.0 o versioni successive.

  2. Imposta la proprietà api_endpoint_overrides/bigquery sull'endpoint regionale che vuoi utilizzare:

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

    In alternativa, puoi impostare la variabile di ambiente CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY sull'endpoint:

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

API REST

Per l'API REST, anziché inviare una richiesta REST a un endpoint di servizio, invia la richiesta all'endpoint regionale nel seguente formato: https://bigquery.LOCATION.rep.googleapis.com.

Limita l'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali, utilizza il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta Limita l'utilizzo degli endpoint.