搜索资源

使用 Dataplex 通用目录搜索功能 Google Cloud 查找 BigQuery 中的资源，例如 BigQuery 数据集和表。

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

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

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

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

注册预览版

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

准备工作

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

所需的角色

如需搜索资源，您需要在用于搜索的项目中至少拥有以下 Dataplex Universal Catalog IAM 角色之一：Dataplex Catalog 管理员、Dataplex Catalog 编辑者或 Dataplex Catalog 查看者。系统会独立于所选项目检查搜索结果的权限。

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 的新 Google Cloud 项目默认启用 Dataplex API。如果您的项目中未启用 Dataplex API，请参阅启用 Dataplex Universal Catalog。

  1. 在 Google Cloud 控制台中，前往 BigQuery 搜索页面。

    转到搜索

  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. 如需过滤搜索结果，请点击过滤条件。您可以使用以下滤镜：

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

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

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

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

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

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

过滤条件

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

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

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

搜索范围

对于属于某个组织的项目，搜索会在该组织的范围内进行。 Google Cloud

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

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

后续步骤