搜索结果可解释性

当您按列名称、敏感数据标志(例如指示 PII 的方面)或业务术语库术语搜索数据资产时,搜索结果通常只会返回父级表或数据集。如果不了解表与查询匹配的原因,您必须打开每个搜索结果,浏览其架构或元数据标签页,并检查数十或数百列以找到匹配项。

Knowledge Catalog(原 Dataplex Universal Catalog)中的搜索结果可解释性功能通过在Google Cloud 控制台的搜索结果卡片上直接显示匹配的元数据,解决了这一问题。当搜索查询与资产的架构列、条目级切面、列级切面或关联的业务术语库术语匹配时,Knowledge Catalog 会在资产标题和说明之间显示可解释性标记。有了这些标记,您无需打开每个条目即可找到相关字段。相反,您可以评估每个资源与查询匹配的原因,并一目了然地识别相关列。

本文档介绍了搜索结果可解释性的运作方式、优势、可解释性标记的类型,以及如何在Google Cloud 控制台中查看可解释性。

使用场景和优势

搜索结果可解释性可在您发现整个组织的数据时提供上下文并提高效率。可解释性可以帮助您执行以下操作:

  • 快速评估相关性:您可以确定返回的数据资产是否符合您的要求,而无需打开条目详情页面来检查其架构或附加的元数据。
  • 识别列级匹配:当您搜索敏感数据标志(例如个人身份信息或 PII)、业务术语或特定列名称时,可解释性标记会显示与这些元素关联的确切架构列。
  • 减少搜索阻碍:直接在搜索结果卡片上显示匹配的上下文,减少了在搜索结果和各个“素材资源”页面之间来回导航的需要。
  • 优化搜索查询:匹配标记的反馈可帮助您确定查询是否过于宽泛,从而让您可以使用特定限定符或元数据过滤条件来优化搜索。

搜索结果可解释性的运作方式

搜索结果可解释性在 Google Cloud 控制台中处理,而不是由搜索 API 处理。

在 Google Cloud 控制台中提交搜索查询时,会发生以下过程:

  1. 搜索 API 会评估您的查询并返回匹配的条目。
  2. Google Cloud 控制台会提取每个返回条目的 metastore 表示法。
  3. Google Cloud 控制台会在您的搜索字词与条目的元数据(例如列架构、附加的切面和业务术语库术语链接)之间执行关键字匹配。
  4. 当元数据元素与您的查询字词匹配时, Google Cloud 控制台会在搜索结果卡片上呈现可解释性标记。

由于可解释性标记是通过与条目元数据进行关键字匹配生成的,因此它们仅反映与搜索字词的直接匹配。搜索 API 根据语义相似度返回的资源或列不会在可解释性标记中突出显示。例如,如果您搜索 given_name,则搜索 API 可能会根据语义返回一个包含名为 first_name 的列的表。不过,first_name 列未在可解释性标记中指明,因为关键字匹配不会将这两个字词识别为相同。

下表介绍了可解释性标记的类别:

标签类别 控制台标签 说明 示例
架构中的列 Columns: 与资源架构中的一个或多个列名称匹配。 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

标签显示和限制

搜索结果可解释性标记包含以下界面元素:

  • 帮助提示:可解释性标记旁边会显示一个信息图标。 将鼠标悬停在图标上会显示一个提示,说明该列表显示了资源的哪些部分与您的搜索匹配。
  • 标签限制和溢出:每个类别最多显示五个标签。如果单个类别中有超过五个匹配项,则溢出标记会指示剩余数量(例如 ...and 3 more)。
  • 悬停时显示标签详情:将鼠标悬停在切面或术语表术语标签上时,系统会显示一个提示,其中包含完整的切面路径、类型名称或术语详情。

在控制台中查看搜索可解释性

如需搜索数据资产并查看可解释性标签,请按照以下步骤操作:

  1. 在 Google Cloud 控制台中,前往 Knowledge Catalog 搜索页面。

    转到搜索

  2. 在搜索字段中,输入查询内容。例如:

    • 如需查找包含特定列的资产,请输入列名称。 例如 customer_id 或 column:customer_id。
    • 如需查找使用特定切面元数据标记的资产,请输入切面值或谓词。例如,PII 或 aspect:classification.tier=PII。
    • 如需查找与业务术语库术语关联的资产,请输入术语名称。

    按 Enter 键即可运行搜索。

  3. 在搜索结果列表中,观察每个结果卡片上呈现的可解释性标签,这些标签位于资产名称和说明之间。

  4. 可选:将鼠标悬停在单个标签上,即可查看其他元数据,例如完整的切面路径或术语显示名称。

  5. 如需检查完整的架构和元数据,请点击资产名称以打开条目详情页面。

    在架构标签页中,匹配的列以及关联的切面或术语会突出显示。

后续步骤