Dokumen ini menjelaskan sintaksis untuk kueri penelusuran Dataplex. Sebelum membaca dokumen ini, Anda perlu memahami konsep Dataplex Catalog seperti entri data, aspek, jenis aspek, grup entri, dan jenis entri. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Dataplex Catalog.
Untuk meluncurkan kueri penelusuran Dataplex Catalog di Google Cloud Console, buka halaman Search Dataplex dan pilih Dataplex Catalog sebagai mode penelusuran.
Untuk mengetahui informasi selengkapnya, lihat Menelusuri aset data di Dataplex Catalog.
Penelusuran sederhana
Dalam bentuknya yang paling sederhana, kueri penelusuran 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
- Substring nama kolom (atau nama kolom bertingkat) dalam skema aset data
- 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 menentukan predikat dengan memberi awalan menggunakan 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 dalam hasil penelusuran.
Tokenisasi membagi aliran teks menjadi serangkaian token, yang setiap token biasanya sesuai dengan satu kata.
Contoh:
name:foo
memilih entity dengan nama yang berisi substringfoo
, sepertifoo1
danbarfoo
.description:foo
memilih entitas dengan tokenfoo
dalam deskripsi, sepertibar
danfoo
.location=foo
mencocokkan aset data di lokasi yang ditentukan denganfoo
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 nama kolom bertingkat) 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 nilai) 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 dilampirkan 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 |
Mencocokkan aset data BigQuery yang memiliki label yang kuncinya 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 dengan bar sebagai substring dalam ID. |
parent:x |
Mencocokkan x sebagai substring dari jalur hierarki suatu 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, Aset BigQuery Omni mendukung penentu ini dengan menggunakan
nama lokasi BigQuery Omni.
Misalnya,
|
createtime |
Menemukan aset data yang dibuat dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh:
Format stempel waktu: Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu
sebagian, pemisah tanggal tanda hubung ( Contoh:
|
updatetime |
Menemukan aset data yang diperbarui dalam, sebelum, atau setelah tanggal atau waktu tertentu. Contoh:
Format stempel waktu: Semua stempel waktu harus dalam GMT; zona waktu tidak didukung. Stempel waktu
sebagian, pemisah tanggal tanda hubung ( Contoh:
|
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 menelusuri entri berdasarkan aspek yang terlampir, gunakan sintaksis kueri berikut.
Penentu | Deskripsi |
---|---|
aspect:x |
Mencocokkan x sebagai substring jalur lengkap ke jenis
aspek aspek yang dilampirkan ke entri, dalam format
projectid.location.ASPECT_TYPE_ID |
aspect=x |
Mencocokkan x sebagai jalur lengkap ke jenis
aspek aspek yang dilampirkan ke entri, dalam format
projectid.location.ASPECT_TYPE_ID |
aspect:xOPERATORvalue |
Menelusuri nilai kolom aspek. Mencocokkan Daftar operator yang didukung bergantung pada jenis kolom dalam aspek, seperti berikut:
Hanya kolom aspek tingkat atas yang dapat ditelusuri. Misalnya, semua kueri berikut cocok dengan entri dengan nilai
kolom
|
Operator logika
Kueri dapat terdiri dari beberapa predikat dengan operator logika. Jika Anda tidak
menentukan operator, AND
logis akan diterapkan. 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
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 menggunakan operator OR
, Anda dapat menggunakan sintaksis singkat 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)
Sintaksis singkat ini berfungsi untuk
predikat yang memenuhi syarat, kecuali label
.
Langkah selanjutnya
- Pelajari cara menelusuri aset data di Dataplex Catalog
- Pelajari Dataplex Catalog lebih lanjut.
- Pelajari cara memperkaya entri dengan metadata menggunakan aspek.
- Pelajari cara mengelola entri dan menyerap sumber kustom.