Régions de Data Catalog

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 BigQuery
São Paulo southamerica-east1-datacatalog.googleapis.com BigQuery
Iowa us-central1-datacatalog.googleapis.com Modèles de tag, entrées créées par l'utilisateur
Caroline du Sud us-east1-datacatalog.googleapis.com BigQuery
Virginie du Nord us-east4-datacatalog.googleapis.com BigQuery
Oregon us-west1-datacatalog.googleapis.com Modèles de tag, entrées créées par l'utilisateur
Los Angeles us-west2-datacatalog.googleapis.com BigQuery
Europe
Finlande europe-north1-datacatalog.googleapis.com BigQuery
Belgique europe-west1-datacatalog.googleapis.com Modèles de tag, entrées créées par l'utilisateur
Londres europe-west2-datacatalog.googleapis.com BigQuery
Francfort europe-west3-datacatalog.googleapis.com BigQuery
Pays-Bas europe-west4-datacatalog.googleapis.com Modèles de tag, entrées créées par l'utilisateur
Zurich europe-west6-datacatalog.googleapis.com BigQuery
Asie-Pacifique
Taïwan asia-east1-datacatalog.googleapis.com BigQuery, modèles de tag, entrées créées par l'utilisateur
Hong Kong asia-east2-datacatalog.googleapis.com BigQuery
Tokyo asia-northeast1-datacatalog.googleapis.com BigQuery
Osaka asia-northeast2-datacatalog.googleapis.com BigQuery
Séoul asia-northeast3-datacatalog.googleapis.com BigQuery
Mumbai asia-south1-datacatalog.googleapis.com BigQuery
Singapour asia-southeast1-datacatalog.googleapis.com BigQuery
Sydney australia-southeast1-datacatalog.googleapis.com BigQuery
Multirégions Point de terminaison multirégional Ressources compatibles
Monde global-datacatalog.googleapis.com Pub/Sub, modèles de tag
Union européenne eu-datacatalog.googleapis.com BigQuery, modèles de tag, entrées créées par l'utilisateur
France us-datacatalog.googleapis.com BigQuery, modèles de tag, entrées créées par l'utilisateur

Emplacements multirégionaux (us, eu, global)

global est un emplacement multirégional spécial, créé principalement pour diffuser des ressources qui ne sont pas associées à une région unique (par exemple, les métadonnées synchronisées pour les sujets Pub/Sub cloud). En interne, Data Catalog peut être dupliqué gratuitement et diffuser des ressources partout dans le monde.

De même, 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.

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.com n'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.

Notez que certaines bibliothèques clientes Google Cloud utilisent gRPC en interne. Pour assurer la rétrocompatibilité, le point de terminaison datacatalog.googleapis.com est compatible avec les API régionales lors de l'utilisation de gRPC à partir de ces bibliothèques.