Sintaksis penelusuran untuk Katalog Universal Dataplex

Dokumen ini menjelaskan sintaks untuk kueri penelusuran Dataplex Universal Catalog. Sebelum membaca dokumen ini, Anda harus memahami konsep pengelolaan metadata di Katalog Universal Dataplex, seperti entri, aspek, jenis aspek, grup entri, dan jenis entri. Untuk mengetahui informasi selengkapnya, lihat artikel Tentang pengelolaan metadata di Dataplex Universal Catalog.

Katalog Universal Dataplex menawarkan dua mode penelusuran: penelusuran kata kunci dan penelusuran bahasa alami (Pratinjau).

Penelusuran kata kunci memungkinkan Anda menemukan resource menggunakan kata kunci, filter, dan sintaksis yang ditentukan.

Penelusuran bahasa alami memperluas penelusuran kata kunci untuk mendukung kueri bahasa alami. Dengan fitur ini, Anda dapat menemukan resource menggunakan bahasa sehari-hari, sehingga tidak perlu menggunakan sintaksis yang rumit.

Dokumen ini mencakup sintaksis untuk penelusuran kata kunci dan bahasa alami.

Untuk meluncurkan kueri penelusuran Dataplex Universal Catalog di konsolGoogle Cloud , buka halaman Penelusuran Dataplex Universal Catalog dan pilih Dataplex Universal Catalog sebagai platform penelusuran.

Buka Penelusuran

Untuk mengetahui informasi selengkapnya, lihat Menelusuri resource di Katalog Universal Dataplex.

Penelusuran teks bebas

Anda dapat menemukan aset dengan memasukkan istilah atau frasa tanpa sintaksis tertentu. Katalog Universal Dataplex melakukan penelusuran luas dengan mencocokkan kueri Anda dengan beberapa kolom metadata, termasuk yang berikut:

• Nama, nama tampilan, atau deskripsi resource
• Jenis resource
• ID Project
• Deskripsi ringkasan
• Nama kolom (atau nama kolom bertingkat) dalam skema resource
• Deskripsi kolom
• Nama yang sepenuhnya memenuhi syarat
• Kontak
• Aspek

Menelusuri dengan sintaksis kueri

Untuk penelusuran yang lebih akurat, Anda dapat membuat kueri menggunakan sintaksis tertentu, termasuk penentu, operator logika, dan penelusuran aspek.

Predikat yang memenuhi syarat

Anda dapat memenuhi syarat predikat dengan menambahkan awalan kunci yang membatasi pencocokan ke bagian metadata tertentu:

• Tanda sama dengan (=) membatasi penelusuran ke pencocokan persis.
• Titik dua (:) setelah kunci mencocokkan predikat dengan substring atau token dalam nilai di hasil penelusuran.

Tokenisasi membagi aliran teks menjadi serangkaian token, dengan setiap token biasanya sesuai dengan satu kata.

Contoh:

• name:foo memilih resource dengan nama yang berisi substring foo, seperti foo1 dan barfoo.
• description:foo memilih resource dengan token foo dalam deskripsi, seperti bar dan foo.
• location=foo mencocokkan resource di lokasi tertentu dengan foo sebagai nama lokasi.

Perilaku penentu ini dapat sedikit bervariasi di antara mode penelusuran, seperti yang dijelaskan di bagian berikut.

Penelusuran kata kunci

Kunci predikat type, system, location, dan orgid hanya mendukung penentu kecocokan persis (=), bukan penentu substring (:). Misalnya, type=foo atau orgid=number.

Dataplex Universal Catalog mendukung penentu berikut untuk penelusuran kata kunci:

