Data Catalog のリソースは、リージョンという世界中の複数のロケーションでホストされています。リージョンとは、リソースにアクセスできる特定の地理的なロケーションです。詳細については、地域とリージョンをご覧ください。
ネットワーク レイテンシを減らすには、使用する予定のロケーションに近いリージョンで API エンドポイントを使用することをおすすめします。たとえば、アジアから Data Catalog にアクセスする場合は、台湾のエンドポイントを使用できます。
サポートされるリージョン
| リージョン | リージョン エンドポイント | サポートされているリソース | |
|---|---|---|---|
| 南北アメリカ | |||
| モントリオール | northamerica-northeast1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| トロント | northamerica-northeast2-datacatalog.googleapis.com |
タグ テンプレート、ユーザーが作成したエントリ、データリネージ | |
| サンパウロ | southamerica-east1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| サンチアゴ | southamerica-west1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| アイオワ | us-central1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| サウスカロライナ | us-east1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| 北バージニア | us-east4-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| コロンバス | us-east5-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| ダラス | us-south1-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、ユーザーが作成したエントリ、データリネージ | |
| ミラノ | europe-west8-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| パリ | europe-west9-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| ベルリン | europe-west10-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| チュリン | europe-west12-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| マドリッド | europe-southwest1-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 |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| シンガポール | asia-southeast1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| ジャカルタ | asia-southeast2-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| シドニー | australia-southeast1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| メルボルン | australia-southeast2-datacatalog.googleapis.com |
タグ テンプレート、ユーザーが作成したエントリ、データリネージ | |
| 中東 | |||
| ドーハ | me-central1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| Dammam | me-central2-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| テルアビブ | me-west1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ | |
| アフリカ | |||
| ヨハネスブルグ | africa-south1-datacatalog.googleapis.com |
タグ テンプレート、BigQuery、ユーザーが作成したエントリ、データリネージ |
マルチリージョン（us、eu）
eu や us などのマルチリージョンは特別なリージョンであり、Data Catalog はリージョン内のどこにでもリソースを複製して提供できます。
| マルチリージョン | マルチリージョン エンドポイント | サポートされているリソース |
|---|---|---|
| アジア | asia-datacatalog.googleapis.com |
タグ テンプレート、ユーザーが作成したエントリ、データリネージ |
| 欧州連合 | eu-datacatalog.googleapis.com |
BigQuery、タグ テンプレート、ユーザーが作成したエントリ、データリネージ |
| 米国 | us-datacatalog.googleapis.com |
BigQuery、タグ テンプレート、ユーザーが作成したエントリ、データリネージ |
BigQuery Omni リージョン
| BigQuery Omni リージョン | リージョン エンドポイント | サポートされているリソース | |
|---|---|---|---|
| AWS | |||
| AWS - US East（北バージニア） | aws-us-east-1-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| AWS 米国西部（オレゴン） | aws-us-west-2-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| AWS - アジア太平洋（ソウル） | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| AWS - アジア太平洋（シドニー） | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| AWS - ヨーロッパ（アイルランド） | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| AWS - ヨーロッパ（フランクフルト） | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| Azure | |||
| Azure - 米国東部 2（バージニア） | azure-eastus2-datacatalog.googleapis.com |
BigQuery（接続を除く）、データリネージ | |
| Azure - 米国西部 2（ワシントン） | azure-westus2-datacatalog.googleapis.com |
データリネージ |
リージョン API を使用したリソースへのアクセス
リソースには、リージョン エンドポイント（サポートされているリージョンで前述）を使用してアクセスできます。クライアント ライブラリを使用すると、エンドポイントを構成できます。
下位互換性のために、リージョン API は引き続き datacatalog.googleapis.com エンドポイントでサポートされていますが、いくつかの制限があります（HTTP バッチサポートと gRPC サポートをご覧ください）。リージョン API にはリージョン エンドポイントを使用することを強くおすすめします。
非リージョン API
データアセットは特定のリージョンにありますが、Data Catalog の検索機能はグローバルにスコープされています。SearchCatalog や LookupEntry などの非リージョン 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 クライアント ライブラリには、この機能がすでに実装されています。