Dokumen ini ditujukan untuk konsumen produk data Knowledge Catalog (sebelumnya Dataplex Universal Catalog) yang ingin menemukan dan menggunakan produk data untuk kasus penggunaan mereka.
Untuk mengetahui informasi selengkapnya tentang arsitektur dan konsep utama produk data, lihat Tentang produk data.
Sebelum memulai
-
Aktifkan Dataplex, BigQuery API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menelusuri, mengakses, dan menggunakan produk data, minta administrator untuk memberi Anda peran IAM berikut pada produk data atau project:
-
Menelusuri produk data:
Dataplex Catalog Viewer (
roles/dataplex.catalogViewer) -
Menelusuri aset data dan meminta akses:
Dataplex Data Products Consumer (
roles/dataplex.dataProductsConsumer) -
Akses hanya baca untuk melihat definisi dan metadata produk data:
Dataplex Data Products Viewer (
roles/dataplex.dataProductsViewer)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Sebagai konsumen produk data, untuk melihat metadata aset, Anda harus memiliki izin viewer untuk mengakses aset yang sesuai di sistem sumber. Misalnya, untuk menelusuri metadata untuk set data atau tabel dalam produk data, Anda memerlukan peran BigQuery Metadata Viewer (roles/bigquery.metadataViewer). Untuk mengetahui informasi selengkapnya, lihat Peran yang diperlukan untuk mengakses hasil penelusuran.
Menelusuri produk data
Konsol
Di Google Cloud konsol, buka halaman Penelusuran Knowledge Catalog.
Telusuri menggunakan kata kunci atau bahasa alami. Untuk mengetahui informasi selengkapnya, lihat Menelusuri resource.
Di hasil penelusuran, klik produk data yang detailnya ingin Anda lihat. Anda dapat meninjau deskripsi, aset, kontrak, aspek, dan dokumentasi lain yang terkait dengan produk data.
REST
Untuk menelusuri produk data, gunakan
searchEntries
metode.
Misalnya, kirim permintaan POST berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
'{
"query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
"pageSize": 10
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"
Ganti kode berikut:
- ADDITIONAL_KEYWORDS (opsional): kata kunci atau kriteria penelusuran tambahan
untuk mempersempit hasil (misalnya,
displayName:'My Data Product'ataudescription:'sales') - PROJECT_ID: ID project tempat produk data dibuat Google Cloud
Meminta akses ke produk data
Sebagai konsumen produk data, jika tidak memiliki akses ke produk data, Anda dapat meminta akses dengan menyelesaikan langkah-langkah berikut:
Di Google Cloud konsol, buka halaman Produk data Knowledge Catalog.
Klik produk data yang ingin Anda akses.
Klik Minta akses.
Di panel Detail permintaan, tentukan parameter berikut:
- Jenis akses: Pilih akses yang Anda cari.
- Pesan: Berikan alasan untuk permintaan akses.
Klik Kirim. Draf email baru akan otomatis terbuka di aplikasi email default Anda (seperti Gmail atau Outlook) dengan alamat penerima serta baris subjek dan isi pesan yang telah diisi sebelumnya.
Tinjau konten email yang dibuat secara otomatis, yang berisi detail permintaan Anda.
Untuk mengirim permintaan akses ke pemilik produk data untuk disetujui, klik Kirim.
Pemilik produk data akan menerima email Anda dan meninjau permintaan Anda. Tunggu notifikasi email yang mengonfirmasi bahwa permintaan akses Anda telah disetujui atau ditolak.
Setelah disetujui, Anda akan mendapatkan akses ke produk data, dan dapat mulai menggunakannya dalam Knowledge Catalog.
Menggunakan produk data
Untuk menggunakan produk data, pastikan Anda diberi izin yang diperlukan. Lihat Meminta akses ke produk data.
Setelah pemilik produk data memberi Anda izin, Anda dapat mengakses produk data dan asetnya. Misalnya, jika diberi izin untuk mengakses tabel BigQuery, Anda dapat langsung membuat kueri di BigQuery untuk menghasilkan insight.
Untuk mengakses dan menggunakan produk data, ikuti langkah-langkah berikut:
- Telusuri produk data.
- Di hasil penelusuran, klik produk data yang ingin Anda gunakan.
- Klik tab Aset.
- Klik aset yang detailnya ingin Anda lihat. Tindakan ini akan membuka halaman detail entri. Anda dapat mengakses detail seperti skema, insight, dan silsilah. Jika asetnya adalah tabel atau tampilan BigQuery, Anda dapat mengklik Buka di BigQuery untuk membuka BigQuery Studio dan membuat kueri hasilnya.
Langkah berikutnya
- Pelajari konsep utama produk data.
- Pelajari cara membuat produk data.
- Pelajari lebih lanjut cara mengelola produk data.