Region Data Catalog

Data Catalog menghosting resource di beberapa lokasi di seluruh dunia yang disebut region. Region adalah lokasi geografis spesifik tempat Anda dapat mengakses resource. Untuk mengetahui informasi selengkapnya, lihat Geografi dan wilayah.

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

Region yang didukung

Wilayah Endpoint regional Resource yang didukung
Afrika
Johannesburg africa-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Amerika
Columbus us-east5-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Dallas us-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Iowa us-central1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Las Vegas us-west4-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Los Angeles us-west2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Meksiko northamerica-south1-datacatalog.googleapis.com Template tag, entri buatan pengguna
Montréal northamerica-northeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Northern Virginia us-east4-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Oregon us-west1-datacatalog.googleapis.com Template tag, entri yang dibuat pengguna, Linimasa data
Salt Lake City us-west3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Santiago southamerica-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Sao Paulo southamerica-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
South Carolina us-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Toronto northamerica-northeast2-datacatalog.googleapis.com Template tag, entri yang dibuat pengguna, Linimasa data
Asia Pasifik
Delhi asia-south2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Hong Kong asia-east2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Jakarta asia-southeast2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Melbourne australia-southeast2-datacatalog.googleapis.com Template tag, entri yang dibuat pengguna, Linimasa data
Mumbai asia-south1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Osaka asia-northeast2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Seoul asia-northeast3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Singapura asia-southeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Sydney australia-southeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Taiwan asia-east1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Tokyo asia-northeast1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Eropa
Belgia europe-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Berlin europe-west10-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Finlandia europe-north1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Frankfurt europe-west3-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
London europe-west2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Madrid europe-southwest1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Milan europe-west8-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Belanda europe-west4-datacatalog.googleapis.com Template tag, entri yang dibuat pengguna, Linimasa data
Paris europe-west9-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Turin europe-west12-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Warsawa europe-central2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Zurich europe-west6-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Timur Tengah
Dammam me-central2-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Doha me-central1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data
Tel Aviv me-west1-datacatalog.googleapis.com Template tag, BigQuery, entri buatan pengguna, Linimasa data

Multi-region (eu, us)

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

Multi-region Endpoint multi-regional Resource yang didukung
Asia asia-datacatalog.googleapis.com Template tag, entri yang dibuat pengguna, Linimasa data
Uni Eropa eu-datacatalog.googleapis.com BigQuery, template tag, entri buatan pengguna, Linimasa data
Amerika Serikat us-datacatalog.googleapis.com BigQuery, template tag, entri buatan pengguna, Linimasa data

Region BigQuery Omni

Region BigQuery Omni Endpoint regional Resource yang didukung
AWS
AWS - Asia Pasifik (Seoul) aws-ap-northeast-2-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
AWS - Asia Pasifik (Sydney) aws-ap-southeast-2-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
AWS - Eropa (Frankfurt) aws-eu-central-1-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
AWS - Eropa (Irlandia) aws-eu-west-1-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
AWS - AS Timur (N. Virginia) aws-us-east-1-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
AWS - AS Barat (Oregon) aws-us-west-2-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
Azure
Azure - AS Timur 2 (Virginia) azure-eastus2-datacatalog.googleapis.com BigQuery (kecuali koneksi), Linimasa data
Azure - AS Barat 2 (Washington) azure-westus2-datacatalog.googleapis.com Silsilah data

Mengakses resource dengan API regional

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

Untuk kompatibilitas mundur, API regional didukung oleh endpoint datacatalog.googleapis.com, dengan beberapa batasan. Untuk informasi selengkapnya, lihat dukungan batch HTTP dan dukungan gRPC. Sebaiknya gunakan endpoint regional untuk API regional.

API non-regional

Meskipun aset data berada di region tertentu, penelusuran Data Catalog memiliki cakupan 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, yang memungkinkan Anda mengelompokkan beberapa panggilan API ke dalam satu permintaan.

Berikut adalah 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 mendukung API regional dalam batch. Permintaan regional dan non-regional tidak dapat dikelompokkan bersama.
  • API yang tidak bergantung pada wilayah (SearchCatalog dan LookupEntry) dapat dikelompokkan bersama, menggunakan endpoint datacatalog.googleapis.com.

Jika Anda tidak yakin apakah Anda menggunakan batch HTTP, lakukan hal berikut:

  • 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, periksa hal berikut:

    • Java: menggunakan BatchRequest untuk memanggil API.
    • Python: menggunakan permintaan BatchHTTP untuk memanggil API.
    • Binding serupa ada untuk library lain (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 ada dan menggunakan gRPC secara internal telah menentukan hal ini.