Les ressources Data Catalog sont hébergées dans plusieurs emplacements à travers le monde, appelés régions. Une région est une emplacement géographique spécifique au sein duquel vous pouvez accéder à vos ressources. Pour plus d'informations, 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 | |
|---|---|---|---|
| Amériques | |||
| Montréal | northamerica-northeast1-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 | |
| São Paulo | southamerica-east1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Santiago | southamerica-west1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Iowa | us-central1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Caroline du Sud | us-east1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Columbus | us-east5-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modèles de tag, entrées créées par l'utilisateur, généalogie 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 | |
| Salt Lake City | us-west3-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Las Vegas | us-west4-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Europe | |||
| Varsovie | europe-central2-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, traçabilité des données | |
| Belgique | europe-west1-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 | |
| Francfort | europe-west3-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Pays-Bas | europe-west4-datacatalog.googleapis.com |
Modèles de tag, entrées créées par l'utilisateur, traçabilité 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 | |
| Milan | europe-west8-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données | |
| Paris | europe-west9-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Berlin | europe-west10-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Turin | europe-west12-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Asie-Pacifique | |||
| Taïwan | asia-east1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Tokyo | asia-northeast1-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, traçabilité des données | |
| Séoul | asia-northeast3-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Delhi | asia-south2-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, traçabilité des données | |
| Jakarta | asia-southeast2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Modèles de tag, entrées créées par l'utilisateur, traçabilité des données | |
| Moyen-Orient | |||
| Doha | me-central1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données | |
| Dammam | me-central2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Afrique | |||
| Johannesburg | africa-south1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, lignée des données |
| 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, traçabilité 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 | Point de terminaison régional | Ressources compatibles | |
|---|---|---|---|
| AWS | |||
| AWS Est des États-Unis (Virginie du Nord) | aws-us-east-1-datacatalog.googleapis.com |
BigQuery (à l'exception des connexions), traçabilité des données | |
| AWS Est des États-Unis (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
BigQuery (à l'exception des connexions), traçabilité des données | |
| AWS – Asie-Pacifique (Séoul) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery (sauf les connexions), Lignée des données | |
| AWS – Asie-Pacifique (Sydney) | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery (sauf les connexions), Lignée des données | |
| AWS – Europe West (Irlande) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery (à l'exception des connexions), traçabilité des données | |
| AWS – Europe (Francfort) | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery (sauf les connexions), Lignée des données | |
| Azure | |||
| Azure – Est des États-Unis 2 (Virginie) | azure-eastus2-datacatalog.googleapis.com |
BigQuery (à l'exception des connexions), traçabilité des données | |
| Azure – Ouest des États-Unis 2 (Washington) | azure-westus2-datacatalog.googleapis.com |
Traçabilité des données |
Emplacements multirégionaux (us, eu)
Les emplacements multirégionaux, tels que eu et us, sont des régions spéciales, où Data Catalog peut répliquer et diffuser des ressources n'importe où au sein de ces emplacements.
Accéder aux ressources avec des API régionales
Vous pouvez accéder aux ressources à l'aide de points de terminaison régionaux (listés précédemment dans la section Régions acceptées). Les bibliothèques clientes vous permettent de configurer des points de terminaison.
Pour assurer la rétrocompatibilité, les API régionales sont toujours compatibles avec le point de terminaison datacatalog.googleapis.com, avec certaines limites (voir
compatibilité HTTP par lot et compatibilité gRPC). Il est fortement recommandé 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, les fonctionnalités de recherche de Data Catalog sont globalement limitées. 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.comn'accepte pas 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 Bibliothèques clientes des API Google:
- Java : utilisez BatchRequest pour appeler des API.
- Python : utilisez la requête BatchHTTP pour appeler des API.
- Des liaisons similaires existent pour d'autres bibliothèques (voir la documentation spécifique à la bibliothèque).
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 fonctionnalité est déjà implémentée dans les bibliothèques clientes Cloud existantes qui utilisent gRPC en interne.