Mengelola produk data

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Spesifik per Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini ditujukan bagi pemilik produk data yang ingin memperbarui, menghapus, dan memberikan akses ke produk data di Dataplex Universal Catalog.

Untuk mengetahui informasi selengkapnya tentang arsitektur dan konsep utama produk data, lihat Tentang produk data.

Sebelum memulai

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Catatan: Panduan ini mengasumsikan bahwa Anda memiliki produk data yang ada untuk dikelola. Untuk mengetahui informasi selengkapnya tentang cara membuat dan mengonfigurasi produk data, lihat Membuat produk data.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola produk data, minta administrator untuk memberi Anda peran IAM berikut pada project:

• Izin penuh untuk membuat, memperbarui, menghapus, dan mengelola izin untuk produk data: Admin Produk Data Dataplex (roles/dataplex.dataProductAdmin)
• Memperbarui dan mengelola produk data yang ada: Editor Produk Data Dataplex (roles/dataplex.dataProductEditor)
• Tambahkan aspek seperti schema, overview, dan contacts: Pemilik Entri dan EntryLink Dataplex (roles/dataplex.entryOwner)
• Menelusuri dan menambahkan aset: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• Mengedit jenis aspek sistem seperti aspek dokumentasi dan kontrak dari irama pembaruan: Editor Katalog Dataplex (roles/dataplex.catalogEditor)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola produk data. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola produk data:

• Edit jenis aspek sistem overview: dataplex.entryGroups.useOverviewAspect
• Edit jenis aspek sistem refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Memberikan akses ke produk data

Pemilik produk data harus membuat produk mereka dapat ditemukan dan memberikan peran yang diperlukan, sehingga konsumen dapat menelusuri, melihat, dan meminta akses ke produk data.

Untuk memberi konsumen produk data izin yang mereka perlukan untuk berinteraksi dengan produk data, beri mereka peran IAM berikut pada resource produk data:

• Telusuri dan akses produk data di penelusuran Dataplex Universal Catalog: Pengguna Produk Data Dataplex (dataplex.dataProductsConsumer)
• Akses hanya baca untuk melihat definisi dan metadata produk data: Pelihat Produk Data Dataplex (dataplex.dataProductViewer)
• Meminta akses ke produk data: Konsumen Produk Data Dataplex (dataplex.dataProductsConsumer)

Saat konsumen produk data meminta akses ke produk data, pemilik produk data akan menerima notifikasi email.

Untuk memberikan akses, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Groups.

   Buka halaman Grup

2. Telusuri grup yang terkait dengan tingkat izin yang diminta dan pilih grup tersebut.

3. Klik  Tambahkan anggota.

4. Tambahkan akun utama.

5. Klik Simpan.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola grup Google di konsol Google Cloud .

Memperbarui produk data

Anda dapat memperbarui detail dasar (misalnya, nama produk data, deskripsi, detail pemilik), aset, grup akses, izin, kontrak, aspek, dan dokumentasi tambahan untuk produk data yang ada.

Memperbarui detail dasar produk data

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang ingin Anda perbarui.

3. Klik Edit produk data.

4. Perbarui Nama produk data, Ikon, Deskripsi, Kontak pemilik, dan Label sesuai kebutuhan.

5. Klik Perbarui produk data.

REST

Untuk memperbarui detail dasar produk data, gunakan metode dataProducts.patch.

Misalnya, untuk memperbarui deskripsi produk data, kirim permintaan PATCH berikut:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Ganti kode berikut:

• NEW_DESCRIPTION: deskripsi baru untuk produk data
• PROJECT_ID: ID project Google Cloud Anda
• LOCATION: region tempat produk data berada
• DATA_PRODUCT_ID: ID produk data Anda

Memperbarui aset produk data

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang asetnya ingin Anda perbarui.

3. Klik tab Aset.

4. Untuk menambahkan aset baru, ikuti langkah-langkah berikut:

   1. Klik +Add.

   2. Telusuri dan pilih aset yang ingin Anda tambahkan ke produk data. Aset yang Anda pilih harus berada di region yang sama dengan produk data.

      Jika memiliki izin yang diperlukan, Anda dapat melihat metadata aset dengan mengklik aset.

   3. Untuk menyaring hasil penelusuran, gunakan Filter.

   4. Setelah Anda memilih aset, klik Tambahkan.

5. Untuk menghapus aset dari produk data, ikuti langkah-langkah berikut:

   1. Untuk aset yang ingin Anda hapus, klik > Hapus.

   2. Untuk mengonfirmasi tindakan, klik Hapus.

REST

Untuk menambahkan aset data baru ke produk data, gunakan metode dataAssets.create. Untuk contoh kode, lihat Opsional: Tambahkan aset.

Untuk menghapus aset data dari produk data, gunakan metode dataAssets.delete. Misalnya, kirim permintaan DELETE berikut:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• LOCATION: region tempat Anda ingin membuat produk data
• DATA_PRODUCT_ID: ID unik untuk produk data Anda
• DATA_ASSET_ID: ID aset data yang ingin dihapus dari produk data

Memperbarui grup akses dan izin aset

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang ingin Anda perbarui grup akses dan izinnya.

3. Klik tab Grup akses & izin.

