Sintaksis penelusuran untuk Katalog Universal Dataplex

Dokumen ini menjelaskan sintaks untuk kueri penelusuran Katalog Universal Dataplex. 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.

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

Buka Penelusuran

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

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

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

Misalnya, predikat foo cocok dengan resource berikut:

  • Resource dengan nama foo.bar
  • Resource dengan nama tampilan Foo Bar
  • Resource dengan deskripsi This is the foo script
  • Resource dengan jenis yang sama 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 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.

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

Katalog Universal Dataplex mendukung penentu berikut:

Penentu Deskripsi
name:x Mencocokkan x sebagai substring ID resource.
displayname:x Cocokkan x sebagai substring 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 2019-01-01.
  • 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.

Untuk menelusuri entri berdasarkan aspek terlampirnya, gunakan sintaksis kueri berikut.

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: =
  • Datetime: 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 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 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.

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

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.

Langkah berikutnya