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, 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 |
* Dammam dispone di controlli di accesso specifici per regione descritti in questo documento.
Più regioni (eu, us)
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, Tracciabilità dei dati |
| Stati Uniti | us-datacatalog.googleapis.com |
BigQuery, modelli di tag, voci create dall'utente, Tracciabilità 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 |
Accedere alle risorse con API regionali
È possibile accedere alle risorse utilizzando gli endpoint regionali (consulta Regioni supportate). Le librerie client ti consentono di configurare gli endpoint.
Per la compatibilità con le versioni precedenti, le API regionali sono supportate dall'endpointdatacatalog.googleapis.com, con alcune limitazioni. Per ulteriori informazioni, consulta Supporto per i batch HTTP e Supporto per gRPC.
Ti consigliamo di utilizzare endpoint a livello di regione per le API regionali.
API non regionali
Sebbene gli asset di dati si trovino in regioni specifiche, la ricerca in Data Catalog ha 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 consente di raggruppare più chiamate API in un'unica richiesta.
Di seguito sono riportati alcuni vincoli relativi all'utilizzo di batch HTTP 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 non sai con certezza se utilizzi il batch HTTP, segui questi passaggi:
- 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.