Data Catalog ospita risorse in più località in tutto il mondo, chiamate regioni. Una regione rappresenta una posizione geografica specifica in cui puoi accedere alle tue risorse. Per ulteriori informazioni, consulta Geografia e regioni.
Per ridurre la latenza della rete, ti consigliamo di utilizzare l'endpoint API per una regione vicino a dove prevedi di utilizzarla. 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 regione | Risorse supportate | |
|---|---|---|---|
| Africa | |||
| Johannesburg | africa-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Americhe | |||
| 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 | |
| Iowa | us-central1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Messico | northamerica-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente | |
| Montréal | northamerica-northeast1-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 | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| Salt Lake City | us-west3-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 | |
| San Paolo | southamerica-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Carolina del Sud | us-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| Asia Pacifico | |||
| Delhi | asia-south2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Hong Kong | asia-east2-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 | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| Mumbai | asia-south1-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, Genealogia dei dati | |
| Singapore | asia-southeast1-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, Genealogia dei dati | |
| Taiwan | asia-east1-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 | |
| Europa | |||
| Belgio | europe-west1-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 | |
| Finlandia | europe-north1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Francoforte | europe-west3-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Londra | europe-west2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Milano | europe-west8-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Paesi Bassi | europe-west4-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia dei dati | |
| Parigi | europe-west9-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, Genealogia dei dati | |
| Varsavia | europe-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Zurigo | europe-west6-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Medio Oriente | |||
| Dammam | me-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Doha | me-central1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia dei dati | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Genealogia 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 multi-regionale | Risorse supportate |
|---|---|---|
| Asia | asia-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, Gerarchia 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, Genealogia dei dati |
Regioni BigQuery Omni
| Regioni BigQuery Omni | Endpoint a livello di regione | Risorse supportate | |
|---|---|---|---|
| AWS | |||
| AWS - Asia Pacifico (Seul) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - Asia Pacifico (Sydney) | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - Europa (Francoforte) | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - Europa (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - Stati Uniti, costa orientale (Virginia del Nord) | aws-us-east-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni), Rintracciamento dei dati | |
| AWS - US West (Oregon) | aws-us-west-2-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), Rintracciamento 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 regionali (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
Sebbene gli asset di dati si trovino in regioni specifiche,
le funzionalità di ricerca di Data Catalog hanno un ambito globale. Le API non regionali come SearchCatalog e LookupEntry restituiscono asset di tutte le regioni e sono accessibili con l'endpoint datacatalog.googleapis.com.
Supporto per i batch HTTP
Data Catalog supporta il batch HTTP, che ti consente di raggruppare più chiamate API in un'unica richiesta.
Esistono alcuni vincoli per l'utilizzo di HTTP batch per le API regionali:
- Una richiesta batch HTTP deve includere solo richieste API per le risorse appartenenti alla stessa regione.
- Devi utilizzare endpoint regionali quando raggruppi le API regionali.
datacatalog.googleapis.comnon supporta le API regionali raggruppate. Le richieste regionali e non regionali non possono essere raggruppate. - Le API non dipendenti dalla regione (
SearchCatalogeLookupEntry) possono essere raggruppate insieme utilizzando l'endpointdatacatalog.googleapis.com.
Se hai dubbi sull'utilizzo del 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, controlla quanto segue:
- Java: utilizzo di BatchRequest per chiamare le API.
- Python: utilizzo della richiesta BatchHTTP per 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 all'endpoint datacatalog.googleapis.com, devi specificare un x-google-request-params header con un tag locations=<region> nella richiesta. Le librerie client di Cloud esistenti che utilizzano gRPC internamente hanno già specificato questo valore.