Region Data Catalog

Resource Data Catalog dihosting di beberapa lokasi di seluruh dunia, yang disebut wilayah. Region adalah lokasi geografis tertentu tempat Anda dapat mengakses resource Anda. Untuk informasi selengkapnya, lihat Geografi dan Wilayah.

Untuk mengurangi latensi jaringan, sebaiknya gunakan endpoint API untuk region yang dekat dengan tempat Anda berencana menggunakannya. Misalnya, jika Anda berencana mengakses Data Catalog dari Asia, Anda dapat menggunakan endpoint untuk Taiwan.

Region yang didukung

Region Endpoint regional Resource yang didukung
Amerika
Montréal northamerica-northeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Toronto northamerica-northeast2-datacatalog.googleapis.com Template tag, entri buatan pengguna, Silsilah data
Sao Paulo southamerica-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Santiago southamerica-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Iowa us-central1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
South Carolina us-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Northern Virginia us-east4-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Columbus us-east5-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Dallas us-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Northern Virginia aws-us-east-1-datacatalog.googleapis.com, azure-eastus2-datacatalog.googleapis.com
BigQuery (kecuali koneksi)
Oregon us-west1-datacatalog.googleapis.com Template tag, entri buatan pengguna, Silsilah data
Oregon aws-us-west-2-datacatalog.googleapis.com BigQuery (kecuali koneksi)
Los Angeles us-west2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Salt Lake City us-west3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Las Vegas us-west4-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Eropa
Warsawa europe-central2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Finlandia europe-north1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Belgia europe-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Irlandia aws-eu-west-1-datacatalog.googleapis.com BigQuery (kecuali koneksi)
London europe-west2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Frankfurt europe-west3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Belanda europe-west4-datacatalog.googleapis.com Template tag, entri buatan pengguna, Silsilah data
Zurich europe-west6-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Milan europe-west8-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Paris europe-west9-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Berlin europe-west10-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna
Turin europe-west12-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna
Madrid europe-southwest1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Asia Pasifik
Taiwan asia-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Hong Kong asia-east2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Tokyo asia-northeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Osaka asia-northeast2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Seoul asia-northeast3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Seoul aws-ap-northeast-2-datacatalog.googleapis.com BigQuery (kecuali koneksi)
Mumbai asia-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Delhi asia-south2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Singapura asia-southeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Jakarta asia-southeast2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Sydney australia-southeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Melbourne australia-southeast2-datacatalog.googleapis.com Template tag, entri buatan pengguna, Silsilah data
Timur Tengah
Doha me-central1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna
Dammam me-central2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna
Tel Aviv me-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Silsilah data
Afrika
Johannesburg africa-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna
Multi-region Endpoint multi-regional Resource yang didukung
Asia asia-datacatalog.googleapis.com Template tag, entri buatan pengguna, Silsilah data
Uni Eropa eu-datacatalog.googleapis.com BigQuery, Template tag, entri buatan pengguna, Silsilah data
Amerika Serikat us-datacatalog.googleapis.com BigQuery, Template tag, entri buatan pengguna, Silsilah data
Region BigQuery Omni Endpoint regional Resource yang didukung
AWS Asia Pasifik (Seoul) aws-ap-northeast-2-datacatalog.googleapis.com Silsilah data
AWS EU Barat (Irlandia) aws-eu-west-1-datacatalog.googleapis.com Silsilah data
AWS AS Timur (N. Virginia) aws-us-east-1-datacatalog.googleapis.com Silsilah data
AWS AS Barat (Oregon) aws-us-west-2-datacatalog.googleapis.com Silsilah data
Azure East AS 2 (Virginia) azure-eastus2-datacatalog.googleapis.com Silsilah data

Multi-region (AS, Uni Eropa)

Multi-region seperti eu dan us adalah region khusus, tempat Data Catalog dapat mereplikasi dan menyajikan resource di mana saja di dalamnya.

Mengakses resource dengan API regional

Resource dapat diakses menggunakan endpoint regional (tercantum sebelumnya di Region yang didukung). Library klien memungkinkan Anda mengonfigurasi endpoint.

Untuk kompatibilitas mundur, API regional masih didukung oleh endpoint datacatalog.googleapis.com, dengan beberapa batasan (lihat Dukungan batch HTTP dan dukungan gRPC). Anda sebaiknya menggunakan endpoint regional untuk API regional.

API non-regional

Meskipun aset data berada di wilayah tertentu, fitur penelusuran Data Catalog akan dicakup secara global. API non-regional seperti SearchCatalog dan LookupEntry menampilkan aset dari semua region, dan dapat diakses dengan endpoint datacatalog.googleapis.com.

Dukungan batch HTTP

Data Catalog mendukung batch HTTP, sehingga Anda dapat mengelompokkan beberapa panggilan API ke dalam satu permintaan.

Ada beberapa batasan saat menggunakan batch HTTP untuk API regional:

  • Permintaan batch HTTP hanya boleh menyertakan permintaan API untuk resource yang berada di region yang sama.
  • Anda harus menggunakan endpoint regional saat mengelompokkan API regional. datacatalog.googleapis.com tidak akan mendukung API regional batch. Permintaan regional dan non-regional tidak dapat dikelompokkan bersama.
  • API yang tidak bergantung pada region (SearchCatalog dan LookupEntry) dapat dikelompokkan bersama, menggunakan endpoint datacatalog.googleapis.com.

Jika Anda tidak yakin apakah menggunakan batch HTTP:

  • Periksa apakah Anda langsung membuat permintaan HTTP dengan jalur yang ditetapkan ke /batch, seperti http://datacatalog.googleapis.com/batch.
  • Jika Anda menggunakan Library Klien Google API:

    • Java: Menggunakan BatchRequest untuk memanggil API.
    • Python: Menggunakan permintaan BatchHTTP untuk memanggil API.
    • Binding serupa tersedia untuk library lainnya (lihat dokumentasi khusus library).

Dukungan gRPC

Endpoint regional adalah cara yang direkomendasikan untuk menggunakan gRPC untuk API regional.

Jika menggunakan library gRPC yang dibuat secara manual untuk melakukan panggilan ke endpoint datacatalog.googleapis.com, Anda harus menentukan header x-google-request-params dengan tag locations=<region> dalam permintaan. Library Klien Cloud yang sudah ada dan menggunakan gRPC secara internal telah menerapkan fungsi ini.