Sintaksis penelusuran untuk Katalog Dataplex

Dokumen ini menjelaskan sintaksis untuk kueri penelusuran Dataplex. Sebelum membaca dokumen ini, Anda harus memahami konsep Katalog Dataplex seperti entri data, aspek, jenis aspek, grup entri, dan jenis entri. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Katalog Dataplex.

Catatan: Dokumen ini menjelaskan sintaksis penelusuran untuk Katalog Dataplex. Untuk informasi tentang sintaksis penelusuran Data Catalog, lihat Sintaksis penelusuran Data Catalog dan Katalog Dataplex versus Data Catalog.

Untuk meluncurkan kueri penelusuran Dataplex Catalog di konsol Google Cloud, buka halaman Penelusuran Dataplex dan pilih Dataplex Catalog sebagai mode penelusuran.

Buka Penelusuran

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

Penelusuran sederhana

Dalam bentuk yang paling sederhana, kueri penelusuran Katalog Dataplex terdiri dari satu predikat. Predikat tersebut dapat mencocokkan beberapa bagian metadata:

• Substring nama, nama tampilan, atau deskripsi resource
• Substring dari jenis resource
• Substring nama kolom (atau nama kolom bertingkat) dalam skema resource
• Substring project ID
• String dari deskripsi ringkasan

Misalnya, predikat foo cocok dengan entitas berikut:

• Resource dengan nama foo.bar
• Resource dengan nama tampilan Foo Bar
• Resource dengan deskripsi This is the foo script
• Resource dengan jenis persis foo
• Kolom foo_bar dalam skema resource
• Kolom bertingkat foo_bar dalam skema resource
• Project prod-foo-bar
• Resource dengan ringkasan yang berisi kata foo

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 cocok dengan predikat ke 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 entity dengan nama yang berisi substring foo, seperti foo1 dan barfoo.
• description:foo memilih entitas dengan token foo dalam deskripsi, seperti bar dan foo.
• location=foo mencocokkan resource di lokasi yang ditentukan dengan foo sebagai nama lokasi.

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

Katalog Dataplex mendukung penentu berikut:

Penentu	Deskripsi
name:x	Mencocokkan x sebagai substring dari ID resource.
displayname:x	Mencocokkan x sebagai substring dari nama tampilan resource.
column:x	Mencocokkan x sebagai substring dari 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 dari jalur hierarkis resource. Jalur induk adalah fully_qualified_name dari resource induk.
orgid=number	Mencocokkan resource dalam organisasi Google Cloud dengan nilai ID persis number.
system=SYSTEM	Mencocokkan resource dari sistem yang ditentukan.
location=LOCATION	Mencocokkan resource di lokasi yang ditentukan 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 Northern Virginia.
createtime	Menemukan resource yang dibuat dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh: createtime:2019-01-01 cocok dengan resource yang dibuat pada 01-01-2019. createtime<2019-02 cocok dengan resource yang dibuat sebelum 01-02-2019T00:00:00. createtime>2019-02 cocok dengan resource yang dibuat setelah 01-02-2019T00:00:00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu sebagian, 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 01-01-2019. updatetime<2019-02 cocok dengan resource yang diperbarui sebelum 01-02-2019T00:00:00. updatetime>2019-02 cocok dengan resource yang diperbarui setelah 01-02-2019T00:00:00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu sebagian, 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 aspek

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

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

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 dari 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 waktu: sama seperti untuk angka, tetapi nilai yang akan dibandingkan diperlakukan sebagai tanggal waktu, bukan angka Boolean: = Hanya kolom tingkat atas dari aspek yang dapat ditelusuri. Misalnya, semua kueri berikut cocok dengan entri dengan nilai kolom is-enrolled di 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

Operator logika

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

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

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

Operator logika tidak peka huruf besar/kecil. Misalnya, or dan OR dapat diterima.

Sintaksis singkat

Sintaksis penelusuran singkat juga tersedia, menggunakan | (garis 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 terlihat seperti berikut:

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

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

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

Sintaksis singkat ini berfungsi untuk predikat yang memenuhi syarat kecuali untuk label.

Langkah selanjutnya

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