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.

Penting: Data Catalog tidak menjamin ketersediaan atau keandalan yang lebih tinggi untuk multi-region dibandingkan dengan region Google Cloud lainnya. Multi-region harus diperlakukan seperti wilayah lain.

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.

Penting: API non-regional tidak dapat digunakan dari endpoint regional.

Dukungan batch HTTP

Catatan: Library Klien Cloud standar menggunakan gRPC (dan tidak mendukung batch HTTP). Jika menggunakan library ini, Anda dapat mengabaikan bagian ini.

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.