Menggunakan domain data

Pratinjau

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

Sebagai pengguna domain data, Anda dapat menggunakan domain data untuk mempersempit hasil penelusuran ke konteks bisnis tertentu, menelusuri set data, tabel, dan produk data BigQuery, serta menemukan metadata dalam batas domain tertentu.

Sebelum memulai

Sebelum melakukan penelusuran menurut domain, pastikan Anda memiliki peran yang diperlukan dan API yang diaktifkan.

Mengaktifkan API

Mengaktifkan Dataplex API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menelusuri dan menemukan metadata menggunakan domain data, minta administrator untuk memberi Anda peran IAM berikut di project atau domain data:

• Melihat metadata entri domain untuk penemuan: Dataplex Data Domain Entry Reader (roles/dataplex.dataDomainEntryReader)
• Melihat konfigurasi dan binding domain: Dataplex Data Domain Configuration Viewer (roles/dataplex.dataDomainViewer)

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.

Menjelajahi hierarki domain

Untuk mengetahui informasi selengkapnya tentang cara menjelajahi hierarki domain, lihat Melihat domain dan subdomain data di lokasi.

Menemukan resource dalam domain data

Untuk menelusuri resource dengan domain, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Knowledge Catalog > Search.

   Buka Penelusuran

2. Klik Coba penelusuran organik untuk mengaktifkan fitur penelusuran organik.

3. Klik Filter.

4. Di kolom Cakupan, pilih Domain dari daftar.

5. Di kolom Pilih domain, pilih domain yang ingin Anda gunakan untuk mempersempit hasil. Tambahkan filter tambahan jika perlu.

Atau, Anda dapat menggunakan opsi menu Telusuri dalam domain untuk menemukan resource dalam domain:

1. Di konsol Google Cloud , buka halaman Domain data.

   Buka Domain data

2. Pilih Cari dalam domain dari menu more_vert. Tindakan ini akan otomatis membuka jendela penelusuran dengan filter domain diterapkan.

3. Gunakan kolom penelusuran untuk menemukan resource di domain.

REST

Untuk menelusuri entri yang dicakup ke domain data, gunakan metode projects.locations.searchEntries dan berikan jalur domain dalam parameter contexts.

Catatan: Lokasi dalam jalur untuk searchEntries dapat berupa global (untuk fanout penuh) atau wilayah tertentu, bergantung pada konfigurasi backend penelusuran Anda.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID Google Cloud project Anda.
• LOCATION_ID: region untuk kueri penelusuran (atau global).
• QUERY: string kueri penelusuran.
• DOMAIN_ID: ID unik domain data yang menentukan konteks cakupan penelusuran.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

Meminta isi JSON:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Batasan

Saat Anda menelusuri resource di luar konteks domain, misalnya saat menggunakan penelusuran global, izin penemuan domain tidak berlaku. Anda hanya melihat resource yang memiliki akses di sistem yang mendasarinya, seperti BigQuery.

Misalkan set data BigQuery disertakan dalam domain data. Anda memiliki peran Dataplex Data Domain Entry Reader untuk domain, tetapi Anda tidak memiliki izin langsung untuk melihat set data di BigQuery:

• Menelusuri dalam domain: Anda melihat set data dalam hasil penelusuran karena izin domain berlaku.
• Menelusuri di luar domain: Anda tidak melihat set data dalam hasil penelusuran. Dalam penelusuran umum, izin domain tidak berlaku, dan Anda tidak memiliki akses langsung di BigQuery.

Langkah berikutnya

• Pelajari domain data lebih lanjut.
• Pelajari cara membuat domain data.
• Pelajari cara mengelola resource domain data.