Cette page a été traduite par l'API Cloud Translation.

Régions de Data Catalog

Data Catalog héberge des ressources dans plusieurs emplacements à travers le monde, appelés régions. Une région est un emplacement géographique spécifique où vous pouvez accéder à vos ressources. Pour en savoir plus, consultez la page Zones géographiques et régions.

Pour réduire la latence du réseau, nous vous recommandons d'utiliser le point de terminaison de l'API pour une région proche de l'endroit où vous prévoyez de l'utiliser. Par exemple, si vous prévoyez d'accéder à Data Catalog depuis l'Asie, vous pouvez utiliser le point de terminaison pour Taïwan.

Régions où le service est disponible

	Région	Point de terminaison régional	Ressources compatibles
Afrique
	Johannesburg	`africa-south1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
Amériques
	Columbus	`us-east5-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Dallas	`us-south1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Iowa	`us-central1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Las Vegas	`us-west4-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Los Angeles	`us-west2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Mexique	`northamerica-south1-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur
	Montréal	`northamerica-northeast1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Virginie du Nord	`us-east4-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Oregon	`us-west1-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur, généalogie des données
	Salt Lake City	`us-west3-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Santiago	`southamerica-west1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	São Paulo	`southamerica-east1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Caroline du Sud	`us-east1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Toronto	`northamerica-northeast2-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur, généalogie des données
Asie-Pacifique
	Delhi	`asia-south2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Hong Kong	`asia-east2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Jakarta	`asia-southeast2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Melbourne	`australia-southeast2-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur, généalogie des données
	Mumbai	`asia-south1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Osaka	`asia-northeast2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Séoul	`asia-northeast3-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Singapour	`asia-southeast1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Sydney	`australia-southeast1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Taïwan	`asia-east1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Tokyo	`asia-northeast1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
Europe
	Belgique	`europe-west1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Berlin	`europe-west10-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Finlande	`europe-north1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Francfort	`europe-west3-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Londres	`europe-west2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Madrid	`europe-southwest1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Milan	`europe-west8-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Pays-Bas	`europe-west4-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur, généalogie des données
	Paris	`europe-west9-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Turin	`europe-west12-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Varsovie	`europe-central2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Zurich	`europe-west6-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
Moyen-Orient
	Dammam*	`me-central2-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Doha	`me-central1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données
	Tel-Aviv	`me-west1-datacatalog.googleapis.com`	Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données

* Dammam dispose de contrôles d'accès spécifiques à la région, décrits dans ce document.

Emplacements multirégionaux (eu, us)

Les emplacements multirégionaux tels que eu et us sont des régions spéciales, où Data Catalog peut être dupliqué gratuitement et diffuser des ressources n'importe où dans ces régions.

Multirégional	Point de terminaison multirégional	Ressources compatibles
Asie	`asia-datacatalog.googleapis.com`	Modèles de tag, entrées créées par l'utilisateur, généalogie des données
Union européenne	`eu-datacatalog.googleapis.com`	BigQuery, modèles de tag, entrées créées par l'utilisateur, lignée des données
États-Unis	`us-datacatalog.googleapis.com`	BigQuery, modèles de tag, entrées créées par l'utilisateur, lignée des données

Régions BigQuery Omni

	Régions BigQuery Omni	Point de terminaison régional	Ressources compatibles
AWS
	AWS – Asie-Pacifique (Séoul)	`aws-ap-northeast-2-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	AWS – Asie-Pacifique (Sydney)	`aws-ap-southeast-2-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	AWS – Europe (Francfort)	`aws-eu-central-1-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	AWS – Europe (Irlande)	`aws-eu-west-1-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	AWS Est des États-Unis (Virginie du Nord)	`aws-us-east-1-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	AWS Est des États-Unis (Oregon)	`aws-us-west-2-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
Azure
	Azure – Est des États-Unis 2 (Virginie)	`azure-eastus2-datacatalog.googleapis.com`	BigQuery (sauf les connexions), Lignée de données
	Azure – Ouest des États-Unis 2 (Washington)	`azure-westus2-datacatalog.googleapis.com`	Traçabilité des données

Accéder aux ressources avec des API régionales

Vous pouvez accéder aux ressources à l'aide de points de terminaison régionaux (voir la section Régions compatibles). Les bibliothèques clientes vous permettent de configurer des points de terminaison.

Pour assurer la rétrocompatibilité, les API régionales sont compatibles avec le point de terminaison datacatalog.googleapis.com, avec quelques limitations. Pour en savoir plus, consultez les pages Compatibilité avec les lots HTTP et Compatibilité avec gRPC. Nous vous recommandons d'utiliser des points de terminaison régionaux pour les API régionales.

API non régionales

Bien que les éléments de données soient situés dans des régions spécifiques, la recherche Data Catalog est globale. Les API non régionales, telles que SearchCatalog et LookupEntry, renvoient des éléments depuis toutes les régions et sont accessibles via le point de terminaison datacatalog.googleapis.com.

Compatibilité avec les requêtes HTTP par lot

Data Catalog accepte les requêtes HTTP par lot, ce qui vous permet de regrouper plusieurs appels d'API en une seule requête.

L'utilisation de requêtes HTTP par lot pour les API régionales présente certaines contraintes:

Une requête HTTP par lot ne doit inclure que des requêtes API pour les ressources appartenant à la même région.
Vous devez utiliser des points de terminaison régionaux lors du traitement par lot des API régionales. datacatalog.googleapis.com n'est pas compatible avec les API régionales par lot. Les requêtes régionales et non régionales ne peuvent pas être regroupées par lot.
Les API non régionales dépendantes (SearchCatalog et LookupEntry) peuvent être regroupées à l'aide du point de terminaison datacatalog.googleapis.com.

Si vous n'êtes pas certain d'utiliser les requêtes HTTP par lot, procédez comme suit:

Vérifiez si vous effectuez directement une requête HTTP avec un chemin défini sur /batch (par exemple, http://datacatalog.googleapis.com/batch).
Si vous utilisez les bibliothèques clientes des API Google, vérifiez les points suivants:
- Java: utilisez BatchRequest pour appeler des API.
- Python: utilisez la requête BatchHTTP pour appeler des API.
- Des associations similaires existent pour d'autres bibliothèques (consultez la documentation spécifique à ces bibliothèques).

Compatibilité avec gRPC

Les points de terminaison régionaux sont recommandés pour utiliser gRPC pour les API régionales.

Si vous appelez le point de terminaison datacatalog.googleapis.com à l'aide des bibliothèques gRPC créées manuellement, vous devez spécifier un en-tête x-google-request-params avec un tag locations=<region> dans la requête. Cette valeur est déjà spécifiée dans les bibliothèques clientes Cloud existantes qui utilisent gRPC en interne.