Kelola langganan

Anda dapat mengelola langganan di fitur berbagi BigQuery (sebelumnya Analytics Hub) untuk mengontrol akses dan berbagi data. Sebagai pelanggan, Anda dapat berlangganan listingan, melihat langganan, dan menghapusnya. Sebagai penayang, Anda dapat memantau siapa yang memiliki akses ke listingan Anda dan mencabut langganan sesuai kebutuhan. Langganan BigQuery sharing adalah resource regional yang berada dalam project pelanggan. Langganan menyimpan informasi 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.

Batasan

Langganan memiliki batasan berikut:

  • Anda hanya dapat menggunakan Analytics Hub 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.

Mengelola langganan sebagai pelanggan

Bagian berikut menjelaskan cara subscriber BigQuery sharing mengelola langganan.

Berlangganan listingan

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

Mencantumkan langganan

Untuk mencantumkan langganan Anda dalam project, panggil metode projects.locations.subscriptions.list:

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

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID dari project yang berisi langganan yang ingin Anda cantumkan.
  • LOCATION: lokasi langganan yang ingin Anda cantumkan. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung berbagi, lihat Wilayah yang didukung.

Memperbarui langganan

Pertukaran data atau ruang bersih data dapat menjadi tidak aktif saat penayang atau kontributor data menambahkan atau menghapus data. Jika hal ini terjadi, set data tertaut yang ada tidak akan otomatis diperbarui, dan Anda harus memperbarui langganan untuk mengakses resource baru.

Untuk memperbarui langganan, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, klik Tambahkan data.

  3. Pilih Berbagi (Analytics Hub). Halaman penemuan akan terbuka.

  4. Cari dan klik ruang bersih data atau pertukaran data yang Anda ikuti langganannya.

  5. Klik Langganan. Karena Anda sudah memiliki langganan yang aktif, konsol akan menampilkan opsi Muat Ulang.

  6. Klik Perbarui untuk memperbarui set data tertaut dengan resource terbaru.

API

Untuk memperbarui langganan, gunakan metode projects.locations.subscriptions.refresh:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:refresh

Ganti kode berikut:

  • PROJECT_ID: project ID untuk langganan yang ingin Anda perbarui.
  • LOCATION: lokasi langganan yang ingin Anda perbarui.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda perbarui.

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

Menghapus langganan

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

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

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID dari project yang berisi langganan yang ingin Anda hapus.
  • LOCATION: lokasi langganan yang ingin Anda hapus.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda hapus.

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

Saat Anda menghapus langganan, set data tertaut juga akan dihapus dari project Anda.

Jika Anda menghapus langganan dari listingan multi-region, semua replika set data tertaut primer dan sekunder juga akan dihapus dari project Anda.

Untuk mengetahui informasi selengkapnya tentang cara mengelola langganan menggunakan Analytics Hub API, lihat metode projects.locations.subscriptions.

Mengelola langganan sebagai penayang

Bagian berikut menjelaskan cara penayang BigQuery sharing mengelola 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 Sharing (Analytics Hub).

    Buka Berbagi (Analytics Hub)

    Halaman ini mencantumkan semua pertukaran data yang dapat Anda akses.

  2. Dalam daftar pertukaran data, klik nama pertukaran data yang berisi langganan yang ingin Anda cantumkan.

  3. Klik tab Langganan.

API

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

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

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID project yang berisi pertukaran data.
  • LOCATION: lokasi pertukaran data yang berisi langganan yang ingin Anda lihat dalam daftar.
  • DATAEXCHANGE_ID: ID pertukaran data yang langganannya akan dicantumkan.

Mencabut langganan

Saat Anda mencabut langganan sebagai penayang BigQuery sharing, pelanggan tidak dapat lagi membuat kueri set data tertaut. Karena Anda memulai tindakan ini pada resource milik pelanggan, set data tertaut tetap berada di project pelanggan. Pelanggan dapat menghapus set data dengan menghapusnya.

Saat Anda mencabut langganan dari listingan multi-region, 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 Sharing (Analytics Hub).

    Buka Berbagi (Analytics Hub)

    Halaman ini mencantumkan semua pertukaran data yang dapat Anda akses.

  2. Dalam daftar pertukaran data, klik nama pertukaran data yang berisi langganan yang ingin Anda batalkan.

  3. Klik tab Langganan.

  4. Centang kotak di samping setiap langganan yang ingin Anda batalkan.

  5. Klik Cabut langganan.

API

Untuk mencabut langganan, panggil metode projects.locations.subscriptions.revoke:

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

Ganti kode berikut:

  • PROJECT_ID: Google Cloud project ID project yang berisi langganan yang ingin Anda batalkan.
  • LOCATION: lokasi langganan yang ingin Anda batalkan.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda batalkan.

Langkah berikutnya