Berbagi streaming dengan Pub/Sub

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Untuk memberikan masukan atau mengajukan pertanyaan terkait fitur pratinjau ini, hubungi [e-mail].

Anda dapat membagikan topik Pub/Sub melalui Analytics Hub untuk menyeleksi dan mendistribusikan library data streaming di beberapa batas organisasi internal dan eksternal. Data streaming real-time dibagikan menggunakan listingan dan pertukaran Analytics Hub, sehingga Anda dapat mengategorikan dan mengelompokkan kumpulan besar topik Pub/Sub secara logis serta menyediakan akses dalam skala besar.

Anda dapat membagikan data streaming untuk melakukan hal berikut:

• Jasa keuangan:
  • Membagikan harga, penawaran harga, dan pesanan instrumen yang berubah dengan cepat secara real-time
  • Mendeteksi pencucian uang dan penipuan pembayaran
  • Mendukung penghitungan risiko perdagangan
• Retail dan barang konsumsi (CPG):
  • Membantu toko mengelola inventaris secara real time
  • Mempersonalisasi pemasaran dan dukungan pelanggan
  • Menyesuaikan harga secara dinamis
  • Memantau saluran media sosial
  • Mengoptimalkan tata letak toko fisik
• Layanan kesehatan:
  • Mendukung algoritma prediktif untuk memantau pasien dan menganalisis risiko secara real time
  • Memantau vitals dengan perangkat medis wearable
  • Akuisisi, penyusunan, penyimpanan, dan pemrosesan data otomatis dari pasien, tenaga kesehatan, dan administrasi fasilitas
• Telekomunikasi:
  • Meninjau kondisi jaringan dan memprediksi kegagalan
  • Menemukan pola perilaku pengguna untuk menemukan perangkat dan antena dengan lebih baik

Peran

Peran untuk membagikan topik Pub/Sub analog dengan berbagi set data BigQuery:

• Admin: pengguna yang mengelola izin, visibilitas, dan keanggotaan bursa dan listingan. Gunakan peran Admin Analytics Hub.
• Penerbit (topik bersama): pengguna yang membuat, mengelola, dan memberikan akses ke listingan topik Pub/Sub bersama. Gunakan peran Penayang Analytics Hub atau Admin Listingan Analytics Hub. Penayang yang dimaksud di sini adalah pengguna, bukan aplikasi penayang yang membuat dan mengirim pesan ke topik.
• Pelanggan (topik bersama): pengguna yang berlangganan listingan topik bersama. Pelanggan dapat mengonfigurasi cara pesan topik akan dikirim. Gunakan peran Pelanggan Analytics Hub atau peran Pemilik Langganan Analytics Hub. Bergantung pada cara data pesan dikirim, peran tambahan mungkin diperlukan (misalnya, izin akun layanan Pub/Sub untuk menulis pesan ke BigQuery).

Arsitektur

Diagram berikut menjelaskan cara publisher dan subscriber ke resource Pub/Sub berinteraksi dengan Analytics Hub:

Gambar 1. Alur kerja Penayang dan Pelanggan Analytics Hub dengan topik Pub/Sub.

Topik bersama

Topik bersama adalah unit berbagi topik Pub/Sub di Analytics Hub. Sebagai penayang, Anda membuat atau menggunakan topik Pub/Sub yang ada untuk mendistribusikan data pesan kepada subscriber. Analytics Hub tidak mereplikasi topik Pub/Sub sumber.

Listingan

Listingan dibuat saat penayang menambahkan topik bersama ke pertukaran. File ini berisi referensi ke topik yang dibagikan.

Pertukaran

Pertukaran adalah pengelompokan listingan yang merujuk pada topik bersama secara logis.

Langganan Pub/Sub tertaut

Saat berlangganan listingan dengan topik bersama, langganan Pub/Sub tertaut akan dibuat di project pelanggan. Langganan Pub/Sub juga ditampilkan di project Penayang sebagai langganan Pub/Sub dan langganan Listingan Analytics Hub.

