Menggunakan domain data

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 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

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 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 gunakan untuk mempersempit hasil. Tambahkan filter tambahan jika perlu.

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

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

    Buka Domain data

  2. Pilih Telusuri dalam domain dari menu . Tindakan ini akan otomatis membuka jendela penelusuran dengan filter domain 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 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:

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

Mengambil konteks untuk domain data

Anda dapat menggunakan metode lookupContext untuk mendasarkan agen AI pada konteks bisnis yang dicatat oleh domain data Anda. Metode lookupContext mendukung domain data dengan cara berikut:

  • Konteks untuk domain data. Anda dapat meneruskan entri yang merepresentasikan domain data dalam daftar resources. Respons berisi metadata domain data, seperti deskripsinya dan domain data induk dalam hierarki domain.
  • Keanggotaan domain data 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 resource 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.

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

Langkah berikutnya