このドキュメントでは、Dataplex Universal Catalog のキーワード検索と自然言語 AI 検索の両方の構文について説明します。
Dataplex Universal Catalog を使用すると、組織のデータを検出、一元的にカタログ化、管理、把握できます。Data Catalog 内の特定のデータアセットを効率的に見つけるには、強力な検索クエリを使用します。検索クエリの構文には、次のものが含まれます。
- シンプルな検索: 単一の検索キーワードを使用してデータアセットを見つける方法。
- 修飾された述語: 名前、場所、説明などの特定のメタデータ フィールドを使用して検索を絞り込む方法。
- アスペクト検索: 添付されたビジネス メタデータとテクニカル メタデータに基づいてエントリを検索する方法。
- 論理演算子: AND と OR を使用して複数の検索条件を組み合わせ、複雑なクエリを作成する方法。この構文を理解することで、必要なデータをすばやく見つけることが可能です。
始める前に
Dataplex Universal Catalog のエントリ、アスペクト、アスペクト タイプ、エントリ グループ、エントリタイプについて理解します。Dataplex Universal Catalog のメタデータ管理について
Dataplex Universal Catalog には、キーワード検索と自然言語検索の 2 つの検索モードがあります。
- キーワード検索では、特定のキーワード、フィルタ、定義された構文を使用してリソースを検索できます。
- 自然言語検索は、AI を活用してセマンティック クエリを理解します。普段使う言葉でリソース AI を検索できます。複雑な構文を使用する必要はありません。
このドキュメントでは、キーワード検索と自然言語検索の両方の構文について説明します。AI Google Cloud コンソールで Dataplex Universal Catalog 検索クエリを起動するには、Dataplex Universal Catalog の [検索] ページに移動し、検索プラットフォームとして [Dataplex Universal Catalog] を選択します。
詳細については、Dataplex Universal Catalog でリソースを検索するをご覧ください。
全文検索
特定の構文を使用せずに、用語やフレーズを入力してアセットを検索できます。Dataplex Universal Catalog は、次のものを含む複数のメタデータ フィールドをクエリすることで、広範な検索を実行します。
- リソースの名前、表示名、説明
- リソースのタイプ
- プロジェクト ID
- 概要説明
- リソースのスキーマにおける列名(またはネストされた列名)
- 列の説明
- 完全修飾名
- コンタクト
- アスペクト
クエリ構文で検索する
より正確な検索を行うには、修飾子、論理演算子、アスペクト検索など、特定の構文を使用してクエリを作成します。
修飾された述語
述語の先頭にキーを付けて修飾すると、照合範囲を特定のメタデータ部分に限定できます。
- 等号(
=)は、検索の対象を完全一致に制限します。 - キーの後のコロン(
:)は、述語を検索結果内の値に含まれる部分文字列またはトークンと照合します。
トークン化により、テキストのストリームが一連のトークン(各トークンは通常 1 つの単語に対応)に分割されます。
例:
name:fooは、foo部分文字列を含む名前(foo1、barfooなど)のリソースを選択します。description:fooは、説明にfooトークンがあるリソース(bar、fooなど)を選択します。location=fooは、ロケーション名がfooで指定されたロケーションのリソースに一致します。
これらの修飾子の動作は、検索モードによって若干異なる場合があります(以降のセクションで詳しく説明します)。
キーワード検索
述語キー type、system、location、orgid は、部分文字列修飾子(:)ではなく、完全一致修飾子(=)のみをサポートします(例: type=foo、orgid=number)。
Dataplex Universal Catalog は、キーワード検索で次の修飾子をサポートしています。
| 修飾子 | 説明 |
|---|---|
name:x |
x をリソース ID の部分文字列として一致させます。 |
displayname:x |
x をリソースの表示名の部分文字列と照合します。 |
column:x |
x をリソースのスキーマの列名(またはネストされた列名)の部分文字列と照合します。 |
description:x |
x をリソースの説明のトークンと照合します。 |
label:bar |
ラベル(値があるもの)を持つ BigQuery リソースと一致させます。ラベルキーには部分文字列として bar があります。 |
label=bar |
ラベル(値があるもの)を持つ BigQuery リソースと一致させます。ラベルキーは文字列として bar と等しくなります。 |
label:bar:x |
x を BigQuery リソースに関連付けられたキー bar を含むラベルの値の部分文字列として一致させます。 |
label=foo:bar |
キーが foo でキー値が bar である BigQuery リソースと一致させます。 |
label.foo=bar |
キーが foo でキー値が bar である BigQuery リソースと一致させます。 |
label.foo |
ラベルを持ち、ラベルキーが文字列として foo と等しい BigQuery リソースと一致させます。 |
type=TYPE |
特定のエントリタイプまたはそのタイプ エイリアスのリソースと照合します。 |
projectid:bar |
ID の部分文字列として bar と一致する Google Cloud プロジェクト内のリソースと照合します。 |
parent:x |
x をリソースの階層パスの部分文字列と照合します。親パスは、親リソースの fully_qualified_name です。 |
orgid=number |
Google Cloud 組織内のリソースを number の正確な ID 値と一致させます。 |
system=SYSTEM |
指定されたシステムのリソースを照合します。 |
location=LOCATION |
指定されたロケーションのリソースを正確な名前と照合します。たとえば、 BigQuery Omni アセットは、BigQuery Omni のロケーション名を使用してこの修飾子をサポートしています。たとえば、 |
createtime |
指定した日時以前または以降に作成されたリソースを検索します。 例:
タイムスタンプ形式( すべてのタイムスタンプは GMT にする必要があります(タイムゾーンはサポートされていません)。部分的なタイムスタンプ、ハイフン( 例:
|
updatetime |
指定した日時以前または以降に更新されたリソースを検索します。 例:
タイムスタンプ形式( すべてのタイムスタンプは GMT にする必要があります(タイムゾーンはサポートされていません)。部分的なタイムスタンプ、ハイフン( 例:
|
fully_qualified_name:x |
x を fully_qualified_name の部分文字列として一致させます。 |
fully_qualified_name=x |
x を fully_qualified_name として一致させます。 |
自然言語検索
述語キー type、system、location、description、アスペクト検索(has を除く)は、部分文字列修飾子(:)ではなく、完全一致修飾子(=)のみをサポートします(例: type=foo)。
Dataplex Universal Catalog は、自然言語検索で次の修飾子をサポートしています。
| 修飾子 | 説明 |
|---|---|
name:x |
x をリソース ID またはリソースの表示名の部分文字列と照合します。 |
displayname:x |
x をリソースの表示名の部分文字列と照合します。 |
column:x |
x をリソースのスキーマの列名(またはネストされた列名)の部分文字列と照合します。 |
description:x |
x をリソースの説明のトークンと照合します。 |
labels:bar |
ラベル(値があるもの)を持つ BigQuery リソースと一致させます。ラベルキーには部分文字列として bar があります。 |
labels=bar |
ラベル(値があるもの)を持つ BigQuery リソースと一致させます。ラベルキーは文字列として bar と等しくなります。 |
labels.bar:x |
x を BigQuery リソースに関連付けられたキー bar を含むラベルの値の部分文字列として一致させます。 |
labels.foo=bar |
キーが foo でキー値が bar である BigQuery リソースと一致させます。 |
type=TYPE |
特定のエントリタイプまたはそのタイプ エイリアスのリソースと照合します。 |
projectid:bar |
ID の部分文字列として |