Mengelola listingan

Sebagai penayang Analytics Hub, Anda dapat melakukan tugas berikut:

• Membuat listingan di pertukaran data yang akses publikasinya Anda miliki.
• Memperbarui, menghapus, membagikan, dan melihat metrik penggunaan untuk listingan.
• Mengelola berbagai peran untuk listingan Analytics Hub Anda, seperti administrator listingan, pelanggan, dan pelihat.
• Melihat semua pelanggan yang berlangganan listingan Anda.
• Memantau penggunaan listingan Anda.
• Menghapus pelanggan dari listingan Anda.

Listingan adalah referensi ke set data bersama yang dicantumkan penayang di pertukaran data. Listingan dapat berupa dari dua jenis berikut berdasarkan kebijakan Identity and Access Management (IAM) yang ditetapkan untuk listingan dan jenis pertukaran data yang berisi listingan:

• Listingan publik. ID ini dapat ditemukan dan dijadikan langganan oleh pengguna Google Cloud (allAuthenticatedUsers). Listingan dalam pertukaran data publik adalah listingan publik. Listingan ini dapat menjadi referensi ke set data publik gratis atau set data komersial. Jika listingan berasal dari set data komersial, pelanggan dapat meminta akses ke listingan dan penyedia data akan menghubungi pelanggan tersebut.

• Listingan pribadi. Listingan ini dibagikan langsung kepada individu atau kelompok. Misalnya, listingan pribadi dapat mereferensikan set data metrik pemasaran yang Anda bagikan kepada tim internal lain dalam organisasi Anda. Meskipun Anda dapat mengizinkan allAuthenticatedUsers untuk berlangganan listingan Anda, listingan akan tetap bersifat pribadi dan tidak akan ditampilkan sebagai listingan publik di halaman Analytics Hub. Untuk membagikan listingan tersebut kepada pengguna, bagikan URL listingan kepada mereka. Agar listingan pribadi dapat ditemukan, Anda harus menjadikan pertukaran Anda publik.

Sebelum memulai

Untuk mulai menggunakan Analytics Hub, Anda harus mengaktifkan Analytics Hub API di dalam project Google Cloud.

Izin yang diperlukan

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 Anda perlukan untuk mengaktifkan Analytics Hub API:

• roles/serviceusage.serviceUsageAdmin

Untuk informasi selengkapnya tentang peran IAM di BigQuery, lihat Peran dan izin bawaan.

Mengaktifkan Analytics Hub API

Untuk mengaktifkan Analytics Hub API, lakukan tindakan berikut:

Konsol

Buka Analytics Hub API untuk project Google Cloud Anda, lalu aktifkan.

Mengaktifkan Analytics Hub API

gcloud

Jalankan perintah gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Izin yang diperlukan

Untuk mengelola listingan dan langganan, Anda harus memiliki salah satu peran Analytics Hub berikut:

• Peran Penayang Analytics Hub (roles/analyticshub.publisher), yang memungkinkan Anda membuat, memperbarui, menghapus, dan menetapkan kebijakan IAM di listingan Anda.

• Peran Admin Listingan Analytics Hub (roles/analyticshub.listingAdmin), yang memungkinkan Anda memperbarui, menghapus, dan menetapkan kebijakan IAM di listingan Anda.

• Peran Admin Analytics Hub (roles/analyticshub.Admin), yang memungkinkan Anda membuat, memperbarui, menghapus, dan menetapkan kebijakan IAM pada semua listingan di pertukaran data Anda.

Untuk mengetahui informasi selengkapnya, lihat peran pengguna Analytics Hub. Untuk mempelajari cara memberikan peran ini kepada pengguna lain, lihat Membuat administrator listingan.

Selain itu, untuk membuat listingan, Anda juga harus memiliki izin bigquery.datasets.get dan bigquery.datasets.update untuk set data yang listingannya ingin Anda buat. Peran BigQuery yang telah ditetapkan berikut berisi izin bigquery.datasets.update:

• Peran Pemilik Data BigQuery (roles/bigquery.dataOwner)
• Peran Admin BigQuery (roles/bigquery.admin)

Untuk melihat semua pertukaran data di seluruh project dalam organisasi yang dapat Anda akses, Anda harus memiliki izin resourcemanager.organizations.get. Tidak ada peran BigQuery yang telah ditetapkan yang berisi izin ini, sehingga Anda harus menggunakan peran khusus IAM.

