Sintaksis penelusuran untuk Dataplex Catalog

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.

Buka Penelusuran

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

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 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 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, 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 aset data yang dibuat dalam, sebelum, atau setelah tanggal atau waktu tertentu.

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 01-02-2019T00:00:00.
  • createtime>2019-02 cocok dengan aset data 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 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 aset data yang diperbarui dalam, sebelum, atau setelah tanggal atau waktu tertentu.

Contoh:

  • updatetime:2019-01-01 cocok dengan aset data yang diperbarui pada 01-01-2019.
  • updatetime<2019-02 cocok dengan aset data yang diperbarui sebelum 01-02-2019T00:00:00.
  • updatetime>2019-02 cocok dengan aset data 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 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 fully_qualified_name.
fully_qualified_name=x Cocok dengan x sebagai fully_qualified_name.

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 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 dalam aspek, seperti 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 dengan nilai kolom is-enrolled dalam aspek employee-info adalah true. Entri lain yang cocok pada 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 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