Batasan

Berbagi streaming dengan Pub/Sub memiliki batasan berikut:

• Topik bersama dapat memiliki maksimum 10.000 langganan Pub/Sub. Batas ini mencakup langganan Pub/Sub tertaut dan langganan Pub/Sub yang dibuat di luar Analytics Hub, misalnya, langganan yang dibuat langsung dari Pub/Sub.
• Topik bersama diindeks di Data Catalog, tetapi Anda tidak dapat memfilter secara khusus untuk jenis resource-nya.
• Metrik penggunaan tidak dikumpulkan untuk langganan Pub/Sub tertaut di Analytics Hub. Anda dapat melihat metrik penggunaan di Pub/Sub.

Mengaktifkan Analytics Hub API

Untuk mengaktifkan Analytics Hub API, lakukan tindakan berikut:

Konsol

Buka library 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

Mengaktifkan Pub/Sub API

Buka library API dan aktifkan Pub/Sub API untuk project Google Cloud Anda.

Mengaktifkan Pub/Sub API

Alur kerja penayang

Sebagai penayang Analytics Hub, Anda dapat melakukan hal berikut:

• Menambahkan topik bersama ke bursa dengan membuat listingan
• Memperbarui listingan
• Menghapus listingan
• Membagikan listingan
• Mengelola langganan ke listingan Anda
• Menghapus pelanggan dari listingan Anda

Izin penayang tambahan

Untuk melakukan tugas penayang, Anda harus memiliki peran Penayang Analytics Hub (roles/analyticshub.publisher) di pertukaran atau listingan. Untuk melihat semua pertukaran data di seluruh project dalam organisasi yang dapat Anda akses, Anda harus memiliki izin resourcemanager.organizations.get.

Selain itu, Anda memerlukan izin pubsub.topics.setIamPolicy di topik Pub/Sub yang ingin Anda cantumkan. Untuk membagikan topik dengan skema yang dilampirkan, Anda harus memberikan izin pubsub.schemas.get kepada pelanggan Analytics Hub pada skema yang dilampirkan ke topik. Hal ini memungkinkan Pelanggan Analytics Hub mengurai pesan dari langganan Pub/Sub dengan benar.

Membuat listingan (untuk menambahkan topik bersama)

Untuk menambahkan topik bersama ke listingan, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

   Akan muncul halaman yang menampilkan daftar semua pertukaran data yang dapat Anda akses.

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

3. Klik Buat listingan.

4. Di halaman Buat listingan, pilih "Pub/Sub Topic" di drop-down Resource type.

5. Pilih topik Pub/Sub yang ada di dropdown Topik bersama, atau klik Buat topik.

6. Di halaman Listing details, di bagian Display name, masukkan nama listingan.

7. Masukkan detail opsional berikut:

   • Kategori: pilih hingga dua kategori yang paling mewakili listingan Anda. Pelanggan dapat memfilter listingan berdasarkan kategori ini.

   • Afinitas data: region yang digunakan oleh penayang untuk memublikasikan data. Informasi ini berguna bagi pelanggan untuk meminimalkan atau menghindari biaya traffic keluar jaringan Pub/Sub dengan membaca data dari region yang sama. Untuk mengetahui informasi selengkapnya tentang biaya traffic keluar, lihat Biaya transfer data.

   • Ikon: ikon untuk listingan Anda. Format file PNG dan JPEG didukung. Ikon harus memiliki ukuran file kurang dari 512 KiB dan dimensi tidak lebih dari 512 x 512 piksel.

   • Deskripsi: deskripsi singkat tentang listingan Anda. Pelanggan dapat menelusuri listingan berdasarkan deskripsi.

   • Keterlihatan Publik: mengaktifkan keterlihatan publik listingan Anda di katalog Analytics Hub. Anda juga harus menetapkan izin untuk listingan. Klik Tindakan bursa dan Setel izin. Berikan peran Analytics Hub Viewer kepada allUsers atau allAuthenticatedusers. Klik Izinkan Akses Publik.

   • Dokumentasi > Markdown: informasi tambahan seperti link ke dokumentasi yang relevan dan informasi tambahan yang dapat membantu pelanggan menggunakan topik Anda.