4. Untuk memperbarui grup akses, ikuti langkah-langkah berikut:

   1. Klik Edit.

   2. Perbarui nama, deskripsi, dan ID grup akses sesuai kebutuhan.

   3. Untuk menambahkan grup akses baru, klik Tambahkan grup akses dan ikuti langkah-langkah berikut:

      1. Di kolom Nama grup akses, masukkan nama untuk grup akses baru. Contoh, Analyst.

      2. Di kolom Deskripsi grup akses, masukkan deskripsi untuk grup akses.

      3. Di kolom Access group identifier, masukkan alamat email grup Google yang ingin Anda tetapkan ke grup akses ini. Konsumen produk data yang meminta akses ke grup akses ini dapat ditambahkan sebagai anggota ke grup Google yang dipetakan.

         Anda dapat menambahkan maksimal tiga grup akses per produk data.

   4. Klik Tambahkan.

5. Untuk menghapus grup akses, ikuti langkah-langkah berikut:

   1. Untuk grup akses yang ingin Anda hapus, klik > Hapus.

   2. Untuk mengonfirmasi tindakan, klik Hapus.

6. Jika tidak ada grup akses yang dikonfigurasi untuk produk data yang dipilih, Anda dapat menambahkan grup akses baru dengan mengklik Tambahkan grup akses.

7. Untuk memperbarui izin aset, ikuti langkah-langkah berikut:

   1. Untuk aset yang izinnya ingin Anda perbarui, klik > Izin.

   2. Perbarui grup akses dan peran IAM yang diperlukan.

   3. Klik Configure.

REST

Untuk memperbarui grup akses yang terkait dengan produk data, gunakan metode dataProducts.patch. Untuk contoh kode, lihat Mengonfigurasi grup akses.

Untuk memperbarui izin aset, gunakan metode dataAssets.patch. Untuk contoh kode, lihat Mengonfigurasi izin aset.

Memperbarui kontrak produk data

Catatan: Ritme refresh tidak dapat diedit setelah Anda menambahkannya ke kontrak. Jika Anda mencoba mengubah nilai ini, error berikut akan ditampilkan: You don't have permission to change contract values.

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang kontraknya ingin Anda perbarui.

3. Klik tab Kontrak.

4. Untuk memperbarui kontrak yang ada, ikuti langkah-langkah berikut:

   1. Klik Edit.

   2. Perbarui kolom yang diperlukan.

   3. Klik Simpan.

5. Jika tidak ada kontrak yang dilampirkan ke produk data yang dipilih, Anda dapat menambahkan kontrak dengan mengklik Tambahkan kontrak.

REST

Untuk memperbarui kontrak, gunakan metode entries.patch. Untuk contoh kode, lihat Menambahkan kontrak.

Memperbarui aspek produk data

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang aspeknya ingin Anda perbarui.

3. Klik tab Aspek.

4. Untuk memperbarui aspek, ikuti langkah-langkah berikut:

   1. Klik aspek yang ingin Anda perbarui.

   2. Klik Edit.

   3. Perbarui Jenis aspek, Negara, dan Wilayah sesuai kebutuhan.

   4. Klik Simpan.

5. Untuk menambahkan aspek baru pada produk data, ikuti langkah-langkah berikut:

   1. Klik + Tambahkan aspek.

   2. Di kolom Pilih jenis aspek, telusuri dan pilih jenis aspek dari daftar. Contoh, Geo context.

   3. Di kolom Negara, pilih negara tempat aset berada.

   4. Di kolom Region, pilih wilayah bisnis tempat aset berada.

   5. Klik Simpan.

6. Untuk menghapus aspek, ikuti langkah-langkah berikut:

   1. Klik aspek yang ingin Anda hapus.

   2. Klik .

   3. Untuk mengonfirmasi tindakan, klik Konfirmasi.

REST

Untuk memperbarui aspek apa pun pada entri produk data, gunakan metode entries.patch.

Memperbarui dokumentasi produk data

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang dokumentasinya ingin Anda perbarui.

3. Klik tab Overview.

4. Klik Edit di samping Dokumentasi.

5. Perbarui panduan pengguna, contoh kueri, dan dokumentasi lainnya sesuai kebutuhan.

6. Klik Simpan.

REST

Dokumentasi adalah bagian dari aspek overview. Untuk memperbarui dokumentasi produk data, gunakan metode entries.patch.

Menghapus produk data

Untuk menghapus produk data, Anda harus menghapus semua aset dari produk data terlebih dahulu.

Konsol

1. Di konsol Google Cloud , buka halaman Produk data Dataplex Universal Catalog.

   Buka Produk data

2. Klik produk data yang ingin Anda hapus.

3. Klik tab Aset.

4. Untuk setiap aset yang tercantum, klik > Hapus. Konfirmasi tindakan dengan mengklik Hapus.

5. Setelah menghapus semua aset, hapus produk data dengan mengklik Hapus.

6. Pada dialog konfirmasi, masukkan delete, lalu klik Hapus.

REST

Untuk menghapus produk data, gunakan metode dataProducts.delete.

Misalnya, kirim permintaan DELETE berikut:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda
• LOCATION: region tempat produk data berada
• DATA_PRODUCT_ID: ID produk data yang ingin Anda hapus

Langkah berikutnya

• Pelajari cara menelusuri produk data.
• Pelajari cara meminta akses untuk produk data.