Questa pagina è stata tradotta dall'API Cloud Translation.

Regioni di Data Catalog

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

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 le 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 gli endpoint regionali 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.com non supporta 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 insieme utilizzando l'endpoint datacatalog.googleapis.com.

Se non sai con certezza se stai utilizzando il batch HTTP, segui questi passaggi:

Verifica di non inviare direttamente una richiesta HTTP con un percorso impostato su /batch, ad esempio http://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.