Mengelola pertukaran data

Dokumen ini menjelaskan cara mengelola pertukaran data di fitur berbagi BigQuery (sebelumnya Analytics Hub). Sebagai administrator berbagi BigQuery, Anda dapat melakukan hal berikut:

Membuat, memperbarui, melihat, membagikan, dan menghapus pertukaran data.
Membuat, memperbarui, menghapus, dan membagikan listingan.
Mengelola administrator, administrator listingan, penayang, pelanggan, dan pelihat BigQuery sharing.

Secara default, pertukaran data bersifat pribadi. Hanya pengguna atau grup dengan akses ke pertukaran yang dapat melihat atau berlangganan datanya. Anda dapat meminta untuk membuat pertukaran data Anda menjadi publik. Dengan membuat pertukaran data Anda menjadi publik, pengguna (allAuthenticatedUsers) dapat menemukan dan berlangganan listingan.Google Cloud

Sebelum memulai

Untuk mulai menggunakan berbagi BigQuery (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:

Service Usage Admin (roles/serviceusage.serviceUsageAdmin)

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 mendapatkan izin yang diperlukan guna mengelola pertukaran data, minta administrator untuk memberi Anda peran IAM Analytics Hub Admin (roles/analyticshub.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat pertukaran data

Untuk membuat pertukaran data, ikuti langkah-langkah berikut:

Konsol

Buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Klik Buat penukaran.
Pada dialog Create exchange, pilih Project dan Region untuk pertukaran data Anda. Anda tidak dapat memperbarui project dan region setelah membuat pertukaran data.
Di kolom Nama tampilan, masukkan nama untuk pertukaran data Anda.
Opsional: Masukkan nilai di kolom berikut:
- Primary contact: masukkan URL atau alamat email kontak utama untuk pertukaran data.
- Description: masukkan deskripsi untuk pertukaran data.
Untuk mencatat ID utama semua pengguna yang menjalankan tugas dan kueri pada set data tertaut, klik tombol Pencatatan Email Pelanggan. Jika Anda mengaktifkan opsi ini, semua listingan mendatang dalam pertukaran data akan mengaktifkan pencatatan email pelanggan. Data yang dicatat ke dalam log tersedia di kolom job_principal_subject pada tampilan INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

Catatan: Setelah Anda mengaktifkan dan menyimpan logging email, setelan ini tidak dapat diedit. Untuk menonaktifkan logging email, hapus pertukaran data dan buat ulang tanpa mengklik tombol Subscriber Email Logging.
Untuk mengaktifkan visibilitas publik, klik tombol Visibilitas Publik. Jika pertukaran dapat ditemukan secara publik, semua listingan dalam pertukaran akan muncul dan dapat ditelusuri di katalog. Jika Anda mengaktifkan penemuan publik, konfigurasi izin pertukaran. Semua listingan mewarisi setelan kemampuan penemuan publik pertukaran data secara default. Pewarisan setelan ini berarti bursa publik tidak dapat memiliki listingan pribadi, tetapi bursa pribadi dapat memiliki listingan publik. Anda dapat menetapkan jenis penemuan publik di tingkat masing-masing listingan. Project tempat Anda membuat pertukaran data harus memiliki organisasi dan akun penagihan terkait.
Klik Create Exchange.
Opsional: Di bagian Exchange Permissions, selesaikan langkah-langkah berikut:
1. Masukkan alamat email di kolom berikut untuk memberikan peran Identity and Access Management (IAM):
  - Administrator: tetapkan peran Admin Analytics Hub (roles/analyticshub.admin) kepada pengguna ini.
  - Penayang: tetapkan peran Penayang Analytics Hub (roles/analyticshub.publisher) kepada pengguna ini. Untuk informasi tentang tugas yang dapat dilakukan penayang berbagi BigQuery, lihat Mengelola listingan.
  - Pelanggan: tetapkan peran Pelanggan Analytics Hub (roles/analyticshub.subscriber) kepada pengguna ini. Untuk mengetahui informasi tentang tugas yang dapat dilakukan pelanggan BigQuery sharing, lihat Melihat dan berlangganan listingan dan bursa data.
  - Pelihat: tetapkan peran Pelihat Analytics Hub (roles/analyticshub.viewer) kepada pengguna ini. Pelihat yang memiliki akses berbagi BigQuery dapat melihat listingan.
    
    Jika penemuan publik diaktifkan, berikan peran Pelihat Analytics Hub kepada allUsers atau allAuthenticatedUsers.
2. Untuk menyimpan izin, klik Set permissions.
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 mengetahui informasi selengkapnya tentang lokasi yang mendukung berbagi BigQuery, 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.

Jika Anda mengaktifkan logging email pelanggan dengan kolom logLinkedDatasetQueryUserEmail, respons pertukaran data akan berisi log_linked_dataset_query_user_email: true. Data yang dicatat ke dalam log tersedia di kolom job_principal_subject pada tampilan INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

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

Buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Dari daftar pertukaran data, pilih pertukaran data yang akan diperbarui.
Buka tab Detail.
Klik Edit exchange.
Pada dialog Edit exchange, perbarui kolom berikut:
- Nama tampilan
- Kontak utama
- Deskripsi
- Visibilitas publik
  - Jika Anda mengaktifkan penemuan publik, berikan peran Pelihat Analytics Hub (roles/analyticshub.viewer) kepada allUsers atau allAuthenticatedUsers.
  - Jika Anda menonaktifkan penemuan publik, hapus peran Analytics Hub Viewer (roles/analyticshub.viewer) dari allUsers atau allAuthenticatedUsers. Ad Exchange publik tidak dapat memiliki listingan pribadi, tetapi Ad Exchange pribadi dapat memiliki listingan publik.
- Pencatatan Email Pelanggan
  
  Catatan: Setelah Anda mengaktifkan dan menyimpan logging email, setelan ini tidak dapat diedit. Untuk menonaktifkan logging email, hapus pertukaran data dan buat ulang tanpa mengklik tombol Subscriber Email Logging.
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:

displayName
description
primaryContact
documentation
icon
discoveryType
logLinkedDatasetQueryUserEmail

Untuk mengetahui detail kolom ini, lihat Resource: DataExchange.

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

Melihat pertukaran data

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

Konsol

Buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Halaman ini menampilkan pertukaran data di project Google Cloud Anda. Jika memiliki izin resourcemanager.organizations.get, Anda juga dapat melihat pertukaran data di organisasi Google Cloud Anda.

API

Untuk melihat pertukaran data di project Anda, gunakan metode projects.locations.dataExchanges.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges

Ganti kode berikut:

PROJECT_ID: project ID.
LOCATION: lokasi tempat Anda ingin mencantumkan pertukaran data yang sudah ada.

Untuk melihat pertukaran data di organisasi Anda, 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 mengetahui informasi selengkapnya, lihat Mendapatkan ID organisasi.
LOCATION: lokasi tempat Anda ingin mencantumkan pertukaran data yang sudah ada.

Membagikan pertukaran data

Jika penayang BigQuery sharing tidak berada di organisasi yang memiliki pertukaran data, penayang tidak dapat melihat pertukaran data Anda di BigQuery sharing. Bagikan link ke pertukaran data kepada penayang.

Buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Dari daftar pertukaran data, klik Opsi lainnya.
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 mengetahui informasi tentang peran pengguna IAM bawaan, lihat Peran IAM untuk berbagi BigQuery.

Catatan: Saat mengelola akses untuk pengguna di penyedia identitas eksternal, ganti instance ID pokok Akun Google—seperti user:kiran@example.com, group:support@example.com, dan domain:example.com—dengan ID pokok Workforce Identity Federation yang sesuai.

Konsol

Di konsol Google Cloud , buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Klik nama pertukaran data yang ingin Anda tetapkan izinnya.
Buka tab Detail.
Klik Setel izin.
Untuk menambahkan akun utama, klik Tambahkan akun utama.
Di kolom New principals, tambahkan ID email yang ingin Anda beri akses. Anda juga dapat menggunakan allUsers untuk membuat resource menjadi publik dan dapat diakses oleh semua orang di internet, atau allAuthenticatedUsers untuk membuatnya hanya dapat diakses oleh pengguna Google yang login.
Di menu Pilih peran, pilih Analytics Hub, lalu pilih salah satu peran Identity and Access Management (IAM) berikut:
- Analytics Hub Admin
- Analytics Hub Listing Admin
- Analytics Hub Publisher
- Analytics Hub Subscriber
- Pemilik Langganan Analytics Hub
- Analytics Hub Viewer
Klik Save.

API

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. Gunakan huruf kecil.
- DATAEXCHANGE_ID: ID pertukaran data.
Fitur berbagi BigQuery (sebelumnya Analytics Hub) menampilkan kebijakan saat ini.
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: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"
}
```
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 berbagi BigQuery

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

Untuk mengizinkan administrator mengelola semua pertukaran data dalam project, berikan peran Analytics Hub Admin untuk project tersebut.

Untuk mengizinkan administrator mengelola pertukaran data tertentu, beri mereka peran Analytics Hub Admin untuk pertukaran data tersebut.

Membuat pertukaran data menjadi publik

Secara default, pertukaran data bersifat pribadi. Hanya pengguna atau grup dengan akses ke pertukaran yang dapat melihat atau berlangganan listingannya. Anda dapat membuat pertukaran data menjadi publik, sehingga penggunaGoogle Cloud (allAuthenticatedUsers) dapat menemukan dan berlangganan listingannya.

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

Untuk mengizinkan allAuthenticatedUsers melihat listingan, beri mereka peran Analytics Hub Viewer (roles/analyticshub.viewer) di tingkat pertukaran data.
Untuk mengizinkan allAuthenticatedUsers berlangganan listingan, beri mereka peran Analytics Hub Subscriber (roles/analyticshub.subscriber) di tingkat pertukaran data.
Aktifkan penemuan publik saat Anda membuat atau memperbarui pertukaran data. Tentukan izin yang sesuai saat Anda membuat pertukaran data menjadi publik.

Menghapus pertukaran data

Menghapus pertukaran data juga akan menghapus semua listingannya. Namun, set data yang dibagikan dan ditautkan tidak akan dihapus. Saat Anda menghapus project, pertukaran datanya tidak akan dihapus. Hapus pertukaran data ini sebelum menghapus project. Anda tidak dapat mengurungkan penghapusan pertukaran data.

Sebelum menghapus pertukaran data, selesaikan langkah-langkah berikut berdasarkan konfigurasi pertukaran data:

Untuk pertukaran data dengan listingan komersial yang terintegrasi dengan Google Cloud Marketplace, hapus listingan komersial yang terintegrasi dengan Google Cloud Marketplace. Kemudian, buat ulang listingan sebagai listingan nonkomersial.
Untuk pertukaran data dengan listingan untuk beberapa wilayah, hapus semua langganan aktif menggunakan metode projects.locations.subscriptions.revoke.

Untuk menghapus pertukaran data, ikuti langkah-langkah berikut:

Konsol

Buka halaman Sharing (Analytics Hub).

Buka Berbagi (Analytics Hub)
Dari daftar pertukaran data, pilih pertukaran data yang akan dihapus.
Buka tab Detail.
Klik Delete exchange.
Pada dialog Delete exchange?, konfirmasi penghapusan dengan mengetik delete.
Klik Delete.

API

Gunakan metode projects.locations.dataExchanges.delete.

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

Ganti kode berikut:

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

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 dan pertukaran data.
Pelajari Logging audit berbagi.