Melihat pertukaran data

Untuk melihat daftar pertukaran data di organisasi yang dapat Anda akses, lihat Melihat pertukaran data. Jika pertukaran data berada di organisasi lain, administrator Analytics Hub harus membagikan link ke pertukaran data tersebut dengan Anda.

Membuat listingan

Listingan adalah referensi ke set data bersama yang dicantumkan penayang di pertukaran data.

Perhatian: Sebaiknya jangan tambahkan set data bersama dalam project dengan perimeter Kontrol Layanan VPC. Jika melakukannya, Anda harus menambahkan aturan masuk dan keluar yang sesuai.

Untuk membuat listingan, ikuti langkah-langkah 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, di bagian Nama tampilan, masukkan nama listingan.

5. Jika membuat set data komersial, Anda harus mengisi kolom Minta kontak akses. Anda harus memasukkan email atau URL formulir informasi agar pelanggan dapat menghubungi Anda.

6. Opsional: Masukkan detail berikut:

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

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

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

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

     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 set 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.

7. Di Set data sumber, pilih set data yang ingin Anda cantumkan di pertukaran data. Set data sumber harus berada di region yang sama dengan pertukaran data. Anda tidak dapat memperbarui kolom ini setelah listingan dibuat.

   Penting: Nama set data sumber dan ID project yang berisi set data akan ditampilkan saat pelangganmelihat metadata dari set data yang tertaut.

8. Di bagian Traffic Keluar Data (pratinjau), pilih opsi traffic keluar data yang sesuai. Hanya pelanggan dengan penawaran non-edisi atau edisi Enterprise Plus yang dapat mengkueri data dengan pembatasan traffic keluar data.

   • Untuk menerapkan pembatasan traffic keluar data di set data bersama, tetapi tidak pada hasil kueri dari set data bersama, pilih Nonaktifkan penyalinan dan ekspor data bersama.
   • Untuk menerapkan pembatasan traffic keluar data pada set data bersama dan hasil kueri set data bersama, pilih Nonaktifkan penyalinan dan ekspor hasil kueri, yang akan otomatis menetapkan Nonaktifkan penyalinan dan ekspor data bersama juga.

9. Opsional: Di bagian Dokumentasi > Markdown, Anda dapat memasukkan informasi tambahan seperti contoh kueri yang dapat dijalankan di set data, link ke dokumentasi yang relevan, dan informasi tambahan yang dapat membantu pelanggan untuk menggunakan set data Anda.

10. Klik Save.

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 mengetahui informasi selengkapnya tentang tugas yang dapat Anda lakukan di listingan menggunakan API, lihat metode projects.locations.dataExchanges.listings.

Memberi pengguna akses ke 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, ikuti langkah-langkah berikut:

Konsol

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 Tambahkan akun utama.

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 Analytics Hub Subscriber. Peran ini memungkinkan pengguna berlangganan listingan Anda.

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

8. Klik Save.

API

1. Baca kebijakan yang ada dengan mencantumkan metode getIamPolicy menggunakan metode projects.locations.dataExchanges.listings.getIamPolicy.

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

   Ganti kode berikut:

   • PROJECT_ID: project ID—misalnya, my-project-1.
   • LOCATION: lokasi pertukaran data yang berisi listingan.
   • DATAEXCHANGE_ID: ID pertukaran data.
   • LISTING_ID: ID listingan.

   Analytics Hub menampilkan kebijakan saat ini dalam respons.

