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, traçabilité des données | |
| Toronto | northamerica-northeast2-datacatalog.googleapis.com |
Modèles de tag, entrées créées par les utilisateurs, traçabilité 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, traçabilité 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, traçabilité des données | |
| Virginie du Nord | aws-us-east-1-datacatalog.googleapis.com, azure-eastus2-datacatalog.googleapis.com |
Modèles de tag, BigQuery (sauf les connexions), entrées créées par l'utilisateur | |
| Oregon | us-west1-datacatalog.googleapis.com |
Modèles de tag, entrées créées par les utilisateurs, traçabilité des données | |
| Oregon | aws-us-west-2-datacatalog.googleapis.com |
Modèles de tag, BigQuery (sauf les connexions), entrées créées par l'utilisateur | |
| Los Angeles | us-west2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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, traçabilité 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, traçabilité des données | |
| Irlande | aws-eu-west-1-datacatalog.googleapis.com |
Modèles de tag, BigQuery (sauf les connexions), entrées créées par l'utilisateur | |
| Londres | europe-west2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 les utilisateurs, traçabilité des données | |
| Zurich | europe-west6-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Milan | europe-west8-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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, entrées créées par l'utilisateur | |
| Turin | europe-west12-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur | |
| Madrid | europe-southwest1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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, traçabilité des données | |
| Tokyo | asia-northeast1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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 | |
| Séoul | aws-ap-northeast-2-datacatalog.googleapis.com |
Modèles de tag, BigQuery (sauf les connexions), entrées créées par l'utilisateur | |
| Mumbai | asia-south1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données | |
| Delhi | asia-south2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité 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, traçabilité des données | |
| Melbourne | australia-southeast2-datacatalog.googleapis.com |
Modèles de tag, entrées créées par les utilisateurs, 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 | |
| Dammam | me-central2-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur | |
| Tel Aviv | me-west1-datacatalog.googleapis.com |
Modèles de tag, BigQuery, entrées créées par l'utilisateur, traçabilité des données |
| Emplacement multirégional | Point de terminaison multirégional | Ressources compatibles |
|---|---|---|
| Asie | asia-datacatalog.googleapis.com |
Modèles de tag, entrées créées par les utilisateurs, traçabilité des données |
| Union européenne | eu-datacatalog.googleapis.com |
BigQuery, modèles de tag, entrées créées par l'utilisateur, traçabilité des données |
| États-Unis | us-datacatalog.googleapis.com |
BigQuery, modèles de tag, entrées créées par l'utilisateur, traçabilité des données |
| Régions BigQuery Omni | Point de terminaison régional | Ressources compatibles |
|---|---|---|
| AWS Asie-Pacifique (Séoul) | aws-ap-northeast-2-datacatalog.googleapis.com |
Traçabilité des données |
| AWS Ouest de l'UE (Irlande) | aws-eu-west-1-datacatalog.googleapis.com |
Traçabilité des données |
| AWS Est des États-Unis (Virginie du Nord) | aws-us-east-1-datacatalog.googleapis.com |
Traçabilité des données |
| AWS Ouest des États-Unis (Oregon) | aws-us-west-2-datacatalog.googleapis.com |
Traçabilité des données |
| Azure Est des États-Unis 2 (Virginie) | azure-eastus2-datacatalog.googleapis.com |
Traçabilité des données |
Emplacements multirégionaux (us, européenne)
Les emplacements multirégionaux tels que eu et us sont des régions spéciales, dans lesquelles Data Catalog peut répliquer et diffuser des ressources n'importe où dans ces régions.
Accéder aux ressources avec des API régionales
Vous pouvez accéder aux ressources à l'aide de points de terminaison régionaux (répertoriés ci-dessus). 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 quelques limitations (consultez les sections concernant la compatibilité avec les requêtes HTTP par lot et 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 la bibliothèque cliente des API Google :
- 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 fonctionnalité est déjà implémentée dans les bibliothèques clientes Google Cloud existantes qui utilisent gRPC en interne.