Mengelola langganan

Anda dapat mengelola langganan di BigQuery sharing (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 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 Google Cloud project.

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 Anda Google Cloud .

Mengaktifkan Analytics Hub API

gcloud

Jalankan perintah gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola langganan, minta administrator untuk memberi Anda peran IAM Pemilik Langganan Analytics Hub (roles/analyticshub.subscriptionOwner) pada 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 pelanggan BigQuery sharing mengelola langganan.

Berlangganan listingan

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

Mencantumkan langganan

Untuk mencantumkan langganan di 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 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 Region yang didukung.

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 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 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 Google Cloud konsol, buka halaman Berbagi (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 dalam 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 cantumkan.
  • 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 akan 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 Google Cloud konsol, buka halaman Berbagi (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 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