Melihat dan berlangganan listingan

Sebagai pelanggan Analytics Hub, Anda dapat melihat dan berlangganan listingan yang aksesnya Anda miliki. Berlangganan listingan akan membuat set data tertaut di project Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menggunakan listingan, minta administrator untuk memberi Anda peran Identity and Access Management (IAM) berikut pada project pelanggan:

• Menemukan listingan: Analytics Hub Viewer (roles/analyticshub.viewer)

• Berlangganan listingan: BigQuery User (roles/bigquery.user)

  • Untuk berlangganan listingan, Anda juga harus meminta penayang listingan untuk memberi Anda peran Analytics Hub Subscriber (roles/analyticshub.subscriber) di listingan, pertukaran, atau project mereka, mana pun cakupan yang paling sesuai untuk kasus penggunaan Anda.

• Melihat set data tertaut: BigQuery Data Viewer (roles/bigquery.dataViewer)

• Mengkueri set data tertaut: BigQuery Data Viewer (roles/bigquery.dataViewer)

• Memperbarui set data tertaut: BigQuery Data Owner (roles/bigquery.dataOwner)

• Melihat metadata tabel: BigQuery Data Viewer (roles/bigquery.dataViewer)

• Menghapus set data tertaut: BigQuery Admin (roles/bigquery.admin)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk melakukan tugas dalam dokumen ini. Untuk melihat izin persis yang diperlukan untuk membuat dan mengkueri set data, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

• Buat set data baru: bigquery.datasets.create atau bigquery.datasets.* untuk melakukan tindakan tambahan pada set data.
• Set data kueri: bigquery.jobs.create atau bigquery.jobs.* untuk melakukan tindakan tambahan pada tugas.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya.

Menemukan listingan

Untuk menemukan listingan publik dan pribadi, ikuti langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, klik Tambahkan.

3. Pada dialog Add, klik Analytics Hub. Dialog Analytics Hub akan muncul yang berisi listingan yang dapat Anda akses. Untuk listingan Salesforce Data Cloud, ada tombol di panel Penjelajah yang secara otomatis memfilter listingan terkait.
   

   Atau, untuk membuka dialog Analytics Hub, Anda juga dapat membuka Analytics Hub dan mengklik Search listings.

4. Untuk memfilter listingan menurut nama atau deskripsinya, masukkan nama atau deskripsi listingan di kolom Search for listings.

5. Di bagian Filter, Anda dapat memfilter listingan berdasarkan kolom berikut:

   • Listingan: memilih apakah Anda ingin menampilkan listingan pribadi, listingan publik listingan dalam organisasi.

   • Kategori: pilih kategori yang diinginkan.

   • Lokasi: pilih lokasi yang diinginkan. Untuk mengetahui informasi selengkapnya, lihat Region yang didukung.

   • Penyedia: pilih penyedia data. Beberapa penyedia data mewajibkan Anda untuk meminta akses ke set data komersial mereka. Setelah meminta akses, penyedia data akan menghubungi Anda untuk membagikan set data mereka.

6. Jelajahi listingan yang difilter.

Berlangganan listingan

Berlangganan listingan memberi Anda akses hanya baca ke data dalam listingan dengan membuat set data tertaut di project.

Perhatian: Sebaiknya Anda tidak memasukkan data ke project yang berada dalam perimeter Kontrol Layanan VPC. Jika melakukannya, Anda harus menambahkan aturan masuk dan keluar yang sesuai.

Untuk berlangganan listingan, ikuti langkah-langkah 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. Jika Anda tidak memiliki akses untuk berlangganan listingan, seperti listingan yang merujuk ke set data komersial, klik Minta akses. Jika Anda mengklik set data yang dapat dijadikan langganan, klik Add dataset to project untuk membuka dialog Create linked dataset.

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 linked dataset, tentukan detail berikut:

   • Project: tentukan nama project tempat Anda ingin menambahkan set data.
   • Nama set data tertaut: menentukan nama set data tertaut.

