Menggunakan domain data

Domain data di Knowledge Catalog (sebelumnya Dataplex Universal Catalog) memungkinkan Anda mempersempit hasil penelusuran ke konteks bisnis tertentu dan menemukan metadata dalam batasan yang ditentukan. Sebagai pengguna domain data, Anda dapat menjelajahi hierarki domain, menelusuri resource domain, dan mengambil konteks domain untuk melakukan grounding pada agen AI.

Sebelum memulai

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

Mengaktifkan API

Aktifkan Dataplex API, jika belum diaktifkan.

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 Service Usage Admin (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 pada project atau domain data:

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

Anda dapat menelusuri dalam domain data untuk menemukan resource seperti set data, tabel, dan produk data BigQuery, serta melihat metadatanya. Untuk menelusuri fasilitas dalam domain, ikuti langkah-langkah berikut:

Konsol

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

    Buka Penelusuran

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

  3. Klik Filter.

  4. Di kolom Scope, pilih Domain dari daftar.

  5. Di kolom Pilih domain, pilih domain yang ingin Anda persempit hasilnya. Tambahkan filter tambahan jika perlu.

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

  1. Di konsol Google Cloud , buka halaman Data domains.

    Buka Domain data

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

  3. Gunakan kolom penelusuran untuk menemukan fasilitas di domain.

REST

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud 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:

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

Mengambil konteks untuk domain data

Anda dapat menggunakan metode lookupContext untuk men-grounding agen AI dalam konteks bisnis yang dicakup oleh domain data Anda. Metode lookupContext mendukung domain data dengan cara berikut:

  • Konteks untuk domain data. Anda dapat meneruskan entri yang mewakili domain data dalam daftar resources. Respons berisi metadata domain data, seperti deskripsinya dan domain data induk dalam hierarki domain.
  • Keanggotaan domain data dari aset data. Saat Anda mengambil konteks untuk aset data yang disertakan dalam satu atau beberapa domain data, responsnya berisi kolom dataDomains yang mencantumkan domain data tempat aset tersebut berada, dimulai dengan domain yang paling spesifik dan naik ke domain level teratas.

Untuk mengambil konteks domain data, kirim permintaan berikut:

curl --request POST \
  'https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:lookupContext' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      "projects/PROJECT_ID/locations/LOCATION/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION/dataDomains/DATA_DOMAIN_ID"
    ],
    "options": {
      "format": "yaml"
    }
  }'

Ganti kode berikut:

  • PROJECT_ID: ID project yang berisi domain data.
  • PROJECT_NUMBER: nomor project yang berisi domain data.
  • LOCATION: lokasi domain data.
  • DATA_DOMAIN_ID: ID domain data.

Untuk mengetahui informasi selengkapnya tentang metode lookupContext, lihat Mengambil konteks untuk aset data.

Batasan

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

Misalnya, 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 di hasil penelusuran. Dalam penelusuran umum, izin domain tidak berlaku, dan Anda tidak memiliki akses langsung di BigQuery.

Langkah berikutnya