8. Di halaman Informasi kontak listingan, masukkan detail opsional berikut:

   • Kontak utama: masukkan email atau URL kontak utama untuk listingan.

   • Kontak permintaan akses: masukkan email atau URL formulir informasi agar pelanggan dapat menghubungi Anda.

   • Provider: perluas bagian Penyedia dan tentukan detail di kolom berikut:

     • Nama penyedia: nama penyedia topik.
     • Kontak utama penyedia: email atau URL kontak utama penyedia topik.

     Pelanggan dapat memfilter listingan berdasarkan penyedia data.

   • Publisher: perluas bagian Penayang dan tentukan detail di kolom berikut:

     • Nama penayang: nama penayang yang membuat listingan.
     • Kontak utama penayang: email atau URL kontak utama penayang topik.

9. Tinjau halaman Pratinjau listingan.

10. Klik Publikasikan.

API

Gunakan metode projects.locations.dataExchanges.listings.create .

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

Ganti kode berikut:

• PROJECT_ID: project ID yang berisi pertukaran data tempat Anda ingin membuat listingan.
• LOCATION: lokasi untuk pertukaran data Anda. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung Analytics Hub, lihat Region yang didukung.
• DATAEXCHANGE_ID: ID pertukaran data.
• LISTING_ID: ID listingan.

Dalam isi permintaan, berikan detail listingan. Jika permintaan berhasil, isi respons akan berisi detail listingan.

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan pada listingan menggunakan API, lihat metode projects.locations.dataExchanges.listings.

Memperbarui listingan

Untuk memperbarui listingan, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik nama pertukaran data yang berisi listingan.

3. Klik listingan yang ingin diperbarui.

4. Klik Edit listingan.

5. Mengubah nilai di kolom. Anda dapat mengubah semua nilai kecuali topik bersama listingan.

6. Untuk menyimpan perubahan, klik Publikasikan.

API

Gunakan metode projects.locations.dataExchanges.listings.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Ganti kode berikut:

• PROJECT_ID: project ID yang berisi pertukaran data tempat Anda ingin membuat listingan.
• LOCATION: lokasi untuk pertukaran data Anda. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung Analytics Hub, lihat Region yang didukung.
• DATAEXCHANGE_ID: ID pertukaran data.
• LISTING_ID: ID listingan.
• UPDATEMASK: daftar kolom yang ingin Anda perbarui. Untuk memperbarui beberapa nilai, gunakan daftar yang dipisahkan koma.

Dalam isi permintaan, tentukan nilai yang diperbarui.

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan pada listingan menggunakan API, lihat metode projects.locations.dataExchanges.listings.

Menghapus listingan

Listingan dengan topik Pub/Sub bersama tidak dapat dihapus dengan langganan aktif. Cabut semua langganan aktif sebelum mencoba menghapus listingan topik bersama. Setelah listingan dihapus, Anda tidak dapat mengurungkannya. Untuk menghapus listingan, pilih salah satu opsi berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik nama pertukaran data yang berisi listingan.

3. Klik listingan yang ingin dihapus.

4. Klik Delete.

5. Pada dialog Delete listing?, konfirmasi penghapusan dengan mengetik delete.

6. Klik Hapus.

API

Gunakan metode projects.locations.dataExchanges.listings.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

Ganti kode berikut:

• PROJECT_ID: project ID yang berisi pertukaran data tempat Anda ingin membuat listingan.
• LOCATION: lokasi untuk pertukaran data Anda. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung Analytics Hub, lihat Region yang didukung.
• DATAEXCHANGE_ID: ID pertukaran data.
• LISTING_ID: ID listingan.

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan pada listingan menggunakan API, lihat metode projects.locations.dataExchanges.listings.

