Mengelola pertukaran data

Sebagai administrator Analytics Hub, Anda dapat melakukan tugas berikut:

• Membuat, memperbarui, melihat, membagikan, dan menghapus pertukaran data.
• Membuat, memperbarui, menghapus, dan membagikan listingan.
• Mengelola administrator, administrator listingan, penayang, pelanggan, dan pelihat Analytics Hub.

Secara default, pertukaran data bersifat pribadi dan hanya pengguna atau grup yang memiliki akses ke pertukaran tersebut yang dapat melihat atau berlangganan data. Namun, jika Anda ingin Pengguna Google Cloud (allAuthenticatedUsers) dapat menemukan dan berlangganan listingan, Anda dapat meminta untuk membuat pertukaran data menjadi 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 yang telah ditetapkan berikut mencakup izin yang Anda perlukan untuk mengaktifkan Analytics Hub API:

• roles/serviceusage.serviceUsageAdmin

Untuk mengetahui informasi selengkapnya tentang peran IAM di BigQuery, lihat Peran dan izin yang telah ditentukan sebelumnya.

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 pertukaran data, Anda harus memiliki peran Analytics Hub Admin (roles/analyticshub.admin). Untuk informasi selengkapnya, lihat Peran Admin Analytics Hub. Untuk mempelajari cara memberikan peran ini kepada pengguna lain, lihat Membuat administrator Analytics Hub.

Membuat pertukaran data

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

Untuk membuat pertukaran data, ikuti langkah-langkah berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik Create exchange.

3. Pada dialog Create exchange, pilih Project dan Region untuk pertukaran data Anda. Anda tidak dapat memperbarui project dan region setelah membuat pertukaran data.

4. Untuk Display name, masukkan nama untuk pertukaran data Anda.

5. Opsional: Masukkan nilai di kolom berikut:

   • Primary contact: masukkan URL atau alamat email kontak utama untuk pertukaran data.
   • Description: masukkan deskripsi untuk pertukaran data.

6. Untuk mengaktifkan visibilitas publik, klik tombol Visibilitas publik. Setelah pertukaran dapat ditemukan secara publik, semua listingan di pertukaran akan ditampilkan dan dapat ditelusuri di katalog. Jika mengaktifkan visibilitas publik, Anda harus mengonfigurasi izin bursa. Karena pewarisan izin, semua listingan secara default akan ditetapkan dengan jenis visibilitas publik yang sama dari bursa. Oleh karena itu, bursa publik tidak dapat memiliki listingan pribadi, tetapi bursa pribadi dapat memiliki listingan publik (misalnya, Anda dapat menetapkan jenis visibilitas publik di tingkat listingan individual). Project tempat Anda membuat pertukaran data harus memiliki organisasi dan akun penagihan yang terkait.

7. Klik Create Exchange.

8. Opsional: Di bagian Exchange permission, lakukan langkah-langkah berikut:

   1. Masukkan alamat email di kolom berikut untuk memberikan peran kepada pengguna Analytics Hub:

      • Administrators: pengguna ini diberi peran Admin Analytics Hub.
      • Publishers: pengguna ini diberi peran Penayang Analytics Hub. Untuk informasi tentang tugas yang dapat dilakukan penayang, lihat Mengelola listingan.
      • Subscribers: pengguna ini diberi peran Pelanggan Analytics Hub. Untuk informasi tentang tugas yang dapat dilakukan pelanggan, lihat Melihat dan berlangganan listingan.
      • Viewer: pengguna ini diberi peran Pelihat Analytics Hub. Pelihat dapat melihat listingan.
        • Jika visibilitas publik diaktifkan, berikan peran Analytics Hub Viewer (roles/analyticshub.viewer) ke allUsers atau allAuthenticatedUsers.

   2. Untuk menyimpan izin, klik Set permissions.

9. Jika Anda tidak menetapkan izin untuk pertukaran data, klik Skip.

API

Gunakan metode projects.locations.dataExchanges.create.

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

Ganti kode berikut:

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

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

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan di pertukaran data menggunakan API, lihat metode projects.locations.dataExchanges.

Memperbarui pertukaran data

Untuk memperbarui pertukaran data, ikuti langkah-langkah berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Dari daftar pertukaran data, klik pertukaran data yang ingin Anda perbarui.

3. Klik Edit exchange.

4. Pada dialog Edit exchange, perbarui kolom berikut:

   • Nama tampilan
   • Kontak utama
   • Deskripsi
   • Visibilitas publik
     • Jika Anda mengaktifkan visibilitas publik, berikan peran Analytics Hub Viewer (roles/analyticshub.viewer) ke allUsers atau allAuthenticatedUsers.
     • Jika Anda menonaktifkan visibilitas publik, hapus peran Analytics Hub Viewer (roles/analyticshub.viewer) dari allUsers atau allAuthenticatedUsers. Bursa publik tidak dapat memiliki listingan pribadi, tetapi bursa pribadi dapat memiliki listingan publik.

5. Klik Simpan.

API

Gunakan metode projects.locations.dataExchanges.patch.

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

Ganti UPDATEMASK dengan 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 berikut:

• Nama tampilan
• Deskripsi
• Dokumentasi
• Ikon
• Kontak utama
• Visibilitas publik

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan di pertukaran data menggunakan API, lihat metode projects.locations.dataExchanges.

Melihat pertukaran data

