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 puoi accedere alle tue risorse. Per ulteriori informazioni, consulta la sezione Area geografica e regioni.
Per ridurre la latenza di rete, ti consigliamo di utilizzare l'endpoint API per una regione vicina a quella in cui prevedi di utilizzarlo. 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 | |
|---|---|---|---|
| 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, derivazione dei dati | |
| San Paolo | southamerica-east1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione 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, Derivazione dei dati | |
| Virginia del Nord | us-east4-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Columbus | us-east5-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Dallas | us-south1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Virginia del Nord | aws-us-east-1-datacatalog.googleapis.com azure-eastus2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni) | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modelli di tag, voci create dall'utente, derivazione dei dati | |
| Oregon | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni) | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione 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, Derivazione dei dati | |
| Europa | |||
| Varsavia | europe-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Finlandia | europe-north1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Belgio | europe-west1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Irlanda | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (tranne le connessioni) | |
| 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, Derivazione dei dati | |
| Berlino | europe-west10-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente | |
| Torino | europe-west12-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione 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, Derivazione dei dati | |
| Tokyo | asia-northeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Osaka | asia-northeast2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Seul | asia-northeast3-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Seul | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (tranne le connessioni) | |
| 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, Derivazione dei dati | |
| Singapore | asia-southeast1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione dei dati | |
| Giacarta | asia-southeast2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente, Derivazione 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, derivazione dei dati | |
| Medio Oriente | |||
| Doha | me-central1-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente | |
| Dammam | me-central2-datacatalog.googleapis.com |
Modelli di tag, BigQuery, voci create dall'utente | |
| 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 |
| Più regioni | Endpoint a più regioni | 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, derivazione dei dati |
| Stati Uniti | us-datacatalog.googleapis.com |
BigQuery, modelli di tag, voci create dall'utente, derivazione dei dati |
| Regioni di BigQuery Omni | Endpoint a livello di regione | Risorse supportate |
|---|---|---|
| AWS Asia Pacifico (Seul) | aws-ap-northeast-2-datacatalog.googleapis.com |
Derivazione dei dati |
| AWS EU West (Irlanda) | aws-eu-west-1-datacatalog.googleapis.com |
Derivazione dei dati |
| AWS - Stati Uniti orientali (Virginia del Nord) | aws-us-east-1-datacatalog.googleapis.com |
Derivazione dei dati |
| AWS US occidentali (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
Derivazione dei dati |
| Azure - Stati Uniti orientali 2 (Virginia) | azure-eastus2-datacatalog.googleapis.com |
Derivazione dei dati |
Più regioni (us, eu)
Le regioni multiple come eu e us sono regioni speciali in cui Data Catalog può replicare e gestire risorse ovunque al loro interno.
Accesso alle risorse con le API a livello di regione
È possibile accedere alle risorse utilizzando gli endpoint a livello di regione (elencati in precedenza in Regioni supportate). Le librerie client consentono di configurare gli endpoint.
Per la compatibilità con le versioni precedenti, le API a livello di regione sono ancora supportate dall'endpoint datacatalog.googleapis.com, con alcune limitazioni (consulta
Supporto batch HTTP e Supporto gRPC). Ti consigliamo vivamente di utilizzare endpoint a livello di regione per le API a livello di regione.
API non regionali
Sebbene gli asset di dati si trovino in determinate regioni, le funzionalità di ricerca di Data Catalog hanno un ambito globale. Le API non regionali, come SearchCatalog e LookupEntry, restituiscono gli asset da tutte le regioni e sono accessibili tramite l'endpoint datacatalog.googleapis.com.
Supporto batch HTTP
Data Catalog supporta HTTP batch, consentendo di raggruppare più chiamate API in una singola richiesta.
Quando utilizzi il batch HTTP per le API a livello di regione, sono previsti alcuni vincoli:
- Una richiesta batch HTTP deve includere solo le richieste API per risorse appartenenti alla stessa regione.
- Devi utilizzare endpoint a livello di regione per il raggruppamento di API a livello di regione.
datacatalog.googleapis.comnon supporterà le API regionali in batch. Le richieste a livello di regione e non possono essere raggruppate insieme. - Le API non che dipendono dalla regione (SearchCatalog e LookupEntry) possono essere raggruppate, utilizzando l'endpoint
datacatalog.googleapis.com.
Se non sai con certezza se stai utilizzando la modalità batch HTTP:
- Verifica se stai effettuando direttamente una richiesta HTTP con un percorso impostato su
/batch, ad esempiohttp://datacatalog.googleapis.com/batch. Se utilizzi le librerie client delle API di Google:
- 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 a livello di regione sono il modo consigliato per utilizzare gRPC per le API a livello di regione.
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. Questa funzionalità è già implementata nelle librerie client Cloud esistenti che utilizzano gRPC internamente.