Penentu	Deskripsi
name:x	Mencocokkan x sebagai substring ID resource.
displayname:x	Cocokkan x sebagai substring dari nama tampilan resource.
column:x	Mencocokkan x sebagai substring nama kolom (atau nama kolom bertingkat) dalam skema resource.
description:x	Mencocokkan x sebagai token dalam deskripsi resource.
label:bar	Mencocokkan resource BigQuery yang memiliki label (dengan beberapa nilai) dan kunci label memiliki bar sebagai substring.
label=bar	Mencocokkan resource BigQuery yang memiliki label (dengan beberapa nilai) dan kunci label sama dengan bar sebagai string.
label:bar:x	Mencocokkan x sebagai substring dalam nilai label dengan kunci bar yang dilampirkan ke resource BigQuery.
label=foo:bar	Mencocokkan resource BigQuery dengan kunci yang sama dengan foo dan nilai kunci yang sama dengan bar.
label.foo=bar	Mencocokkan resource BigQuery dengan kunci yang sama dengan foo dan nilai kunci yang sama dengan bar.
label.foo	Mencocokkan resource BigQuery yang memiliki label dengan kunci yang sama dengan foo sebagai string.
type=TYPE	Mencocokkan resource dari jenis entri tertentu atau alias jenisnya.
projectid:bar	Mencocokkan resource dalam project Google Cloud yang cocok dengan bar sebagai substring dalam ID.
parent:x	Mencocokkan x sebagai substring jalur hierarkis resource. Jalur induk adalah fully_qualified_name dari resource induk.
orgid=number	Mencocokkan resource dalam organisasi Google Cloud dengan nilai ID yang sama persis dengan number.
system=SYSTEM	Mencocokkan resource dari sistem yang ditentukan.
location=LOCATION	Mencocokkan resource di lokasi tertentu dengan nama yang sama persis. Misalnya, location=us-central1 cocok dengan aset yang dihosting di Iowa. Aset BigQuery Omni mendukung penentu ini dengan menggunakan nama lokasi BigQuery Omni. Misalnya, location=aws-us-east-1 cocok dengan aset BigQuery Omni di Virginia Utara.
createtime	Menemukan resource yang dibuat dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh: createtime:2019-01-01 cocok dengan resource yang dibuat pada 1 Januari 2019. createtime<2019-02 cocok dengan resource yang dibuat sebelum 2019-02-01T00.00.00. createtime>2019-02 cocok dengan resource yang dibuat setelah 2019-02-01T00.00.00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu parsial, pemisah tanggal tanda hubung (-), dan pemisah tanggal garis miring (/) didukung. Contoh: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
updatetime	Menemukan resource yang diperbarui dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh: updatetime:2019-01-01 cocok dengan resource yang diperbarui pada 1 Januari 2019. updatetime<2019-02 cocok dengan resource yang diperbarui sebelum 2019-02-01T00.00.00. updatetime>2019-02 cocok dengan resource yang diperbarui setelah 2019-02-01T00.00.00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu parsial, pemisah tanggal tanda hubung (-), dan pemisah tanggal garis miring (/) didukung. Contoh: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
fully_qualified_name:x	Mencocokkan x sebagai substring dari fully_qualified_name.
fully_qualified_name=x	Mencocokkan x sebagai fully_qualified_name.

Penelusuran bahasa alami

Pratinjau

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

Kunci predikat type, system, location, dan description, serta penelusuran aspek (kecuali has) hanya mendukung kualifikasi kecocokan persis (=), bukan kualifikasi substring (:). Misalnya, type=foo.

Katalog Universal Dataplex mendukung penentu berikut untuk penelusuran bahasa alami:

Penentu	Deskripsi
name:x	Mencocokkan x sebagai substring ID resource atau nama tampilan resource.
displayname:x	Cocokkan x sebagai substring dari nama tampilan resource.
column:x	Mencocokkan x sebagai substring nama kolom (atau nama kolom bertingkat) dalam skema resource.
description:x	Mencocokkan x sebagai token dalam deskripsi resource.
labels:bar	Mencocokkan resource BigQuery yang memiliki label (dengan beberapa nilai) dan kunci label memiliki bar sebagai substring.
labels=bar	Mencocokkan resource BigQuery yang memiliki label (dengan beberapa nilai) dan kunci label sama dengan bar sebagai string.
labels.bar:x	Mencocokkan x sebagai substring dalam nilai label dengan kunci bar yang dilampirkan ke resource BigQuery.
labels.foo=bar	Mencocokkan resource BigQuery dengan kunci yang sama dengan foo dan nilai kunci yang sama dengan bar.
type=TYPE	Mencocokkan resource dari jenis entri tertentu atau alias jenisnya.
projectid:bar	Mencocokkan resource dalam project Google Cloud yang cocok dengan bar sebagai substring dalam ID.
parent:x	Mencocokkan x sebagai substring jalur hierarkis resource.
system=SYSTEM	Mencocokkan resource dari sistem yang ditentukan.
location=LOCATION	Mencocokkan resource di lokasi tertentu dengan nama yang sama persis. Misalnya, location=us-central1 cocok dengan aset yang dihosting di Iowa. Aset BigQuery Omni mendukung penentu ini dengan menggunakan nama lokasi BigQuery Omni. Misalnya, location=aws-us-east-1 cocok dengan aset BigQuery Omni di Virginia Utara.
createtime	Menemukan resource yang dibuat dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh: createtime:2019-01-01 cocok dengan semua resource yang dibuat pada 2019-01-01. createtime<2019-02 cocok dengan semua resource yang dibuat sebelum 2019-02-01T00.00.00. createtime>2019-02 cocok dengan semua resource yang dibuat setelah 2019-02-01T00.00.00. createtime>-30d cocok dengan semua resource yang dibuat dalam 30 hari terakhir. createtime<=-30d cocok dengan semua resource yang dibuat 30 hari yang lalu atau sebelumnya. createtime<=-1d cocok dengan semua resource yang dibuat pada hari sebelumnya. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu parsial, pemisah tanggal tanda hubung (-), dan pemisah tanggal garis miring (/) didukung. Contoh: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
updatetime	Menemukan resource yang diperbarui dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh: updatetime:2019-01-01 cocok dengan semua resource yang diperbarui pada 2019-01-01. updatetime<2019-02 cocok dengan semua materi yang diperbarui sebelum 2019-02-01T00.00.00. updatetime>2019-02 cocok dengan semua materi yang diperbarui setelah 2019-02-01T00.00.00. updatetime>-30d cocok dengan semua resource yang diperbarui dalam 30 hari terakhir. updatetime<-30d cocok dengan semua resource yang diupdate 30 hari yang lalu atau lebih awal. updatetime=-1d cocok dengan semua resource yang diperbarui pada hari sebelumnya. updatetime>=-30d cocok dengan semua resource yang diperbarui dalam 30 hari terakhir. updatetime<=-30d cocok dengan semua resource yang diupdate 30 hari yang lalu atau lebih awal. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu parsial, pemisah tanggal tanda hubung (-), dan pemisah tanggal garis miring (/) didukung. Contoh: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22

Penelusuran aspek

Untuk menelusuri entri berdasarkan aspek yang dilampirkan, gunakan sintaksis kueri berikut.

Catatan: Pencocokan substring mencoba mencocokkan dengan sejumlah aspek terbatas. Jika Anda tidak dapat menemukan entri menggunakan fragmen jalur, gunakan jalur lengkap untuk mempersempit penelusuran dan meningkatkan perolehan.

Penelusuran kata kunci

Penentu	Deskripsi
aspect:x	Mencocokkan x sebagai substring dari jalur lengkap ke jenis aspek dari aspek yang dilampirkan ke entri, dalam format projectid.location.ASPECT_TYPE_ID
aspect=x	Mencocokkan x sebagai jalur lengkap ke jenis aspek dari aspek yang dilampirkan ke entri, dalam format projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue	Menelusuri nilai kolom aspek. Mencocokkan x sebagai substring dari jalur lengkap ke jenis aspek dan nama kolom aspek yang dilampirkan ke entri, dalam format projectid.location.ASPECT_TYPE_ID.FIELD_NAME Daftar operator yang didukung bergantung pada jenis kolom dalam aspek, sebagai berikut: String: = (pencocokan persis) dan : (substring) Semua jenis angka: =, :, <, >, <=, >=, =>, =< Enum: = Tanggal dan waktu: sama seperti untuk angka, tetapi nilai yang akan dibandingkan diperlakukan sebagai tanggal dan waktu, bukan angka Boolean: = Hanya kolom tingkat teratas aspek yang dapat ditelusuri. Misalnya, semua kueri berikut cocok dengan entri yang nilai kolom is-enrolled dalam aspek employee-info adalah true. Entri lain yang cocok dengan substring juga akan ditampilkan. aspect:example-project.us-central1.employee-info.is-enrolled=true aspect:example-project.us-central1.employee=true aspect:employee=true

