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
, sepertihttp://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.