6. Untuk menyimpan perubahan, klik Save. Set data tertaut akan tercantum dalam 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 set data tempat Anda ingin membuat set data tertaut. Jika berhasil, isi respons akan kosong.

Melihat set data tertaut

Set data tertaut ditampilkan bersama set data lain di Konsol Google Cloud.

Untuk melihat set data tertaut di project Anda, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, klik nama project Anda yang berisi set data tertaut .

Atau, Anda juga dapat menggunakan Data Catalog untuk menelusuri dan melihat set data tertaut. Untuk mencocokkan semua set data tertaut Analytics Hub, gunakan predikat type=dataset.linked. Untuk mengetahui informasi selengkapnya, lihat sintaksis penelusuran Data Catalog.

Cloud Shell

Jalankan perintah berikut:

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Catatan: Jika penayang menghapus langganan, halaman detail set data tertaut akan menunjukkan bahwa set data telah dibatalkan tautannya. Anda dapat menghapus set data yang tidak tertaut karena Anda tidak dapat mengkueri set data yang dibatalkan tautannya.

Mengkueri set data tertaut

Anda dapat mengkueri tabel dan tampilan di set data tertaut dengan cara yang sama seperti menjalankan kueri pada tabel BigQuery lainnya.

Memperbarui set data tertaut

Resource dalam set data tertaut bersifat hanya baca. Anda tidak dapat mengedit data atau metadata untuk resource dalam set data tertaut, atau menentukan izin untuk setiap resource.

Anda hanya dapat memperbarui deskripsi dan label set data tertaut. Perubahan pada set data tertaut tidak memengaruhi sumber atau set data bersama.

Untuk memperbarui deskripsi dan label dari set data tertaut, ikuti langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, klik nama project Anda, lalu klik set data yang tertaut.

3. Luaskan opsi Actions dan klik Open.

4. Di panel Details, klik Edit details, lalu tentukan detail berikut:

   1. Untuk menambahkan label, lihat Menambahkan label ke set data.

   2. Untuk mengaktifkan kolasi, luaskan bagian Advanced options dan ikuti langkah-langkah berikut:

      1. Pilih Enable default collation.
      2. Dari daftar Default collation, pilih salah satu opsi.

5. Klik Save.

Melihat metadata tabel

Untuk melihat metadata tabel yang mendasarinya, buat kueri tampilan INFORMATION_SCHEMA.TABLES:

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Ganti LINKED-DATASET dengan nama set data tertaut Anda.

Catatan: Kueri INFORMATION_SCHEMA berbasis region tidak menampilkan metadata tabel tertaut. Untuk mempelajari tabelvirtual INFORMATION_SCHEMA yang tidak mendukung penentu set data untuk set data tertaut, lihat Batasan.

Menghapus set data tertaut

Jika langganan dihapus oleh penayang Analytics Hub, set data tertaut akan dibatalkan tautannya dari set data bersama. Anda dapat menghapus set data yang tidak tertaut karena Anda tidak dapat mengkueri set data yang dibatalkan tautannya.

Menghapus set data tertaut tidak akan menghapus set data sumber. Anda tidak dapat mengambil set data tertaut yang telah dihapus. Namun, Anda dapat membuatnya kembali dengan berlangganan listingan lagi dan menambahkan set data ke project Anda.

Untuk menghapus set data tertaut, lakukan langkah berikut:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, klik nama project Anda, lalu klik set data yang tertaut.

3. Perluas opsi Actions, lalu klik Delete.

4. Pada dialog Delete linked dataset?, konfirmasi penghapusan dengan mengetik delete.

5. Klik Delete.

Langkah berikutnya

• Pelajari Analytics Hub.
• Pelajari cara mengelola listingan.
• Pelajari cara mengelola pertukaran data.
• Pelajari logging audit Analytics Hub.