Penelusuran bahasa alami

Pratinjau

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

Penentu	Deskripsi
has:x	Mencocokkan x sebagai substring dari jalur lengkap ke jenis aspek dari aspek yang dilampirkan ke entri, dalam format projectid.location.ASPECT_TYPE_ID
has=x	Mencocokkan x sebagai jalur lengkap ke jenis aspek dari aspek yang dilampirkan ke entri, dalam format projectid.location.ASPECT_TYPE_ID
has:xOPERATORvalue	Menelusuri nilai kolom aspek. Mencocokkan x sebagai substring dari jalur lengkap ke jenis aspek dan nama kolom aspek yang dilampirkan ke entri, dalam format berikut: Sintaksis untuk jenis aspek sistem: ASPECT_TYPE_ID.FIELD_NAME dataplex-types.ASPECT_TYPE_ID.FIELD_NAME dataplex-types.LOCATION.ASPECT_TYPE_ID.FIELD_NAME Misalnya, kueri berikut cocok dengan entri yang nilai kolom type di aspek bigquery-dataset adalah default: bigquery-dataset.type=default dataplex-types.bigquery-dataset.type=default dataplex-types.global.bigquery-dataset.type=default Sintaksis untuk jenis aspek kustom: Jika aspek dibuat di region global: PROJECT_ID.ASPECT_TYPE_ID.FIELD_NAME Jika aspek dibuat di wilayah tertentu: PROJECT_ID.REGION.ASPECT_TYPE_ID.FIELD_NAME Misalnya, kueri berikut cocok dengan entri yang nilai kolom is-enrolled di aspek employee-info adalah true. example-project.us-central1.employee-info.is-enrolled=true example-project.employee-info.is-enrolled=true Daftar operator yang didukung bergantung pada jenis kolom dalam aspek, sebagai berikut: String: = (kecocokan persis) Semua jenis angka: =, :, <, >, <=, >=, =>, =< Enum: = Tanggal dan waktu: sama seperti untuk angka, tetapi nilai yang akan dibandingkan diperlakukan sebagai tanggal dan waktu, bukan angka Boolean: = Hanya kolom tingkat teratas aspek yang dapat ditelusuri.

Operator logika

Kueri dapat terdiri dari beberapa predikat dengan operator logika. Jika Anda tidak menentukan operator, AND logis akan tersirat. Misalnya, foo bar menampilkan resource yang cocok dengan predikat foo dan predikat bar.

AND logis dan OR logis didukung. Misalnya, foo OR bar.

Anda dapat meniadakan predikat dengan awalan - (tanda hubung) atau NOT. Misalnya, -name:foo menampilkan resource dengan nama yang tidak cocok dengan predikat foo.

Catatan: Dalam penelusuran kata kunci, operator logika tidak peka huruf besar/kecil. Dalam penelusuran bahasa alami, operator logika peka huruf besar/kecil dan harus dalam huruf besar.

Sintaksis singkat

Sintaksis penelusuran singkat juga tersedia, menggunakan | (batang vertikal) untuk operator OR dan , (koma) untuk operator AND.

Misalnya, untuk menelusuri entri di dalam salah satu dari banyak project menggunakan operator OR, Anda dapat menggunakan sintaksis singkat berikut:

projectid:(id1|id2|id3|id4)

Penelusuran yang sama tanpa menggunakan sintaksis singkat akan terlihat seperti berikut:

projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4

Untuk menelusuri entri dengan nama kolom yang cocok, gunakan perintah berikut:

• AND: column:(name1, name2, name3)
• OR: column:(name1|name2|name3)

Sintaksis singkat ini berfungsi untuk predikat yang memenuhi syarat, kecuali label dalam penelusuran kata kunci.

Langkah berikutnya

• Pelajari cara menelusuri resource di Dataplex Universal Catalog
• Pelajari lebih lanjut pengelolaan metadata di Dataplex Universal Catalog.
• Pelajari cara memperkaya entri dengan metadata menggunakan aspek.
• Pelajari cara mengelola entri dan menyerap sumber kustom.