搜索资源

使用 Dataplex Universal Catalog 搜索功能在 BigQuery 中查找 Trusted Cloud 资源，例如 BigQuery 数据集和表。

Dataplex Universal Catalog 搜索支持自然语言搜索查询（也称为语义搜索查询），让您可以使用日常用语搜索资源。

与关键字搜索类似，自然语言搜索通过分析组织中资源的关联元数据来加强资源发现。搜索会考虑描述资源的各种元数据，包括您创建的元数据。

自然语言搜索更注重提高回想度，而非精确度。

如需详细了解如何在 BigQuery 中搜索表数据，请参阅 BigQuery 搜索简介。

注册预览版

如需注册预览版，您的 Google 客户代表必须填写报名表单提交申请。您提交表单后，BigQuery 团队会与您联系，告知您后续步骤。

准备工作

在 BigQuery 中使用自然语言搜索功能搜索Trusted Cloud 资源之前，请完成本部分中的任务。

所需的角色

如需搜索资源，您需要对用于搜索的项目至少拥有以下一个 Dataplex Universal Catalog IAM 角色：Dataplex Catalog Admin、Dataplex Catalog Editor 或 Dataplex Catalog Viewer。搜索结果的权限检查独立于所选项目。

BigQuery 中的搜索结果会根据您对底层资源的 IAM 权限进行限定。如需在 BigQuery 中搜索资源，您必须拥有访问相应资源的权限。如需了解详情，请参阅本文档的搜索范围部分。

例如，如需搜索 BigQuery 数据集、表、视图和模型，您需要拥有访问这些资源的相应权限。如需了解详情，请参阅 BigQuery 权限。 以下列表介绍了所需的最低权限：

  • 如需搜索表，您需要拥有该表的 bigquery.tables.get 权限。
  • 如需搜索数据集，您需要拥有该数据集的 bigquery.datasets.get 权限。

BigQuery Metadata Viewer 角色 (roles/bigquery.metadataViewer) 同时包含 bigquery.tables.get 和 bigquery.datasets.get 权限，可让您搜索任何 BigQuery 资源。

如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

启用 API

如需使用搜索功能，请确保已启用 Dataplex API。 对于所有使用 BigQuery 的新 Trusted Cloud 项目，Dataplex API 均默认处于启用状态。如果您的项目中未启用 Dataplex API，请参阅启用 Dataplex Universal Catalog。

  1. 在 Trusted Cloud 控制台中，前往 BigQuery Search 页面。

    转到搜索

  2. 在搜索字段中，用自然语言输入查询内容，然后按 Enter 键。以下是一些示例查询：

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country

  3. 如需过滤搜索结果，请点击过滤条件。您可以使用下列过滤条件：

    • 范围：在整个组织（默认）、当前项目或仅在已加星标的资源中进行搜索。如需了解详情，请参阅本文档的搜索范围部分。
    • 系统：资源所属的 Trusted Cloud 服务，例如 BigQuery。Dataplex Universal Catalog 系统包含条目组。
    • 项目：要搜索的项目。
    • 类型：资源类型，例如 BigQuery 连接、Cloud Storage 存储桶或数据库。根据资源类型的不同，您还可以按子类型（例如连接类型或 SQL 方言）进行过滤。
    • 选择位置：要搜索的位置。
    • 选择数据集：此选项会将搜索结果限制为属于所选 BigQuery 数据集的 BigQuery 资源。 在输入内容进行过滤字段中，输入数据集的名称。
    • 注释：与您要搜索的资源相关联的 Dataplex Universal Catalog 方面类型。如需按方面值过滤，请点击按注解值过滤，然后选择相应值。

    如需移除过滤条件，请点击要移除的特定过滤条件旁边的 清除。或者，如需移除所有过滤条件，请点击清除过滤条件。

    如需详细了解过滤条件的评估方式，请参阅本文档的过滤条件部分。

  4. 可选：如需查看有关资源的更多信息，请在搜索结果中点击资源名称。

    这会在分屏窗格中打开资源摘要。执行以下任意操作：

    • 如需在资源所属的服务中打开该资源，请点击相应资源的在 PRODUCT_NAME 中打开。 例如，如需在 BigQuery Studio 中打开 BigQuery 数据集，请点击在 Studio 中打开。可用的选项取决于资源。
    • 如需查看与资源关联的 Dataplex Universal Catalog 元数据，请点击相应资源的 Open in Dataplex Catalog。
    • 如果您有想要添加书签的重要搜索结果，可以为其添加星标。点击相应资源的 加星标图标。 您可以在 BigQuery Studio 中查看已加星标的资源。
    • 如需关闭分屏窗格中的资源摘要，请点击 关闭。

过滤条件

借助过滤条件，您可以缩小搜索结果的范围。

如果您在多个部分中提供过滤条件，系统会使用 AND 逻辑运算符评估这些过滤条件。搜索结果包含与所选每个部分中至少一个条件相匹配的资源。例如，如果您选择 BigQuery 系统和 dataset 资源类型，则搜索结果会包含 BigQuery 数据集，但不包含 Vertex AI 数据集。

如果您在单个部分中选择多个过滤条件，系统会使用 OR 逻辑运算符来评估这些过滤条件。例如，如果您选择 dataset 资源类型和 table 资源类型，则搜索结果会同时包含数据集和表。

搜索范围

对于属于 Trusted Cloud 组织的搜索，搜索范围限定在该组织内。

搜索结果会考虑您对资源的权限。例如，如果您拥有某个资源的 BigQuery 元数据读取权限，则该资源会显示在您的搜索结果中。如果您有权访问某个 BigQuery 表，但无权访问该表所属的数据集，则该表仍会按预期方式显示在搜索结果中。

搜索结果仅包含与执行搜索的项目属于同一 VPC Service Controls 边界的资源。使用 Trusted Cloud 控制台时，这是在控制台中选择的项目。

后续步骤