Aree geografiche dati di Data Catalog

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Le risorse di Data Catalog sono ospitate in più località in tutto il mondo, chiamate aree geografiche. Una regione è una località geografica specifica da cui puoi accedere alle tue risorse. Per saperne di più, vedi Area geografica e regioni.

Per ridurre la latenza di rete, consigliamo di utilizzare l'endpoint API per un'area geografica vicina alla tua destinazione. Ad esempio, se prevedi di accedere a Data Catalog dall'Asia, puoi utilizzare l'endpoint per Taiwan.

Aree geografiche supportate

Regione Endpoint a livello di area geografica Risorse supportate
Americhe
Montréal northamerica-northeast1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Toronto northamerica-northeast2-datacatalog.googleapis.com Modelli di tag, voci create dall'utente
San Paolo southamerica-east1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Santiago southamerica-west1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Iowa us-central1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Carolina del Sud us-east1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Virginia del Nord us-east4-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Virginia del Nord aws-us-east-1-datacatalog.googleapis.com, azure-eastus2-datacatalog.googleapis.com Modelli di tag, BigQuery (attualmente, ad eccezione delle connessioni), voci create dall'utente
Oregon us-west1-datacatalog.googleapis.com Modelli di tag, voci create dall'utente
Los Angeles us-west2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Salt Lake City us-west3-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Las Vegas us-west4-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Europa
Varsavia europe-central2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Finlandia europe-north1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Belgio europe-west1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Londra europe-west2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Francoforte europe-west3-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Paesi Bassi europe-west4-datacatalog.googleapis.com Modelli di tag, voci create dall'utente
Zurigo europe-west6-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Asia Pacifico
Taiwan asia-east1-datacatalog.googleapis.com Modelli di tag, voci create dagli utenti BigQuery
Hong Kong asia-east2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Tokyo asia-northeast1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Osaka asia-northeast2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Seul asia-northeast3-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Mumbai asia-south1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Delhi asia-south2-datacatalog.googleapis.com Modelli di tag, voci create dall'utente
Singapore asia-southeast1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Giacarta asia-southeast2-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Sydney australia-southeast1-datacatalog.googleapis.com Modelli di tag, BigQuery, voci create dall'utente
Melbourne australia-southeast2-datacatalog.googleapis.com Modelli di tag, voci create dall'utente
Più regioni Endpoint su più aree geografiche Risorse supportate
Globali global-datacatalog.googleapis.com Pub/Sub, Modelli di tag
Asia asia-datacatalog.googleapis.com BigQuery, modelli di tag, voci create dall'utente
Unione Europea eu-datacatalog.googleapis.com BigQuery, modelli di tag, voci create dall'utente
Stati Uniti us-datacatalog.googleapis.com BigQuery, modelli di tag, voci create dall'utente

Più aree geografiche (us, eu, global)

global è un'area geografica speciale, creata principalmente per gestire le risorse a cui non è associata una sola area geografica, ad esempio i metadati sincronizzati per gli argomenti Cloud Pub/Sub. Internamente, Data Catalog può replicare e gestire risorse globali in qualsiasi parte del mondo.

Analogamente, le aree geografiche multiple come eu e us sono aree geografiche speciali, in cui Data Catalog può replicare e pubblicare le risorse ovunque al loro interno.

Accesso alle risorse con le API a livello di area geografica

È possibile accedere alle risorse utilizzando endpoint a livello di area geografica (elencati sopra). Le librerie client ti consentono di configurare gli endpoint.

Per garantire la compatibilità con le versioni precedenti, le API a livello di area geografica sono ancora supportate dall'endpoint datacatalog.googleapis.com, con alcune limitazioni (vedi Batch HTTP e gRPC). Ti consigliamo vivamente di utilizzare endpoint a livello di area geografica per le API a livello di area geografica.

API non a livello di area geografica

Gli asset di dati si trovano in determinate aree geografiche, ma l'ambito delle funzionalità di ricerca di Data Catalog è globale. Le API non a livello di area geografica, come SearchCatalog e LookupEntry, restituiscono asset da tutte le aree geografiche e sono accessibili con l'endpoint datacatalog.googleapis.com.

Supporto batch HTTP

Data Catalog supporta il batch HTTP, che consente di raggruppare più chiamate API in una singola richiesta.

Esistono alcune limitazioni per l'utilizzo del batch HTTP per le API a livello di area geografica:

  • Una richiesta batch HTTP deve includere solo richieste API per le risorse appartenenti alla stessa area geografica.
  • Devi utilizzare endpoint a livello di area geografica durante il raggruppamento di API a livello di area geografica. datacatalog.googleapis.com non supporterà le API a livello di area geografica in batch. Le richieste a livello di area geografica e non regionali non possono essere raggruppate.
  • Le API non dipendenti dall'area geografica (SearchCatalog e LookupEntry) possono essere raggruppate utilizzando l'endpoint datacatalog.googleapis.com.

Se non sai se stai utilizzando il batch HTTP:

  • Controlla se stai inviando una richiesta HTTP con un percorso impostato su /batch, ad esempio http://datacatalog.googleapis.com/batch.
  • Se utilizzi la libreria client API di Google:

    • Java: utilizzando BatchRequest per le chiamate alle API.
    • Python: utilizzando la richiesta BatchHTTP per chiamare le API.
    • Le associazioni simili esistono per altre biblioteche (consulta la documentazione specifica della biblioteca).

Supporto gRPC

Gli endpoint a livello di area geografica sono il metodo consigliato per l'utilizzo di gRPC per le API a livello di area geografica.

Se utilizzi librerie gRPC create manualmente per effettuare chiamate all'endpoint datacatalog.googleapis.com, devi specificare un'intestazione x-google-request-params con un tag locations=<region> nella richiesta. Le librerie client di Google Cloud esistenti che utilizzano gRPC internamente hanno già questa funzionalità.