2. Untuk menambahkan atau menghapus anggota dan peran terkait, edit kebijakan dengan editor teks. Gunakan format berikut untuk menambahkan anggota:

   • user:[e-mail]
   • group:[e-mail]
   • serviceAccount:[e-mail]
   • domain:example.domain.com

   Misalnya, untuk memberikan peran roles/analyticshub.subscriber ke group:[e-mail], tambahkan binding berikut ke kebijakan:

   {
    "members": [
      "group:[e-mail]"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Tulis kebijakan yang telah diperbarui menggunakan metode projects.locations.dataExchanges.listings.setIamPolicy. Dalam isi permintaan, berikan kebijakan IAM yang telah diperbarui dari langkah sebelumnya.

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

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

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

Catatan: Setelah memberikan lisensi kepada pengguna untuk mengakses listingan komersial, Anda dapat membuat listingan pribadi untuk pengguna tersebut atau memberi pengguna tersebut peran Pelanggan Analytics Hub untuk listingan komersial Anda.

Membuat administrator listingan

Agar pengguna dapat mengelola listingan, Anda harus membuat administrator listingan Analytics Hub. Untuk membuat administrator listingan, Anda harus memberi pengguna peran Penayang Analytics Hub atau Analytics Hub Admin Listingan di tingkat listingan. Untuk informasi selengkapnya tentang cara memberikan peran ini untuk listingan, lihat Memberikan peran untuk listingan.

Melihat semua langganan

Untuk melihat semua langganan saat ini ke listingan Anda, pilih salah satu opsi berikut:

Konsol

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. Untuk melihat semua pelanggan listingan Anda, klik Kelola langganan.

   

5. Opsional: Anda dapat memfilter hasil menurut detail subscriber.

Atau, jika memiliki akses ke set data bersama, Anda dapat mengikuti langkah-langkah berikut untuk mencantumkan pelanggan:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, luaskan project Anda dan pilih set data bersama.

3. Dalam daftar Berbagi, pilih Kelola langganan.

SQL

Contoh berikut menggunakan tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS untuk mencantumkan semua set data tertaut ke set data bersama di myproject yang berada di region us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Outputnya mirip dengan yang berikut ini. Beberapa kolom dihilangkan untuk menyederhanakan output.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

Gunakan metode projects.locations.dataExchanges.listings.listSubscriptions.

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

Ganti kode berikut:

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

Menghapus langganan

Jika Anda menghapus langganan yang dibuat sebelum 25 Juli 2023 dari listingan, set data tertaut akan dibatalkan tautannya dari set data bersama. Pelanggan masih dapat melihat set data dalam project mereka, tetapi mereka tidak lagi ditautkan dengan set data bersama.

Untuk menghapus langganan yang dibuat sebelum 25 Juli 2023 dari listingan Anda, ikuti langkah-langkah berikut:

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

2. Untuk menghapus pelanggan dari listingan, klik Hapus. Jika Anda ingin menghapus semua langganan, klik Hapus semua langganan.

3. Dalam dialog Remove subscription?, masukkan remove untuk mengonfirmasi.

4. Klik Hapus.

Untuk menghapus langganan yang dibuat setelah 25 Juli 2023, ikuti langkah-langkah berikut:

Konsol

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

2. Klik tab Langganan.

3. Untuk menghapus pelanggan dari listingan, pilih Langganan yang ingin Anda hapus, lalu klik Hapus Langganan.

4. Dalam dialog Remove subscription?, masukkan remove untuk mengonfirmasi.

5. Klik Hapus.

API

Gunakan metode projects.locations.subscriptions.revoke (pratinjau).

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 yang ingin Anda hapus.
• SUBSCRIPTION: ID langganan yang ingin Anda hapus.

Memperbarui listingan

Untuk memperbarui listingan, ikuti langkah-langkah 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 set data sumber listingan.

6. Untuk melihat pratinjau perubahan, klik Pratinjau.

7. Untuk menyimpan perubahan, klik Simpan.

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 UPDATEMASK dengan daftar kolom yang ingin Anda perbarui. Untuk memperbarui beberapa nilai, gunakan daftar yang dipisahkan koma. Dalam isi permintaan, tentukan nilai yang diperbarui.

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

Menghapus listingan

Jika listingan dihapus, pelanggan tidak dapat lagi melihat listingan tersebut. Menghapus listingan juga menghapus semua set data tertaut (menghapus semua langganan) dari project pelanggan Anda.

Jika Anda menghapus listingan, Anda tidak dapat mengurungkannya. Untuk menghapus listingan, ikuti langkah-langkah 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 Hapus listingan?, konfirmasi penghapusan dengan mengetik delete.

6. Klik Delete.

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

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

Langkah selanjutnya

• Baca arsitektur Analytics Hub
• Pelajari cara melihat dan berlangganan listingan.
• Pelajari peran pengguna Analytics Hub.
• Pelajari cara membuat set data.
• Pelajari logging audit Analytics Hub.
• Pelajari cara memantau listingan.