Membagikan listingan

Jika ingin memberi pengguna akses ke listingan pribadi, Anda harus menetapkan kebijakan IAM untuk individu atau grup untuk listingan tersebut. Untuk listingan komersial, pertukaran data Anda harus bersifat publik. Listingan di pertukaran data publik muncul di Analytics Hub untuk semua pengguna Google Cloud (allAuthenticatedUsers). Agar pengguna dapat meminta akses untuk listingan komersial, Anda harus memberi pengguna peran Pelihat Analytics Hub.

Untuk memberikan akses kepada pengguna agar dapat melihat atau berlangganan listingan Anda, lakukan langkah-langkah berikut:

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik nama pertukaran data yang berisi listingan.

3. Klik listingan ke mana Anda ingin menambahkan pelanggan.

4. Klik Setel izin.

5. Untuk menambahkan akun utama, klik Add principal.

6. Di kolom Akun utama baru, tambahkan detail berikut berdasarkan jenis listingan:

   • Untuk listingan pribadi, masukkan email identitas yang ingin Anda beri akses.
   • Untuk listingan publik, tambahkan allAuthenticatedUsers.

7. Untuk Pilih peran, tahan kursor di atas Analytics Hub, lalu berdasarkan jenis listingan, pilih salah satu peran berikut:

   • Untuk listingan komersial, pilih peran Pelihat Analytics Hub. Peran ini memungkinkan pengguna melihat listingan dan meminta akses.
   • Untuk listingan publik pribadi atau non-komersial, pilih peran Pelanggan Analytics Hub. Peran ini memungkinkan pengguna berlangganan listingan Anda.

8. Klik Simpan.

Untuk mengetahui informasi selengkapnya, lihat peran Pelanggan dan Pelihat Analytics Hub.

Kelola langganan

Agar pengguna dapat berlangganan listingan dengan topik bersama, beri mereka peran Pelanggan Analytics Hub (roles/analyticshub.subscriber) dan Pemilik Langganan Analytics Hub (roles/analyticshub.subscriptionOwner) di listingan tertentu:

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik nama pertukaran data yang berisi listingan yang ingin Anda kelola langganannya.

3. Klik listingan tempat Anda ingin mencantumkan semua pelanggannya.

4. Klik Setel izin.

5. Untuk menambahkan akun utama, klik Add principal.

6. Di kolom New principals, masukkan nama pengguna atau email pelanggan yang ingin Anda tambahkan.

7. Untuk Pilih peran, pilih Analytics Hub > Pelanggan Analytics Hub.

8. Klik Add another role.

9. Untuk Pilih peran, pilih Analytics Hub > Pemilik Langganan Analytics Hub.

10. Klik Simpan.

Anda dapat menghapus dan memperbarui pelanggan kapan saja dengan mengklik Tetapkan Izin.

Mencabut langganan

Untuk menghapus langganan ke listingan topik bersama dari Analytics Hub, pilih salah satu opsi berikut:

Konsol

1. Untuk menampilkan daftar semua pelanggan listingan, ikuti petunjuk konsol Google Cloud di bagian Melihat semua langganan.

2. Klik tab Langganan untuk melihat semua langganan ke pertukaran data.

3. Centang kotak di samping langganan yang ingin dihapus, atau pilih semua langganan.

4. Di dialog Cabut langganan?, masukkan cabut untuk mengonfirmasi.

5. Klik Cabut.

API

Untuk menghapus 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 ingin Anda hapus.
• LOCATION: lokasi langganan.
• SUBSCRIPTION_ID: ID langganan yang ingin Anda hapus.

Dengan mencabut langganan dari Analytics Hub, pelanggan tidak akan lagi menerima data pesan dari topik bersama. Langganan Pub/Sub dilepaskan dari topik bersama. Jika langganan dihapus langsung dari Pub/Sub, langganan Analytics Hub akan tetap ada dan perlu dihapus.

