Sintaksis penelusuran untuk Dataplex Catalog

Dokumen ini menjelaskan sintaksis untuk kueri penelusuran Dataplex. Sebelum pembaruan Anda membaca dokumen ini, penting bagi Anda untuk memahami konsep-konsep dari Dataplex Catalog seperti entri data, aspek, jenis aspek, grup entri, dan jenis entri. Untuk informasi selengkapnya, lihat Ringkasan Dataplex Catalog.

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

Untuk meluncurkan kueri pencarian Dataplex Catalog di Konsol Google Cloud, buka halaman Search Dataplex dan pilih Dataplex Catalog sebagai mode penelusuran.

Buka Penelusuran

Untuk informasi selengkapnya, lihat Menelusuri aset data di Dataplex Catalog.

Penelusuran sederhana

Dalam bentuknya yang paling sederhana, kueri pencarian Dataplex Catalog terdiri dari satu predikat. Predikat seperti itu dapat cocok dengan beberapa bagian metadata:

• Substring dari nama, nama tampilan, atau deskripsi dari aset data
• Substring dari jenis aset data
• {i>Substring<i} dari nama kolom (atau kolom bertingkat) dalam skema data aset
• Substring dari project ID
• String dari deskripsi ringkasan

Misalnya, predikat foo cocok dengan entity berikut:

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

Predikat yang memenuhi syarat

Anda dapat mengkualifikasi sebuah predikat dengan mengawalinya dengan kunci yang membatasi pencocokan dengan bagian metadata tertentu:

• Tanda sama dengan (=) membatasi penelusuran pada pencocokan yang tepat.
• Titik dua (:) setelah kunci cocok dengan predikat dengan substring atau token dalam nilai di hasil penelusuran.

Tokenisasi membagi aliran teks menjadi serangkaian token, dengan masing-masing token yang biasanya sesuai dengan satu kata.

Contoh:

• name:foo memilih entitas 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 aset data di lokasi yang ditentukan dengan foo sebagai nama lokasi.

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

Dataplex Catalog mendukung penentu berikut:

Penentu	Deskripsi
name:x	Mencocokkan x sebagai substring dari ID aset data.
displayname:x	Cocokkan x sebagai substring dari nama tampilan aset data.
column:x	Mencocokkan x sebagai substring nama kolom (atau bertingkat nama kolom) dalam skema aset data.
description:x	Mencocokkan x sebagai token dalam deskripsi aset data.
label:bar	Mencocokkan aset data BigQuery yang memiliki label (dengan beberapa ) dan kunci label memiliki bar sebagai substring.
label=bar	Mencocokkan aset data 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 disertakan ke aset data BigQuery.
label=foo:bar	Mencocokkan aset data BigQuery yang kuncinya sama dengan foo dan nilai kunci sama dengan bar.
label.foo=bar	Mencocokkan aset data BigQuery yang kuncinya sama dengan foo dan nilai kunci sama dengan bar.
label.foo	Cocok dengan aset data BigQuery yang memiliki label yang kunci sama dengan foo sebagai string.
type=TYPE	Mencocokkan aset data dari jenis entri tertentu atau alias jenisnya.
projectid:bar	Mencocokkan aset data dalam project Google Cloud yang cocok bar sebagai substring dalam ID.
parent:x	Mencocokkan x sebagai substring dari jalur hierarkis aset data. Jalur induk adalah fully_qualified_name dari resource induk.
orgid=number	Mencocokkan aset data dalam organisasi Google Cloud dengan nilai ID number yang tepat.
system=SYSTEM	Mencocokkan aset data dari sistem tertentu.
location=LOCATION	Mencocokkan aset data 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 BigQuery Omni penting di Virginia Utara.
createtime	Menemukan aset data yang dibuat dalam, sebelum, atau setelah tertentu tanggal atau waktu. Contoh: createtime:2019-01-01 cocok dengan aset data yang dibuat pada 01-01-2019. createtime<2019-02 cocok dengan aset data yang dibuat sebelum 2019-02-01T00:00:00. createtime>2019-02 cocok dengan aset data yang dibuat setelah 2019-02-01T00:00:00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tertentu tidak didukung. Sebagian stempel waktu, tanda hubung (-), dan garis miring Pemisah tanggal (/) 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 aset data yang diperbarui dalam, sebelum, atau setelah tanggal atau waktu. Contoh: updatetime:2019-01-01 cocok dengan aset data yang diperbarui 01-01-2019. updatetime<2019-02 cocok dengan aset data yang diperbarui sebelum 2019-02-01T00:00:00. updatetime>2019-02 cocok dengan aset data yang diperbarui setelah 2019-02-01T00:00:00. Format stempel waktu: YYYY-MM-DDThh:mm:ss Semua stempel waktu harus dalam GMT; zona waktu tertentu tidak didukung. Sebagian stempel waktu, tanda hubung (-), dan garis miring Pemisah tanggal (/) 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 fully_qualified_name.
fully_qualified_name=x	Cocok dengan x sebagai fully_qualified_name.

Penelusuran aspek

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

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

Penentu	Deskripsi
aspect:x	Mencocokkan x sebagai substring dari jalur lengkap ke aspek jenis aspek yang dilampirkan pada entri, dalam format projectid.location.ASPECT_TYPE_ID
aspect=x	Mencocokkan x sebagai jalur lengkap ke aspek jenis aspek yang dilampirkan pada entri, dalam format projectid.location.ASPECT_TYPE_ID
aspect:xOPERATORvalue	Menelusuri nilai kolom aspek. Mencocokkan x sebagai substring 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 di aspek, sebagai berikut: String: = (pencocokan persis) dan : (substring) Semua jenis angka: =, :, <, >, <=, >=, =>, =< Enum: = Datetime: sama seperti angka, tetapi nilai yang akan dibandingkan diperlakukan sebagai datetime bukan angka Boolean: = Hanya kolom aspek tingkat atas yang dapat ditelusuri. Misalnya, semua kueri berikut cocok dengan entri yang nilai kolom is-enrolled di employee-info aspeknya adalah true. Entri lain yang cocok pada substring juga dikembalikan. 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, logika AND tersirat. Misalnya, foo bar menampilkan entity yang cocok dengan predikat foo dan predikat bar.

Logis AND 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 adalah masih dapat diterima.

Singkatan sintaksis

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

Misalnya, untuk menelusuri entri di dalam salah satu dari banyak project yang menggunakan OR operator, Anda dapat menggunakan singkatan sintaks berikut:

projectid:(id1|id2|id3|id4)

Penelusuran yang sama tanpa menggunakan sintaks yang disingkat akan terlihat seperti berikut:

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

Untuk mencari entri dengan nama kolom yang cocok, gunakan yang berikut:

• DAN: column:(name1, name2, name3)
• ATAU: column:(name1|name2|name3)

{i>Syntax<i} yang disingkat ini berfungsi untuk predikat yang memenuhi syarat kecuali untuk label.

Langkah selanjutnya

• Pelajari cara menelusuri aset data dalam Dataplex Catalog
• Pelajari Dataplex Catalog lebih lanjut.
• Pelajari cara memperkaya entri dengan metadata menggunakan aspek.
• Pelajari cara mengelola entri dan menyerap sumber kustom.