Mengelola pertukaran data dalam berbagi BigQuery

Halaman ini diterjemahkan oleh Cloud Translation API.

Sebagai administrator berbagi BigQuery, Anda dapat melakukan hal berikut di berbagi BigQuery (sebelumnya Analytics Hub):

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

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 PenggunaGoogle Cloud (allAuthenticatedUsers) dapat menemukan dan berlangganan listingan, Anda dapat meminta untuk membuat pertukaran data menjadi publik.

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 Berbagi (Analytics Hub).

Membuka Berbagi (Analytics Hub)
Klik Create exchange.
Pada dialog Create exchange, pilih Project dan Region untuk pertukaran data Anda. Anda tidak dapat memperbarui project dan region setelah membuat pertukaran data.
Untuk Display name, 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. Setelah pertukaran dapat ditemukan secara publik, semua listingan dalam pertukaran akan ditampilkan dan dapat dicari dalam katalog. Jika mengaktifkan penemuan publik, Anda harus mengonfigurasi izin pertukaran. Karena pewarisan izin, semua listingan secara default akan ditetapkan dengan jenis penemuan publik yang sama dengan bursa. Oleh karena itu, bursa iklan publik tidak dapat memiliki listingan pribadi, tetapi bursa iklan pribadi dapat memiliki listingan publik (misalnya, Anda dapat menetapkan jenis kemampuan penemuan publik di tingkat listingan individual). Project tempat Anda membuat pertukaran data harus memiliki organisasi dan akun penagihan terkait.
Klik Create Exchange.
Opsional: Di bagian Exchange Permissions, lakukan langkah-langkah berikut:
1. Masukkan alamat email di kolom berikut untuk memberikan peran Identity and Access Management (IAM):
  - Administrator: pengguna ini diberi peran Admin Analytics Hub (roles/analyticshub.admin).
  - Penayang: pengguna ini diberi peran Penayang Analytics Hub (roles/analyticshub.publisher). Untuk mengetahui informasi tentang tugas yang dapat dilakukan oleh penayang yang berbagi BigQuery, lihat Mengelola listingan.
  - Pelanggan: pengguna ini diberi peran Pelanggan Analytics Hub (roles/analyticshub.subscriber). Untuk mengetahui informasi tentang tugas yang dapat dilakukan pelanggan yang berbagi BigQuery, lihat Melihat dan berlangganan listingan dan pertukaran data.
  - Pelihat: pengguna ini diberi peran Pelihat Analytics Hub (roles/analyticshub.viewer). Pelihat dapat melihat listingan.
    - Jika penemuan publik diaktifkan, berikan peran Analytics Hub Viewer 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 (sebelumnya 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.

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 Berbagi (Analytics Hub).

Membuka Berbagi (Analytics Hub)
Dari daftar pertukaran data, klik pertukaran data yang ingin Anda perbarui.
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 Berbagi (Analytics Hub).

Membuka Berbagi (Analytics Hub)
Melihat daftar pertukaran data dalam project Google Cloud Anda. Jika memiliki izin resourcemanager.organizations.get, Anda juga dapat melihat daftar pertukaran data dalam 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 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 Sharing. Anda harus membagikan link ke pertukaran data kepada penayang.

Buka halaman Berbagi (Analytics Hub).

Membuka Berbagi (Analytics Hub)
Dari daftar pertukaran data, klik More options.
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. Untuk melakukannya, ikuti langkah-langkah berikut:

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 Berbagi (Analytics Hub).

Membuka 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 Select a role, 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, Anda harus membuat administrator pertukaran data dengan memberikan peran Admin Analytics Hub (roles/analyticshub.admin) kepada pengguna di tingkat project atau 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. PenggunaGoogle Cloud (allAuthenticatedUsers) dapat menemukan dan berlangganan listingan di pertukaran data publik.

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

Untuk mengizinkan allAuthenticatedUsers melihat listingan, Anda harus memberi pengguna peran Pelihat Analytics Hub (roles/analyticshub.viewer) di tingkat pertukaran data.
Untuk mengizinkan allAuthenticatedUsers berlangganan listingan, Anda harus memberi pengguna peran Pelanggan Analytics Hub (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

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.

Sebelum menghapus pertukaran data, Anda harus melakukan 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, Anda dapat membuat 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 Berbagi (Analytics Hub).

Membuka Berbagi (Analytics Hub)
Dari daftar pertukaran data, klik pertukaran data yang ingin Anda hapus.
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

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.