Kelola langganan

Dokumen ini menjelaskan cara mengelola langganan berbagi BigQuery Anda, yang mencakup tugas untuk pelanggan dan penayang.

Sebagai pelanggan berbagi BigQuery, Anda dapat melakukan hal berikut:

  • Berlangganan listingan.
  • Mencantumkan langganan Anda saat ini dalam Google Cloud project tertentu.
  • Menghapus langganan.

Sebagai penayang berbagi BigQuery, Anda dapat melakukan hal berikut:

  • Melihat semua langganan ke listingan Anda.
  • Mencabut akses ke langganan tertentu.

Langganan berbagi BigQuery adalah resource regional yang berada dalam project pelanggan. Langganan menyimpan informasi yang relevan tentang pelanggan dan mewakili kontrak antara penerbit dan pelanggan.

Sebelum memulai

Untuk mulai menggunakan berbagi BigQuery (sebelumnya Analytics Hub), Anda harus mengaktifkan Analytics Hub API di dalam project Google Cloud .

Untuk mengaktifkan Analytics Hub API, Anda memerlukan izin Identity and Access Management (IAM) berikut:

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Peran IAM bawaan berikut mencakup izin yang diperlukan untuk mengaktifkan Analytics Hub API:

Untuk mengaktifkan Analytics Hub API, pilih salah satu opsi berikut:

Konsol

Buka halaman Analytics Hub API dan aktifkan Analytics Hub API untuk project Google Cloud Anda.

Mengaktifkan Analytics Hub API

gcloud

Jalankan perintah gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola langganan, minta administrator untuk memberi Anda peran IAM Analytics Hub Subscription Owner (roles/analyticshub.subscriptionOwner) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Alur kerja pelanggan untuk mengelola langganan

Bagian berikut menjelaskan tindakan yang dapat dilakukan pelanggan yang berbagi BigQuery dengan langganan.

Berlangganan listingan

Untuk berlangganan listingan, ikuti langkah-langkah di bagian Melihat dan berlangganan listingan dan pertukaran data.

Mencantumkan langganan

Untuk mencantumkan langganan Anda saat ini dalam project tertentu, gunakan metode projects.locations.subscriptions.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID untuk langganan yang ingin Anda cantumkan.
  • LOCATION: lokasi untuk langganan yang ingin Anda cantumkan.

Menghapus langganan

Untuk menghapus langganan, gunakan metode projects.locations.subscriptions.delete:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID

Ganti kode berikut:

  • PROJECT_ID: project ID untuk langganan yang akan dihapus.
  • LOCATION: lokasi langganan yang akan dihapus. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung berbagi, lihat Region yang didukung.
  • SUBSCRIPTION_ID: ID langganan yang akan dihapus.

Isi permintaan harus kosong. Jika berhasil, isi respons akan berisi instance operasi.

Saat pelanggan yang berbagi BigQuery menghapus langganan, tindakan ini juga akan menghapus set data tertaut dari project pelanggan.

Jika Anda menghapus langganan dari listingan multiregion (Pratinjau), semua replika set data tertaut primer dan sekunder juga akan dihapus dari project pelanggan.

Untuk mengetahui informasi selengkapnya tentang tugas yang dapat Anda lakukan dengan langganan menggunakan API, lihat metode projects.locations.subscriptions.

Alur kerja penayang untuk mengelola langganan

Bagian berikut menjelaskan hal yang dapat dilakukan penayang berbagi BigQuery dengan langganan. Untuk mengetahui informasi selengkapnya tentang cara mengelola langganan listingan, lihat Mengelola listingan.

Mencantumkan langganan

Untuk mencantumkan semua langganan, pilih salah satu opsi berikut.

Konsol

  1. Di konsol Google Cloud , buka halaman Berbagi (Analytics Hub).

    Membuka Berbagi (Analytics Hub)

    Halaman ini mencantumkan semua pertukaran data yang dapat Anda akses.

  2. Klik nama pertukaran data tempat Anda ingin mencantumkan langganan.

  3. Klik tab Langganan untuk melihat semua langganan listingan dalam pertukaran data.

API

Untuk mencantumkan langganan listingan di pertukaran data tertentu, gunakan metode projects.locations.dataExchanges.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Ganti kode berikut:

  • PROJECT_ID: project ID pertukaran data yang langganannya akan dicantumkan.
  • LOCATION: lokasi pertukaran data yang langganannya ingin dicantumkan.
  • DATAEXCHANGE_ID: ID pertukaran data yang langganannya akan dicantumkan.

Mencabut langganan

Jika penayang berbagi BigQuery mencabut langganan, pelanggan tidak dapat lagi membuat kueri set data tertaut. Karena tindakan ini dimulai oleh penayang pada resource milik pelanggan, set data tertaut tetap berada di project pelanggan. Pelanggan dapat menghapus set data dengan menghapusnya.

Jika penayang mencabut langganan dari listingan multi-region (Pratinjau), pelanggan tidak dapat lagi membuat kueri replika set data tertaut primer atau sekunder.

Untuk mencabut langganan, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Berbagi (Analytics Hub).

    Membuka Berbagi (Analytics Hub)

    Halaman ini mencantumkan semua pertukaran data yang dapat Anda akses.

  2. Klik nama pertukaran data tempat Anda ingin mencabut listingan.

  3. Klik tab Langganan untuk melihat semua langganan untuk pertukaran data.

  4. Pilih langganan yang akan dibatalkan.

  5. Klik Cabut langganan.

API

Untuk mencabut langganan, gunakan metode projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Ganti kode berikut:

  • PROJECT_ID: project ID langganan yang akan dibatalkan.
  • LOCATION: lokasi langganan.
  • SUBSCRIPTION_ID: ID langganan yang akan dicabut.

Batasan

Langganan memiliki batasan berikut:

  • Anda hanya dapat menggunakan API untuk mengelola langganan yang dibuat setelah 25 Juli 2023. Set data tertaut yang dibuat sebelum tanggal ini tidak didukung karena tidak memiliki resource langganan yang diperlukan.

Langkah berikutnya