Data Catalog リージョン

Data Catalog のリソースは、リージョンという世界中の複数のロケーションでホストされています。リージョンとは、リソースにアクセスできる特定の地理的なロケーションです。詳細については、地域とリージョンをご覧ください。

ネットワーク レイテンシを減らすには、使用する予定のロケーションに近いリージョンで API エンドポイントを使用することをおすすめします。たとえば、アジアから Data Catalog にアクセスする場合は、台湾のエンドポイントを使用できます。

サポートされるリージョン

地域 リージョン エンドポイント サポートされているリソース
南北アメリカ
モントリオール northamerica-northeast1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
トロント northamerica-northeast2-datacatalog.googleapis.com タグ テンプレート、ユーザーが作成したエントリ
サンパウロ southamerica-east1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
アイオワ us-central1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
タルサ us-central2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
サウスカロライナ us-east1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
北バージニア us-east4-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
北バージニア aws-us-east-1-datacatalog.googleapis.comazure-eastus2-datacatalog.googleapis.com タグ テンプレート、BigQuery(現在は接続を除く)、ユーザーが作成したエントリ
オレゴン us-west1-datacatalog.googleapis.com タグ テンプレート、ユーザーが作成したエントリ
ロサンゼルス us-west2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ソルトレイクシティ us-west3-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ラスベガス us-west4-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ヨーロッパ
ワルシャワ europe-central2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
フィンランド europe-north1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ベルギー europe-west1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ロンドン europe-west2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
フランクフルト europe-west3-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
オランダ europe-west4-datacatalog.googleapis.com タグ テンプレート、ユーザーが作成したエントリ
チューリッヒ europe-west6-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
アジア太平洋
台湾 asia-east1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
香港 asia-east2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
東京 asia-northeast1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
大阪 asia-northeast2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ソウル asia-northeast3-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ムンバイ asia-south1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
デリー asia-south2-datacatalog.googleapis.com タグ テンプレート、ユーザーが作成したエントリ
シンガポール asia-southeast1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
ジャカルタ asia-southeast2-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
シドニー australia-southeast1-datacatalog.googleapis.com タグ テンプレート、BigQuery、ユーザーが作成したエントリ
メルボルン australia-southeast2-datacatalog.googleapis.com タグ テンプレート、ユーザーが作成したエントリ
Multi-region マルチリージョン エンドポイント サポートされているリソース
グローバル global-datacatalog.googleapis.com Pub/Sub、タグ テンプレート
アジア asia-datacatalog.googleapis.com BigQuery、タグ テンプレート、ユーザーが作成したエントリ
EU eu-datacatalog.googleapis.com BigQuery、タグ テンプレート、ユーザーが作成したエントリ
米国 us-datacatalog.googleapis.com BigQuery、タグ テンプレート、ユーザーが作成したエントリ

マルチリージョン(米国、欧州、グローバル)

global は特別なマルチリージョンであり、主に、関連付けられた単一のリージョンを持たないリソースにサービスを提供するために作成されます。たとえば、Cloud Pub/Sub トピックに対して同期されたメタデータです。内部的には、Data Catalog は世界中のどこにいてもグローバル リソースを複製して提供できます。

同様に、euus などのマルチリージョンは特別なリージョンであり、Data Catalog はリージョン内のどこにでもリソースを複製して提供できます。

リージョン API を使用したリソースへのアクセス

リソースには、リージョン エンドポイント(上記に記載)を使用してアクセスできます。クライアント ライブラリを使用すると、エンドポイントを構成できます。

下位互換性のために、リージョン API は引き続き datacatalog.googleapis.com エンドポイントでサポートされていますが、いくつかの制限があります(HTTP バッチと gRPC をご覧ください)。リージョン API にはリージョン エンドポイントを使用することを強くおすすめします。

非リージョン API

データアセットは特定のリージョンにありますが、Data Catalog の検索機能はグローバルにスコープされています。SearchCatalogLookupEntry などの非リージョン API は、すべてのリージョンからアセットを返し、datacatalog.googleapis.com エンドポイントでアクセスできます。

HTTP バッチサポート

Data Catalog は HTTP バッチをサポートしているため、複数の API 呼び出しを単一のリクエストにバッチ処理できます。

リージョン API に HTTP バッチを使用する場合は、いくつかの制約があります。

  • HTTP バッチ リクエストには、同じリージョンに属するリソースの API リクエストのみを含める必要があります。
  • リージョン API をバッチ処理する場合は、リージョン エンドポイントを使用する必要があります。datacatalog.googleapis.com は、バッチ処理されたリージョン API をサポートしません。リージョン リクエストと非リージョン リクエストを一緒にバッチ処理することはできません。
  • 非リージョン依存 API(SearchCatalog と LookupEntry)は、datacatalog.googleapis.com エンドポイントを使用して一緒にバッチ処理できます。

HTTP バッチを使用しているかどうかわからない場合:

  • http://datacatalog.googleapis.com/batch などのパスが /batch に設定された HTTP リクエストを直接作成しているかどうかを確認します。
  • Google API クライアント ライブラリを使用している場合:

    • Java: BatchRequest を使用して API を呼び出します。
    • Python: BatchHTTP リクエストを使用して API を呼び出します。
    • 他のライブラリにも同様のバインディングが存在します(ライブラリ固有のドキュメントをご覧ください)。

gRPC のサポート

リージョン エンドポイントは、リージョン API に gRPC を使用するための推奨される方法です。

手動で作成した gRPC ライブラリを使用して datacatalog.googleapis.com エンドポイントを呼び出す場合は、リクエストに locations=<region> タグを持つ x-google-request-params ヘッダーを指定する必要があります。gRPC を内部で使用する既存の Google Cloud クライアント ライブラリには、この機能がすでに実装されています。