Le risorse di Data Catalog sono ospitate in diverse località in tutto il mondo, chiamate regioni. Una regione rappresenta una posizione geografica specifica in cui per accedere alle tue risorse. Per ulteriori informazioni, consulta Geografia e regioni.
Per ridurre la latenza di rete, ti consigliamo di utilizzare l'endpoint API per una regione vicino a dove prevedi di usarla. Ad esempio, se prevedi di accedere al Catalogo dei dati dall'Asia, puoi utilizzare l'endpoint per Taiwan.
Aree geografiche supportate
| Regione | Endpoint a livello di regione | Risorse supportate | |
|---|---|---|---|
| Americhe | |||
| Montréal | northamerica-northeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| San Paolo | southamerica-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Iowa | us-central1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Carolina del Sud | us-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Virginia del Nord | us-east4-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Columbus | us-east5-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Dallas | us-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, derivazione dei dati | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Salt Lake City | us-west3-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Europa | |||
| Varsavia | europe-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Finlandia | europe-north1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Belgio | europe-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Londra | europe-west2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Francoforte | europe-west3-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Paesi Bassi | europe-west4-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, derivazione dei dati | |
| Zurigo | europe-west6-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Milano | europe-west8-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Parigi | europe-west9-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Berlino | europe-west10-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Torino | europe-west12-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Asia Pacifico | |||
| Taiwan | asia-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Hong Kong | asia-east2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Tokyo | asia-northeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Osaka | asia-northeast2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Seul | asia-northeast3-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Mumbai | asia-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Delhi | asia-south2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Singapore | asia-southeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Giacarta | asia-southeast2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Sydney | australia-southeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| Medio Oriente | |||
| Doha | me-central1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Dammam | me-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati | |
| Africa | |||
| Johannesburg | africa-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, derivazione dei dati |
Più regioni (us, eu)
Le regioni multiple come eu e us sono regioni speciali in cui Data Catalog può replicare e pubblicare risorse in qualsiasi punto al loro interno.
| Più regioni | Endpoint multiregionale | Risorse supportate |
|---|---|---|
| Asia | asia-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, derivazione dei dati |
| Unione Europea | eu-datacatalog.googleapis.com |
BigQuery, Modelli di tag, voci create dall'utente, Genealogia dei dati |
| Stati Uniti | us-datacatalog.googleapis.com |
BigQuery, modelli di tag, voci create dall'utente, derivazione dei dati |
Regioni BigQuery Omni
| Regioni BigQuery Omni | Endpoint a livello di regione | Risorse supportate | |
|---|---|---|---|
| AWS | |||
| AWS - Stati Uniti, costa orientale (Virginia del Nord) | aws-us-east-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Derivazione dei dati | |
| AWS - Stati Uniti occidentali (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - Asia Pacifico (Seul) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Derivazione dei dati | |
| AWS - Asia Pacifico (Sydney) | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Derivazione dei dati | |
| AWS - Europa (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Derivazione dei dati | |
| AWS - Europa (Francoforte) | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| Azure | |||
| Azure - Stati Uniti orientali 2 (Virginia) | azure-eastus2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Derivazione dei dati | |
| Azure - Stati Uniti occidentali 2 (Washington) | azure-westus2-datacatalog.googleapis.com |
Derivazione dei dati |
Accesso alle risorse con API regionali
È possibile accedere alle risorse utilizzando gli endpoint a livello di regione (elencati in precedenza in Regioni supportate). Le librerie client ti consentono di configurare gli endpoint.
Per la compatibilità con le versioni precedenti, le API regionali sono ancora supportate dall'endpointdatacatalog.googleapis.com, con alcune limitazioni (consulta Supporto batch HTTP e Supporto gRPC).
Ti consigliamo vivamente di utilizzare gli endpoint regionali per le API regionali.
API non regionali
Anche se gli asset di dati
si trovano in determinate regioni,
Le funzionalità di ricerca di Data Catalog hanno un ambito globale. Non a livello di regione
Le API come SearchCatalog e LookupEntry restituiscono asset di tutte le regioni,
ed è accessibile con l'endpoint datacatalog.googleapis.com.
Supporto batch HTTP
Data Catalog supporta HTTP batch, che permette di eseguire in batch più chiamate API in una singola richiesta.
Esistono alcuni vincoli quando si utilizza il batch HTTP per le API a livello di regione:
- Una richiesta batch HTTP deve includere solo richieste API per le risorse che appartengono nella stessa regione.
- Devi usare endpoint a livello di regione quando esegui il batch di API a livello di regione.
datacatalog.googleapis.comnon supporterà le API regionali raggruppate. Le richieste regionali e non regionali non possono essere raggruppate. - Le API non dipendenti dalla regione (SearchCatalog e LookupEntry) possono essere raggruppate
usando l'endpoint
datacatalog.googleapis.com.
Se non hai la certezza di utilizzare il batch HTTP:
- Verifica di non inviare direttamente una richiesta HTTP con un percorso impostato su
/batch, ad esempiohttp://datacatalog.googleapis.com/batch. Se utilizzi le librerie client dell'API di Google:
- Java: utilizzo di BatchRequest per chiamare le API.
- Python: utilizzo BatchHTTP di chiamare le API.
- Esistono associazioni simili per altre librerie (consulta la documentazione specifica della libreria).
Supporto gRPC
Gli endpoint regionali sono il modo consigliato per utilizzare gRPC per le API regionali.
Se utilizzi librerie gRPC create manualmente per effettuare chiamate al
Endpoint datacatalog.googleapis.com, devi specificare un valore x-google-request-params
con un tag locations=<region> nella richiesta. L'attuale
Librerie client di Cloud
che utilizzano gRPC internamente hanno già implementato questa funzionalità.