Data Catalog リージョン

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

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

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

地域 リージョン エンドポイント サポートされているリソース
南北アメリカ
モントリオール northamerica-northeast1-datacatalog.googleapis.com BigQuery
サンパウロ southamerica-east1-datacatalog.googleapis.com BigQuery
アイオワ us-central1-datacatalog.googleapis.com TagTemplates、ユーザーが作成したエントリ
サウスカロライナ us-east1-datacatalog.googleapis.com BigQuery
北バージニア us-east4-datacatalog.googleapis.com BigQuery
オレゴン us-west1-datacatalog.googleapis.com TagTemplates、ユーザーが作成したエントリ
ロサンゼルス us-west2-datacatalog.googleapis.com BigQuery
ヨーロッパ
フィンランド europe-north1-datacatalog.googleapis.com BigQuery
ベルギー europe-west1-datacatalog.googleapis.com TagTemplates、ユーザーが作成したエントリ
ロンドン europe-west2-datacatalog.googleapis.com BigQuery
フランクフルト europe-west3-datacatalog.googleapis.com BigQuery
オランダ europe-west4-datacatalog.googleapis.com TagTemplates、ユーザーが作成したエントリ
チューリッヒ europe-west6-datacatalog.googleapis.com BigQuery
アジア太平洋
台湾 asia-east1-datacatalog.googleapis.com BigQuery、TagTemplates、ユーザーが作成したエントリ
香港 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-southeast1-datacatalog.googleapis.com BigQuery
シドニー australia-southeast1-datacatalog.googleapis.com BigQuery
マルチリージョン マルチリージョン エンドポイント サポートされているリソース
グローバル global-datacatalog.googleapis.com Pub/Sub、TagTemplates
EU eu-datacatalog.googleapis.com BigQuery、TagTemplates、ユーザーが作成したエントリ
米国 us-datacatalog.googleapis.com BigQuery、TagTemplates、ユーザーが作成したエントリ

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

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 を使用するための推奨される方法です。

なお、一部の既存の Google Cloud クライアント ライブラリは内部で gRPC を使用しています。下位互換性のために、これらのライブラリから gRPC を使用する場合、datacatalog.googleapis.com エンドポイントはリージョン API をサポートします。