Alur kerja pelanggan

Sebagai pelanggan Analytics Hub, Anda dapat melihat dan berlangganan listingan. Berlangganan listingan topik bersama akan membuat satu langganan Pub/Sub tertaut di project pelanggan. Langganan Pub/Sub akan terlihat di project penayang.

Izin pelanggan tambahan

Anda harus memiliki peran Pelanggan Analytics Hub (roles/analyticshub.subscriber) yang diberikan di tingkat project, pertukaran, atau listingan untuk melakukan tugas pelanggan.

Berlangganan listingan topik bersama

Untuk berlangganan listingan dengan topik yang sama, pilih salah satu opsi berikut:

Konsol

1. Untuk melihat daftar listingan yang dapat Anda akses, ikuti langkah-langkah di bagian Melihat listingan.

2. Jelajahi listingan dan klik listingan yang ingin Anda jadikan langganan. Dialog yang berisi detail listingan akan muncul.

3. Klik Berlangganan untuk membuka dialog Buat langganan.

4. Jika Anda belum mengaktifkan Analytics Hub API di project, pesan error akan muncul beserta link untuk mengaktifkan API. Klik Enable Analytics Hub API.

5. Pada dialog Create subscription, tentukan detail berikut:

   • ID Langganan: tentukan nama langganan yang Anda buat.
   • Jenis pengiriman: pilih mekanisme cara data pesan akan dikirim.
   • Durasi retensi pesan: tetapkan durasi retensi pesan.
   • Periode habis masa berlaku: ditetapkan saat langganan akan berakhir setelah tidak ada aktivitas, jika ada.
   • Batas waktu konfirmasi: menetapkan waktu batas waktu konfirmasi.
   • Filter langganan: menetapkan sintaksis filter pada pesan.
   • Pengiriman tepat satu kali: mengaktifkan pengiriman tepat satu kali.
   • Pengurutan pesan: mengaktifkan pengurutan pesan dengan kunci urutan.
   • Penghentian pengiriman: mengaktifkan penghentian pengiriman.
   • Kebijakan percobaan ulang: menetapkan kebijakan percobaan ulang.

   Untuk mengetahui informasi selengkapnya tentang properti langganan Pub/Sub, lihat properti langganan.

6. Untuk menyimpan perubahan, klik Buat. Langganan Pub/Sub tertaut dibuat di project Anda.

API

Gunakan metode projects.locations.dataExchanges.listings.subscribe.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

Ganti kode berikut:

• PROJECT_ID: project ID listingan yang ingin Anda jadikan langganan.
• LOCATION: lokasi untuk listingan yang Anda jadikan langganan.
• DATAEXCHANGE_ID: ID pertukaran data listingan yang Anda jadikan langganan.
• LISTING_ID: ID listingan yang ingin Anda jadikan langganan.

Dalam isi permintaan, tentukan langganan Pub/Sub tempat Anda ingin membuat langganan Pub/Sub tertaut. Jika berhasil, isi respons akan kosong.

Untuk mengetahui informasi selengkapnya tentang langganan Pub/Sub, lihat ringkasan langganan.

Harga

Tidak ada biaya tambahan bagi penayang topik Pub/Sub untuk mencantumkan dan membagikan topik melalui Analytics Hub. Penayang dikenai biaya untuk jumlah total byte yang ditulis (throughput publikasi) ke topik bersama dan traffic keluar jaringan (jika berlaku). Pelanggan ditagih untuk jumlah total byte yang dibaca (throughput langganan) dari langganan tertaut dan traffic keluar jaringan (jika berlaku). Lihat Harga Pub/Sub untuk mengetahui detail tambahan.

Kontrol Layanan VPC

Untuk topik bersama dari project yang memiliki perimeter Kontrol Layanan VPC, Anda dapat menetapkan aturan traffic masuk dan keluar yang sesuai yang diperlukan untuk memberikan akses kepada penayang dan pelanggan.