Mengelola listingan

Sebagai penayang data di BigQuery sharing (sebelumnya Analytics Hub), Anda dapat membuat dan mengelola listingan untuk membagikan set data dengan aman kepada pelanggan di seluruh organisasi tanpa menyalin data.

Saat mengelola listingan, Anda dapat melakukan tugas berikut:

  • Membuat, memperbarui, membagikan, dan menghapus listingan di pertukaran data mana pun yang akses publikasinya Anda miliki.
  • Kelola akses dengan menetapkan peran BigQuery sharing kepada administrator, pelanggan, dan pelihat.
  • Melihat, memantau, dan menghapus pelanggan dari listingan Anda.
  • Pantau metrik penggunaan langganan.

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

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 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 mengelola listingan dan langganan, Anda harus memiliki salah satu peran Identity and Access Management (IAM) BigQuery sharing 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 IAM BigQuery sharing. Untuk mempelajari cara memberikan peran ini kepada pengguna lain, lihat Membuat administrator listingan.

Untuk membuat listingan atau memperbarui region replika untuk listingan, Anda harus memiliki izin bigquery.datasets.get dan bigquery.datasets.update pada set data sumber. Peran bawaan BigQuery berikut mencakup izin bigquery.datasets.update:

Untuk melihat semua pertukaran data di seluruh project dalam organisasi yang dapat Anda akses, Anda harus memiliki izin resourcemanager.organizations.get. Tidak ada peran bawaan BigQuery yang berisi izin ini, jadi Anda harus menggunakan peran kustom 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 BigQuery sharing harus membagikan link pertukaran data kepada Anda.

Membuat listingan

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

Untuk membuat listingan, ikuti langkah-langkah berikut:

Konsol

  1. Buka halaman Berbagi (Analytics Hub).

    Buka Berbagi (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 bagian Configure data, di menu Resource type, pilih BigQuery dataset atau Pub/Sub Topic.

    • Jika Anda memilih BigQuery dataset, lakukan hal berikut:

      1. Di menu Shared dataset, pilih set data yang ada, atau klik Create a dataset untuk membuat set data. Set data harus berada di region yang sama dengan pertukaran data. Anda tidak dapat mengubah set data bersama setelah membuat listingan. Saat pelanggan melihat metadata set data tertaut mereka, BigQuery sharing akan menampilkan nama set data sumber dan ID project yang berisi set data tersebut.
      2. Opsional: Agar pelanggan dapat membagikan prosedur tersimpan SQL di seluruh listingan, pilih Izinkan berbagi prosedur tersimpan (Pratinjau).
      3. Agar set data bersama tersedia di region tambahan, perluas menu Ketersediaan data region. Menu menampilkan region yang memiliki replika set data yang ada dan diberi label Siap digunakan. Sebelum mengonfigurasi listingan untuk beberapa wilayah, pastikan Anda telah mengaktifkan replikasi set data lintas wilayah pada set data bersama. Anda hanya dapat memilih region tempat replikasi set data lintas region diaktifkan; semua region lainnya diberi label Tidak Tersedia. Jika Anda tidak memilih wilayah tambahan, listingan akan menggunakan wilayah utama set data bersama secara default, yang diberi label Utama penyedia.

      4. Di Kontrol traffic keluar data, pilih opsi traffic keluar data yang sesuai:

        • Untuk membatasi penyalinan dan ekspor data di set data bersama Anda sekaligus mengizinkan ekspor hasil kueri, pilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.
        • Untuk membatasi penyalinan dan ekspor data di set data bersama dan hasil kueri, pilih Nonaktifkan penyalinan dan ekspor hasil kueri. Opsi ini juga memilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.
        • Untuk membatasi penyalinan dan ekspor tabel melalui API di set data bersama, pilih Nonaktifkan penyalinan dan ekspor tabel melalui API. Opsi ini juga memilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.

        Untuk mengetahui informasi selengkapnya tentang kontrol traffic keluar data, termasuk batasan, lihat Opsi traffic keluar data (khusus set data bersama BigQuery).

    • Jika Anda memilih Pub/Sub Topic, lalu di menu Shared topic, pilih topik Pub/Sub yang ada, atau klik Create a topic untuk membuat topik.

  5. Di bagian Detail listingan, di bagian Nama tampilan, masukkan nama untuk listingan.

  6. Masukkan detail opsional berikut:

    • Kategori: pilih hingga dua kategori yang paling mewakili listingan Anda. Pelanggan dapat memfilter listingan menggunakan kategori yang Anda pilih.
    • Afinitas data: tentukan region yang Anda gunakan untuk memublikasikan data. Setelan lokasi ini membantu pelanggan 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: upload ikon untuk listingan Anda. Format file PNG dan JPEG didukung. Ukuran ikon harus kurang dari 512 KiB dengan dimensi maksimum 512 x 512 piksel.
    • Deskripsi: masukkan deskripsi singkat tentang listingan Anda. Pelanggan dapat menelusuri listingan berdasarkan teks deskripsi.

    • Dapat ditemukan secara publik: aktifkan setelan ini agar listingan Anda dapat ditemukan secara publik di katalog BigQuery sharing. Jika Anda mengaktifkan opsi ini, berikan peran Pelihat Analytics Hub (roles/analyticshub.viewer) kepada allUsers atau allAuthenticatedUsers. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran untuk listingan. Jika bursa sudah bersifat publik, listingan akan mewarisi izin tersebut dan tidak memerlukan tindakan lebih lanjut.

      Pertukaran yang dapat ditemukan secara publik tidak dapat memiliki listingan pribadi karena pewarisan izin, tetapi pertukaran pribadi dapat memiliki listingan publik. Untuk membuat listingan publik, project yang berisi listingan harus memiliki organisasi dan akun penagihan terkait. Jika Anda membuat listingan komersial yang terintegrasi dengan Cloud Marketplace, sebaiknya aktifkan penemuan publik.

    • Pencatatan Email Pelanggan: aktifkan setelan ini untuk mencatat ID utama semua pengguna yang menjalankan tugas dan kueri pada set data tertaut. Jika Anda mengaktifkan opsi ini, semua langganan mendatang yang dibuat dari listingan ini akan mengaktifkan logging email pelanggan. Data yang dicatat ke dalam log tersedia di kolom job_principal_subject pada tampilan INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Dokumentasi > Markdown: masukkan dokumentasi pendukung, link, atau petunjuk dalam format Markdown untuk membantu pelanggan menggunakan set data Anda.

  7. Di bagian Mencantumkan informasi kontak, masukkan detail opsional berikut:

    • Kontak utama: masukkan alamat email atau URL untuk kontak utama listingan.
    • Kontak permintaan akses: masukkan alamat email atau URL formulir informasi Anda agar pelanggan dapat menghubungi Anda untuk meminta akses.

    • Penyedia: perluas bagian Penyedia dan masukkan detail di kolom berikut:

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

      Pelanggan dapat memfilter listingan menurut penyedia data.

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

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

  8. Tinjau bagian Pratinjau listingan.

  9. Untuk memublikasikan listingan, 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: ID project yang berisi pertukaran data tempat Anda ingin membuat listingan.
  • LOCATION: lokasi pertukaran data Anda. Untuk mengetahui informasi selengkapnya tentang lokasi yang mendukung berbagi BigQuery, lihat Wilayah yang didukung.
  • DATAEXCHANGE_ID: ID pertukaran data.
  • LISTING_ID: ID listingan.

Dalam isi permintaan, berikan detail listingan.

Untuk membuat listingan di beberapa wilayah, tentukan wilayah tersebut di kolom bigqueryDataset.replicaLocations isi permintaan. Sebelum mengonfigurasi listingan untuk beberapa wilayah, pastikan Anda telah mengaktifkan replikasi set data lintas-wilayah pada set data bersama. Anda hanya dapat memilih region tempat replikasi set data lintas-region diaktifkan. Jika Anda tidak mengisi kolom opsional ini, listingan akan menggunakan wilayah utama set data bersama.

Jika permintaan berhasil, isi respons akan menampilkan detail listingan. Jika Anda mengaktifkan logging email pelanggan dengan menetapkan kolom logLinkedDatasetQueryUserEmail ke true, respons listingan akan menampilkan log_linked_dataset_query_user_email: true. Data yang dicatat dalam log tersedia di kolom job_principal_subject pada tampilan INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

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

Membuat listingan dari set data

Untuk membuat listingan langsung dari set data yang ada, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman BigQuery.

    Buka BigQuery

  2. Untuk melihat detail set data, klik nama set data.

  3. Klik Berbagi > Publikasikan sebagai listingan.

    Dialog Buat listingan akan terbuka.

  4. Pilih pertukaran data tempat Anda ingin memublikasikan listingan. Pertukaran data harus berada di region yang sama dengan set data. Untuk mengetahui informasi selengkapnya tentang cara membuat pertukaran data, lihat membuat pertukaran dan menetapkan izin.

  5. Di menu Set data bersama, pilih set data yang ada, atau klik Buat set data untuk membuat set data. Set data harus berada di region yang sama dengan pertukaran data. Anda tidak dapat mengubah pilihan ini setelah Anda membuat listingan.

    Saat pelanggan melihat metadata set data tertaut mereka, BigQuery sharing akan menampilkan nama set data sumber dan ID project yang berisi set data.

  6. Opsional: Agar pelanggan dapat membagikan prosedur tersimpan SQL di seluruh listingan, pilih Izinkan berbagi prosedur tersimpan (Pratinjau).

  7. Agar set data bersama tersedia di region tambahan, perluas menu Ketersediaan data region. Menu menampilkan region dengan replika set data yang diberi label Siap digunakan. Sebelum mengonfigurasi listingan untuk beberapa wilayah, pastikan Anda telah mengaktifkan replikasi set data lintas-wilayah pada set data bersama. Anda hanya dapat memilih region tempat replikasi set data lintas-region diaktifkan; semua region lainnya diberi label Tidak Tersedia. Jika Anda tidak memilih region tambahan, listingan akan menggunakan region utama dari set data bersama, yang diberi label Utama penyedia.

  8. Di Kontrol traffic keluar data, pilih opsi traffic keluar data yang sesuai:

    • Untuk membatasi penyalinan dan ekspor di set data bersama Anda sekaligus mengizinkan ekspor hasil kueri, pilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.
    • Untuk membatasi penyalinan dan ekspor pada set data bersama dan hasil kueri, pilih Nonaktifkan penyalinan dan ekspor hasil kueri. Opsi ini juga memilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.
    • Untuk membatasi penyalinan dan ekspor tabel melalui API di set data bersama, pilih Nonaktifkan penyalinan dan ekspor tabel melalui API. Opsi ini juga memilih Nonaktifkan penyalinan dan ekspor data yang dibagikan.

    Untuk mengetahui informasi tentang kontrol dan batasan traffic keluar data, lihat Opsi traffic keluar data (khusus set data bersama BigQuery).

  9. Di bagian Detail listingan, di bagian Nama tampilan, masukkan nama untuk listingan.

  10. Masukkan detail opsional berikut:

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

    • Afinitas data: tentukan region yang Anda gunakan untuk memublikasikan data. Setelan lokasi ini membantu pelanggan 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: upload ikon untuk listingan Anda. Format file PNG dan JPEG didukung. Ikon harus berukuran kurang dari 512 KiB dengan dimensi maksimum 512 x 512 piksel.

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

    • Dapat ditemukan secara publik: aktifkan setelan ini agar listingan Anda dapat ditemukan secara publik di katalog BigQuery sharing. Jika Anda mengaktifkan opsi ini, berikan peran Analytics Hub Viewer (roles/analyticshub.viewer) kepada allUsers atau allAuthenticatedUsers. Untuk mengetahui informasi selengkapnya, lihat Memberikan peran untuk listingan. Jika bursa sudah bersifat publik, listingan akan mewarisi izin tersebut dan tidak memerlukan tindakan lebih lanjut.

      Pertukaran yang dapat ditemukan secara publik tidak dapat memiliki listingan pribadi karena pewarisan izin, tetapi pertukaran pribadi dapat memiliki listingan publik. Untuk membuat listingan publik, project yang berisi listingan harus memiliki organisasi dan akun penagihan terkait. Jika Anda membuat listingan komersial yang terintegrasi dengan Cloud Marketplace, sebaiknya aktifkan penemuan publik.

    • Pencatatan email pelanggan: aktifkan untuk mencatat ID utama pelanggan yang menjalankan tugas dan kueri di set data tertaut listingan ini untuk semua langganan pada masa mendatang. Jika Anda mengaktifkan opsi ini, hanya langganan yang baru dibuat yang mencatat ID pokok. Data yang dicatat tersedia di kolom job_principal_subject pada tampilan INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Dokumentasi > Markdown: masukkan dokumentasi pendukung, link, atau petunjuk untuk membantu pelanggan menggunakan set data Anda.

  11. Di bagian Mencantumkan informasi kontak, masukkan detail opsional berikut:

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

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

    • Penyedia: perluas bagian Penyedia dan masukkan detail di kolom berikut:

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

      Pelanggan dapat memfilter listingan menurut penyedia data.

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

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

  12. Tinjau bagian Pratinjau listingan.

  13. Untuk memublikasikan listingan, klik Publikasikan.

Membagikan prosedur tersimpan SQL di seluruh listingan

Anda dapat membagikan prosedur tersimpan SQL saat membuat listingan dengan set data BigQuery. Karena prosedur tersimpan dapat membuat, menghapus, dan memanipulasi tabel, serta memanggil prosedur tersimpan lainnya, berbagi prosedur tersimpan memerlukan otorisasi tambahan.

Otorisasi pelanggan

Setelah pelanggan berlangganan listingan, prosedur tersimpan yang ditautkan mungkin tidak langsung dijalankan. Untuk memastikan bahwa prosedur tersimpan tertaut dapat berjalan, pelanggan harus mengirimkan nama set data tertaut ke penyedia agar penyedia mengizinkan prosedur tersimpan tertaut pada resource penyedia. Selain itu, pelanggan harus mengizinkan prosedur tersimpan bersama yang ditautkan dan melampirkan peran IAM ke resource pelanggan untuk mengizinkan pembacaan dan penulisan ke resource tersebut.

Otorisasi penyedia

Saat membuat listingan dengan prosedur tersimpan, penyedia harus mengizinkan pelanggan membaca dan menulis ke tabel penyedia melalui prosedur tersimpan yang ditautkan. Untuk memastikan akses, penyedia harus melakukan hal berikut:

  • Untuk operasi non-baca, beri otorisasi pada prosedur tersimpan bersama yang ditautkan dan lampirkan peran IAM ke resource penyedia mana pun yang diakses oleh prosedur tersimpan yang ditautkan.

  • Untuk operasi baca, berikan otorisasi pada prosedur tersimpan bersama yang ditautkan (di set data tertaut pelanggan) atau prosedur tersimpan bersama asli (di set data penyedia), dan lampirkan peran IAM ke resource penyedia yang diakses oleh prosedur.

Memberi pengguna akses ke listingan

Untuk memberikan akses ke listingan pribadi, Anda harus menetapkan kebijakan IAM untuk listingan tersebut agar menyertakan individu atau grup tertentu. Untuk listingan komersial, pertukaran data Anda harus bersifat publik. Listingan di pertukaran data publik muncul di berbagi BigQuery untuk semua penggunaGoogle Cloud (allAuthenticatedUsers). Agar pengguna dapat menjelajahi dan meminta akses ke listingan komersial, beri pengguna tersebut peran Pelihat Analytics Hub (roles/analyticshub.viewer). Agar pengguna dapat berlangganan listingan komersial, beri pengguna tersebut peran Pelanggan Analytics Hub (roles/analyticshub.subscriber). Untuk listingan komersial yang terintegrasi dengan Cloud Marketplace, berbagi BigQuery secara otomatis memberikan peran Pelanggan Analytics Hub berdasarkan pesanan Cloud Marketplace.

Agar listingan Anda dapat diakses oleh semua orang—termasuk orang yang tidak memiliki akunGoogle Cloud —beri allUsers peran Pelihat Analytics Hub (roles/analyticshub.viewer).

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

Konsol

  1. Buka halaman Berbagi (Analytics Hub).

    Buka Berbagi (Analytics Hub)

  2. Klik nama pertukaran data yang berisi listingan.

  3. Klik listingan yang ingin Anda bagikan.

  4. Klik Setel izin.

  5. Untuk menambahkan akun utama, klik Tambahkan akun utama.

  6. Di kolom Akun utama baru, masukkan akun utama berdasarkan jenis listingan Anda:

    • Untuk listingan pribadi, masukkan alamat email identitas yang ingin Anda beri akses.

    • Untuk listingan publik, masukkan allAuthenticatedUsers.

    • Untuk listingan publik yang dapat ditemukan oleh semua orang, termasuk pengguna non-Google Cloud, masukkan allUsers.

  7. Di menu Pilih peran, arahkan kursor ke Analytics Hub, lalu pilih peran berdasarkan jenis listingan Anda:

    • Untuk listingan komersial (termasuk listingan yang terintegrasi dengan Cloud Marketplace), pilih Pelihat Analytics Hub. Peran ini memungkinkan pengguna melihat listingan dan meminta akses.

    • Untuk listingan publik pribadi atau non-komersial, pilih Pelanggan Analytics Hub. Peran ini memungkinkan pengguna berlangganan listingan Anda.

    • Untuk listingan yang terintegrasi dengan Cloud Marketplace, Anda tidak perlu memberikan peran Pelanggan Analytics Hub (roles/analyticshub.subscriber). Langganan dikelola secara otomatis berdasarkan pesanan Cloud Marketplace.

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

  8. Untuk menyimpan izin, klik Simpan.

API

  1. Baca kebijakan yang ada dengan memanggil 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.

    Fitur berbagi menampilkan kebijakan saat ini dalam respons.

  2. Untuk menambahkan atau menghapus anggota dan peran terkait, edit JSON kebijakan menggunakan editor teks. Tentukan anggota menggunakan format berikut:

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Misalnya, untuk memberikan peran roles/analyticshub.subscriber ke group:subscribers@example.com, tambahkan binding berikut ke kebijakan:

    {
"members": [
 "group:subscribers@example.com"
],
"role":"roles/analyticshub.subscriber"
}

  3. Perbarui kebijakan dengan memanggil metode projects.locations.dataExchanges.listings.setIamPolicy. Dalam isi permintaan, teruskan 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, teruskan detail listingan. Jika permintaan berhasil, isi respons akan menampilkan detail listingan dengan kebijakan yang diperbarui.

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

Membuat URL tidak diautentikasi untuk listingan publik

Untuk membuat URL listingan berbagi BigQuery yang tidak diautentikasi yang dapat dilihat oleh pengguna tanpa akun Google Cloud , ikuti langkah-langkah berikut:

  1. Buka halaman Berbagi (Analytics Hub).

    Buka Berbagi (Analytics Hub)

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

  2. Klik nama pertukaran data yang berisi listingan.

  3. Untuk melihat detail listingan, klik nama tampilan listingan. Listingan harus mengaktifkan kemampuan penemuan publik.

  4. Klik Salin link publik. Untuk memastikan pengguna eksternal dapat melihat listingan, verifikasi bahwa listingan memberikan peran Pelihat Analytics Hub (roles/analyticshub.viewer) kepada allUsers.

Membuat administrator listingan

Agar pengguna dapat mengelola listingan, Anda dapat membuat administrator listingan dengan memberi pengguna tersebut peran Penayang Analytics Hub atau Admin Listingan Analytics Hub di listingan. Untuk mengetahui petunjuk tentang cara memberikan peran pada 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 Berbagi (Analytics Hub).

    Buka Berbagi (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:

    Opsi Kelola langganan yang ditandai untuk listingan Analytics Hub.

  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 kiri, klik Penjelajah:

    Tombol yang ditandai untuk panel Explorer.

    Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

  3. Di panel Explorer, luaskan nama project Anda, klik Datasets, lalu klik nama set data bersama.

  4. Dalam daftar Berbagi, pilih Kelola langganan.

SQL

Contoh berikut menggunakan tampilan INFORMATION_SCHEMA.SCHEMATA_LINKS untuk mencantumkan semua set data tertaut yang ditautkan 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                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Untuk listingan dengan beberapa wilayah, Anda dapat melihat langganan di berbagai wilayah dengan mengganti wilayah us dengan lokasi replika yang diinginkan. Misalnya, untuk melihat set data tertaut yang ditautkan ke set data bersama di myproject yang berada di region eu, gunakan kueri berikut:

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

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 di project mereka, tetapi set data tidak lagi ditautkan ke set data bersama Anda.

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

  1. Untuk mencantumkan pelanggan listingan, ikuti petunjuk Melihat semua langganan untuk konsol Google Cloud .

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

  3. Pada dialog Hapus langganan?, konfirmasi penghapusan dengan mengetik remove.

  4. Klik Hapus.

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

Konsol

  1. Untuk mencantumkan pelanggan listingan, ikuti petunjuk Melihat semua langganan untuk konsol Google Cloud .

  2. Klik Langganan.

  3. Untuk memilih langganan yang ingin Anda hapus, centang kotak centang di samping langganan tersebut, lalu klik Hapus Langganan.

  4. Pada dialog Hapus langganan?, konfirmasi penghapusan dengan mengetik remove.

  5. Klik Hapus.

API

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

Memperbarui listingan

Seiring berkembangnya persyaratan pertukaran data, Anda dapat memperbarui metadata listingan, kategori, setelan penemuan, dan ketersediaan wilayah tanpa mengubah set data bersama yang mendasarinya.

Untuk memperbarui listingan, ikuti langkah-langkah berikut:

Konsol

  1. Buka halaman Berbagi (Analytics Hub).

    Buka Berbagi (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 bersama listingan.

  6. Opsional: Perbarui setelan dan ketersediaan listingan:

    • Untuk mengaktifkan penemuan publik, berikan peran Pelihat Analytics Hub (roles/analyticshub.viewer) kepada allUsers atau allAuthenticatedUsers. Untuk mengetahui petunjuk tentang cara memberikan peran pada listingan, lihat Memberikan peran untuk listingan.
    • Untuk menonaktifkan penemuan publik untuk listingan di pertukaran pribadi, hapus peran Pelihat Analytics Hub (roles/analyticshub.viewer) dari allUsers dan allAuthenticatedUsers. Jika bursa sudah bersifat publik, izin listingan sudah diwarisi dan tidak ada tindakan lebih lanjut yang diperlukan.
    • Setelah mengaktifkan dan menyimpan logging email pelanggan, Anda tidak dapat mengedit setelan ini. Untuk menonaktifkan logging email, hapus listingan, lalu buat ulang listingan tanpa memilih Logging email pelanggan.
    • Untuk menambahkan atau menghapus wilayah, perbarui pilihan wilayah Anda. Sebelum menambahkan beberapa region, pastikan Anda mengaktifkan replikasi set data lintas-region pada set data bersama. Sebelum menghapus suatu wilayah, hapus replika set data bersama di wilayah tersebut.

  7. Tinjau pratinjau listingan.

  8. Untuk menyimpan perubahan, klik Simpan. Jika Anda memperbarui listingan yang terintegrasi dengan Cloud Marketplace, notifikasi akan meminta Anda untuk memperbarui listingan produk data Cloud Marketplace juga.

API

Panggil 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: ID project yang berisi pertukaran data tempat Anda ingin membuat listingan.
  • LOCATION: lokasi pertukaran data.
  • DATAEXCHANGE_ID: ID pertukaran data.
  • LISTING_ID: ID listingan yang akan diperbarui.
  • UPDATEMASK: daftar kolom yang ingin Anda perbarui. Untuk memperbarui beberapa nilai, gunakan daftar yang dipisahkan koma. Misalnya, untuk memperbarui nama tampilan dan kontak utama untuk pertukaran data, masukkan displayName,primaryContact.

Dalam isi permintaan, tentukan nilai yang diperbarui untuk kolom dalam mask update Anda:

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • categories[]
  • discoveryType
  • logLinkedDatasetQueryUserEmail
  • bigqueryDataset.replicaLocations

Untuk mengetahui detail kolom ini, lihat Resource: Listingan.

Saat memperbarui wilayah replika untuk listingan Anda, tentukan semua wilayah yang berlaku. Sebelum memperbarui listingan, pastikan Anda telah mengaktifkan replikasi set data lintas region pada set data bersama. Anda hanya dapat menambahkan wilayah tempat set data bersama memiliki replika. Sebelum menghapus wilayah dari listingan, hapus replika set data bersama di wilayah tersebut. Anda juga dapat mengonversi listingan satu region menjadi listingan multi-region.

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

Untuk meningkatkan visibilitas listingan Anda di katalog BigQuery sharing, Anda dapat menampilkan listingan di bagian Unggulan. Listingan unggulan diatur oleh Perjanjian Program Partner. Google Cloud

Untuk meminta agar listingan Anda ditampilkan di bagian Unggulan, Anda harus memenuhi kriteria berikut:

Untuk meminta agar listingan Anda ditambahkan ke bagian Unggulan, atau untuk meminta agar listingan Anda dihapus dari bagian tersebut, kirimkan formulir informasi listingan Unggulan.

Menghapus listingan

Saat Anda menghapus listingan, pelanggan tidak dapat lagi melihat listingan tersebut. Menghapus listingan juga akan menghapus semua set data tertaut dan menghapus semua langganan dari project pelanggan. Jika set data tetap ditautkan, hapus set data secara manual dengan mengklik Berbagi > Kelola Langganan. Di halaman Langganan, hapus set data pelanggan tertentu atau semua set data pelanggan sekaligus.

Anda tidak dapat menghapus listingan yang terintegrasi dengan Cloud Marketplace yang memiliki langganan komersial aktif. Anda harus membatalkan semua langganan komersial sebelum menghapus listingan.

Menghapus listingan multi-region tidak akan menghapus replika set data yang dibagikan. Setelah Anda menghapus listingan multi-region, pelanggan tidak dapat lagi melihat listingan atau mengkueri set data tertaut. Jika tidak ada listingan lain yang mereferensikan replika set data bersama, Anda dapat menghapus replika tersebut.

Sebelum menghapus listingan multi-wilayah, pastikan listingan tidak memiliki langganan aktif. Jika ada langganan aktif, batalkan langganan tersebut dengan memanggil metode projects.locations.subscriptions.revoke. Setelah semua langganan aktif dihapus, hapus listingan multiregion.

Untuk menghapus listingan, ikuti langkah-langkah berikut:

Konsol

  1. Buka halaman Berbagi (Analytics Hub).

    Buka Berbagi (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 Hapus.

API

Panggil 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: ID project yang berisi pertukaran data.
  • LOCATION: lokasi pertukaran data.
  • DATAEXCHANGE_ID: ID pertukaran data.
  • LISTING_ID: ID listingan yang akan dihapus.

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

Langkah berikutnya