Untuk melihat semua pertukaran data di organisasi yang dapat Anda akses, ikuti langkah-langkah berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Melihat daftar pertukaran data dalam organisasi Google Cloud Anda.

API

Gunakan metode organizations.locations.dataExchanges.list.

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi. Untuk informasi selengkapnya, lihat Mendapatkan ID organisasi.
• LOCATION: lokasi tempat Anda ingin mencantumkan pertukaran data yang sudah ada.

Membagikan pertukaran data

Jika penayang Analytics Hub tidak berada di organisasi yang memiliki pertukaran data, penayang tidak dapat melihat pertukaran data Anda di Analytics Hub. Anda harus membagikan link ke pertukaran data kepada penayang.

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Dari daftar pertukaran data, klik More options.

3. Klik Copy share link.

Memberi pengguna akses ke pertukaran data

Untuk memberi pengguna akses ke pertukaran data, Anda harus menetapkan kebijakan IAM untuk pertukaran data tersebut. Untuk informasi tentang peran pengguna bawaan IAM, lihat Peran pengguna Analytics Hub. Untuk melakukannya, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Analytics Hub.

   Buka Analytics Hub

2. Klik nama pertukaran data yang ingin Anda tetapkan izinnya.

3. Klik Set permissions.

4. Untuk menambahkan akun utama, klik Add principal.

5. Di kolom New principals, tambahkan email yang ingin Anda berikan akses.

6. Untuk Select a role, arahkan kursor ke Analytics Hub, lalu pilih salah satu peran Identity and Access Management (IAM) berikut:

   • Analytics Hub Admin
   • Analytics Hub Publisher
   • Analytics Hub Listing Admin
   • Analytics Hub Subscriber
   • Analytics Hub Viewer

7. Klik Save.

API

1. Baca kebijakan yang sudah ada dengan metode getIamPolicy listingan menggunakan metode projects.locations.dataExchanges.getIamPolicy:

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

   Ganti kode berikut:

   • PROJECT_ID: project ID—misalnya, my-project-1.
   • LOCATION: lokasi untuk pertukaran data Anda.
   • DATAEXCHANGE_ID: ID pertukaran data.

   Analytics Hub menampilkan kebijakan saat ini.

2. Untuk menambahkan atau menghapus anggota dan peran Identity and Access Management (IAM) 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.setIamPolicy. Dalam isi permintaan, berikan kebijakan IAM yang telah diperbarui dari langkah sebelumnya.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
   

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

Membuat administrator Analytics Hub

Untuk mengelola pertukaran data, Anda harus membuat administrator Analytics Hub. Untuk membuat administrator pertukaran, Anda perlu memberikan peran Analytics Hub Admin (roles/analyticshub.admin) kepada pengguna di tingkat project atau di tingkat pertukaran data.

Jika Anda ingin administrator mengelola semua pertukaran data dalam project, berikan peran Analytics Hub Admin untuk project tersebut. Jika Anda ingin administrator mengelola pertukaran data tertentu, berikan peran Analytics Hub Admin untuk pertukaran data tersebut.

Membuat pertukaran data menjadi publik

Secara default, pertukaran data bersifat pribadi dan hanya pengguna atau grup yang memiliki akses ke pertukaran tersebut yang dapat melihat atau berlangganan listingannya. Namun, Anda dapat memilih untuk membuat pertukaran data menjadi publik. Pengguna Google Cloud (allAuthenticatedUsers) dapat menemukan dan berlangganan listingan di pertukaran data publik.

Untuk membuat pertukaran data menjadi publik, ikuti langkah-langkah berikut:

1. Untuk mengizinkan allAuthenticatedUsers melihat listingan, Anda harus memberinya peran Analytics Hub Viewer di tingkat pertukaran data.

2. Untuk mengizinkan allAuthenticatedUsers berlangganan listingan, Anda harus memberinya peran Analytics Hub Subscriber di tingkat pertukaran data.

3. Aktifkan visibilitas publik saat Anda membuat atau memperbarui pertukaran data. Tentukan izin yang sesuai saat Anda membuat pertukaran data menjadi publik.

Catatan: Anda juga dapat meminta untuk mengonversi pertukaran data publik menjadi pribadi. Untuk melakukannya, Anda harus menghapus allAuthenticatedUsers dari daftar izin untuk pertukaran data.

Menghapus pertukaran data

Saat pertukaran data dihapus, semua listingan di dalamnya juga akan dihapus. Namun, set data yang dibagikan dan set data yang tertaut tidak akan dihapus. Selain itu, saat project dihapus, pertukaran data di dalamnya tidak akan dihapus. Anda perlu menghapus pertukaran data ini sebelum menghapus project. Jika menghapus pertukaran data, Anda tidak dapat mengurungkannya.

Untuk menghapus pertukaran data, ikuti langkah-langkah berikut:

Konsol

1. Buka halaman Analytics Hub.

   Buka Analytics Hub

2. Dari daftar pertukaran data, klik pertukaran data yang ingin Anda hapus.

3. Klik Delete exchange.

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

5. Klik Delete.

API

Gunakan metode projects.locations.dataExchanges.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

Untuk informasi selengkapnya tentang tugas yang dapat Anda lakukan di pertukaran data menggunakan API, lihat metode projects.locations.dataExchanges.

Langkah berikutnya

• Pelajari cara mengelola listingan.
• Pelajari cara memberikan peran pengguna Analytics Hub.
• Pelajari cara melihat dan berlangganan listingan.
• Pelajari logging audit Analytics Hub.