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

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 des données
AWS Est des États-Unis (Oregon) aws-us-west-2-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 (sauf les connexions), Lignée des 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 où le service est disponible). 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.