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 saja 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 penayang dan pelanggan.

Sebelum memulai

Untuk mulai menggunakan BigQuery Sharing (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 yang telah ditetapkan 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: project ID Google Cloud untuk 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 usang 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 Sharing (Analytics Hub). Halaman penemuan akan terbuka.

  4. Temukan dan klik ruang bersih data atau pertukaran data yang Anda berlangganan.

  5. Klik Langganan. Karena Anda sudah memiliki langganan aktif, konsol akan menampilkan opsi Refresh.

  6. Klik Muat ulang 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 muat ulang.
  • LOCATION: lokasi langganan yang ingin Anda muat ulang.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda muat ulang.

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.

Saat Anda menghapus langganan dari listingan multi-region, semua replika set data tertaut utama 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 penerbit

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 untuk 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: project ID Google Cloud dari project yang berisi pertukaran data.
  • LOCATION: lokasi pertukaran data yang berisi langganan yang ingin Anda cantumkan.
  • DATAEXCHANGE_ID: ID pertukaran data yang langganannya ingin dicantumkan.

Mencabut langganan

Jika Anda mencabut langganan sebagai publisher BigQuery sharing, pelanggan tidak dapat lagi mengkueri set data yang ditautkan. Karena Anda memulai tindakan ini pada resource milik pelanggan, set data tertaut akan tetap berada dalam 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 utama 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 cabut.

  3. Klik tab Langganan.

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

  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 dari project yang berisi langganan yang ingin Anda cabut.
  • LOCATION: lokasi langganan yang ingin Anda cabut.
  • SUBSCRIPTION_ID: ID langganan yang ingin Anda cabut.

Langkah berikutnya