検索結果の説明可能性

列名、機密データフラグ(PII を示すアスペクトなど)、ビジネス用語集の用語でデータアセットを検索すると、従来は検索結果に親テーブルまたはデータセットのみが返されていました。テーブルがクエリに一致した理由がわからない場合は、各検索結果を開き、スキーマタブまたはメタデータタブに移動して、数十または数百の列を調べて一致を見つける必要があります。

Knowledge Catalog(旧 Dataplex Universal Catalog)の検索結果の説明可能性は、Google Cloud コンソールの検索結果カードに一致するメタデータを直接表示することで、この問題に対処します。検索クエリがアセットのスキーマ列、エントリレベルのアスペクト、列レベルのアスペクト、リンクされたビジネス用語集の用語と一致すると、Knowledge Catalog にアセットのタイトルと説明の間に説明可能性タグが表示されます。これらのタグを使用すると、関連するフィールドを見つけるためにすべてのエントリを開く必要がなくなります。代わりに、各リソースがクエリに一致した理由を評価し、関連する列をひと目で特定できます。

このドキュメントでは、検索結果の説明可能性の仕組み、そのメリット、説明可能性タグの種類、Google Cloud コンソールで説明可能性を表示する方法について説明します。

ユースケースと利点

検索結果の説明可能性により、組織全体でデータを検出する際のコンテキストと効率が向上します。説明可能性は、次のことに役立ちます。

  • 関連性をすばやく評価する: 返されたデータアセットが要件を満たしているかどうかを判断できます。エントリの詳細ページを開いてスキーマや添付されたメタデータを検査する必要はありません。
  • 列レベルの一致を特定する: 機密データフラグ(個人を特定できる情報(PII)など)、ビジネス用語、特定の列名を検索すると、説明可能性タグに、それらの要素に関連付けられた正確なスキーマ列が表示されます。
  • 検索のわずらわしさを軽減する: 一致するコンテキストを検索結果カードに直接表示することで、検索結果と個々のアセットページの間を行き来する必要がなくなります。
  • 検索クエリを絞り込む: 一致したタグからのフィードバックは、クエリが広すぎるかどうかを判断するのに役立ちます。これにより、特定の修飾子やメタデータ フィルタを使用して検索を絞り込むことができます。

検索結果の説明可能性の仕組み

検索結果の説明可能性は、検索 API ではなく Google Cloud コンソールで処理されます。

Google Cloud コンソールで検索クエリを送信すると、次のプロセスが発生します。

  1. 検索 API はクエリを評価し、一致するエントリを返します。
  2. Google Cloud コンソールは、返された各エントリの metastore 表現を取得します。
  3. Google Cloud コンソールは、検索キーワードとエントリのメタデータ(列スキーマ、アタッチされたアスペクト、ビジネス用語集の用語リンクなど)の間でキーワード マッチングを実行します。
  4. メタデータ要素がクエリキーワードと一致すると、 Google Cloud コンソールに検索結果カードに説明可能性タグが表示されます。

説明可能性タグは、エントリ メタデータに対するキーワード マッチングによって生成されるため、検索キーワードとの直接一致のみが反映されます。意味的類似性に基づいて Search API から返されたリソースまたは列は、説明可能性タグでハイライト表示されません。たとえば、given_name を検索すると、検索 API は、セマンティックな意味に基づいて first_name という名前の列を含むテーブルを返すことがあります。ただし、キーワードのマッチタイプでは 2 つのキーワードが同一であると認識されないため、first_name 列は説明可能性タグに示されません。

次の表に、説明可能性タグのカテゴリを示します。

タグのカテゴリ コンソールラベル 説明 例
スキーマの列 Columns: リソースのスキーマ内の 1 つ以上の列名と一致します。 Columns: customer_id
エントリのアスペクト Aspects: エントリレベルでリソースにアタッチされたアスペクトと一致します。 Aspects: Data Governance • confidentiality: Restricted
アスペクトを含む列 Columns with aspects: スキーマ内の特定の列にアタッチされたアスペクトと一致します。 Columns with aspects: phone_number / Data Governance • contains_pii: true
参加規約 Terms: エントリレベルでリソースにリンクされているビジネス用語集の用語を照合します。 Terms: Customer Account
用語を含む列 Columns with terms: スキーマ内の特定の列にリンクされているビジネス用語集の用語を照合します。 Columns with terms: user_email / Personally Identifiable Information

タグの表示と制限

検索結果の説明可能性タグには、次のインターフェース要素が含まれます。

  • ヘルプ ツールチップ: 説明可能性タグの横に情報アイコンが表示されます。アイコンにカーソルを合わせると、検索に一致したリソースの部分を示すリストが表示されることを説明するツールチップが表示されます。
  • タグの上限とオーバーフロー: 各カテゴリに表示されるタグは最大 5 つです。1 つのカテゴリ内で 5 つを超えるアイテムが一致する場合、オーバーフロー タグに残りの数が表示されます(例: ...and 3 more)。
  • ホバー時のタグの詳細: アスペクトまたは用語集の用語タグにカーソルを合わせると、完全なアスペクトパス、タイプ名、または用語の詳細を示すツールチップが表示されます。

コンソールで検索の説明可能性を表示する

データアセットを検索して説明可能性タグを表示する手順は次のとおりです。

  1. Google Cloud コンソールで、Knowledge Catalog の [検索] ページに移動します。

    検索に移動

  2. 検索フィールドにクエリを入力します。次に例を示します。

    • 特定の列を含むアセットを検索するには、列名を入力します。たとえば、customer_id や、column:customer_id です。
    • 特定のアスペクト メタデータでタグ付けされたアセットを検索するには、アスペクト値または述語を入力します。たとえば、PII や、aspect:classification.tier=PII です。
    • ビジネス用語集の用語にリンクされているアセットを検索するには、用語名を入力します。

    Enter キーを押して検索を実行します。

  3. 検索結果リストで、各結果カードに表示される説明可能性タグを確認します。これは、アセット名と説明の間にあります。

  4. 省略可: 個々のタグにカーソルを合わせると、完全なアスペクトパスや用語の表示名などの追加のメタデータが表示されます。

  5. 完全なスキーマとメタデータを調べるには、アセット名をクリックしてエントリの詳細ページを開きます。

    [スキーマ] タブで、一致する列と関連するアスペクトまたは用語がハイライト表示されます。

次のステップ