使用 Data Catalog 搜索模型和数据集资源

本页面介绍了如何使用 Data Catalog 搜索并管理 Vertex AI 模型和数据集资源。您可以使用 Dataplex 的 Data Catalog 功能访问不同项目中的所有代管式资源。

Data Catalog 是 Dataplex 中的全代管式可扩缩元数据管理服务。该服务会自动为 Vertex AI 模型和数据集的以下元数据编制目录：

• 模型和数据集资源的名称和完全限定名称、
• 位置（区域）、
• 创建日期和最后修改日期、
• Model Alias 和 Model Version ID Dataset 数据项计数、
• 说明。

Vertex AI 模型和数据集元数据会定期自动同步到 Data Catalog。您可以使用 Data Catalog 来发现和了解 Vertex AI 元数据。使用 Data Catalog 帮助完成以下活动：

• 搜索您有权访问的所有项目和位置中具有特定模型别名和模型名称的模型。举例来说，如要搜索特定的模型别名，请使用 model_version_alias=my-model-alias。
• 使用数据集名称、数据集 ID 在您有权访问的所有项目和位置中搜索数据集。

借助 Data Catalog，您可以通过将标记附加到 Vertex AI 资源来挑选元数据。每个标记可以有多个元数据字段，并且可以基于预定义或自定义标记模板。

例如，您可以将以下标记附加到包含部署环境名称的列：

deployed_to:Test

如需详细了解 Data Catalog，请参阅 Data Catalog 概览

注意：Data Catalog 将 Vertex AI 和其他 Cloud 服务中的资源称为资产。从现在开始，我们将 Vertex AI 资源称为 Vertex AI 资源。术语“资产”用于表示资源和资源的 Data Catalog 元数据。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. 为项目启用 Data Catalog API。

   启用 Data Catalog API

7. 请检查权限。

   您需要特定的 Identity and Access Management (IAM) 角色和权限才能搜索标记并将其附加到 Vertex AI 资产。如需了解详情，请参阅 Data Catalog 所需的 IAM 角色和权限。

创建标记模板

标记模板是可用于快速创建新标记的可重复使用结构。模板可帮助您避免重复性工作和未完成的标记。根据需要创建任意数量的标记模板。

如需了解详情，请参阅标记和标记模板。

将标记附加到 Vertex AI 资产

通过将标记附加到 Vertex AI 资源，您可以执行以下操作：

• 将资产元数据添加到资产。
• 按业务元数据和其他自定义元数据搜索资产。

如需了解详情，请参阅标记和标记模板。

搜索 Vertex AI 资产

使用 Google Cloud 控制台中的 Dataplex 搜索页面搜索 Vertex AI 资产。

1. 转到 Dataplex 搜索页面。

   进入 Dataplex

2. 在系统面板的系统下，选择 Vertex AI。

   Dataplex 显示所有已知的 Vertex AI 资产。

3. 可选：执行以下任一操作来缩小搜索范围：

   • 在搜索页面上使用分面搜索。选中数据类型、项目和标记下的复选框。

   • 在搜索字段中，在 system=vertex_ai 后附加搜索参数。用空格分隔参数。

     例如，如需仅查看模型，请在搜索字段中输入以下文本，然后按 Enter。

     system=vertex_ai type=model
     

     您还可以使用复杂的括号和逻辑运算符 and 和 or 来表示复杂表达式。如需详细了解可在搜索字段中使用的表达式，请参阅 Data Catalog 搜索语法。

4. 在结果表中，点击资产的名称以查看该资产的元数据。

5. 可选：您可以执行以下任一操作：

   • 点击添加概览，为素材资源添加富文本说明。
   • 点击添加标记以向资源添加标记。

Data Catalog 所需的 IAM 角色和权限

在 Data Catalog 中查看、标记和搜索 Vertex AI 资源时，需要满足不同的权限要求。

查看公开和非公开标记所需的权限

如需获得查看 Vertex AI 资源的公开和非公开标记所需的权限，请让您的管理员授予您以下 IAM 角色：

• roles/datacatalog.tagTemplateViewer
• roles/aiplatform.viewer

搜索 Vertex AI 资源的权限

如需获得在 Data Catalog 中搜索 Vertex AI 资源所需的权限，请让您的管理员授予您以下 IAM 角色：

• roles/aiplatform.user

将标记附加到 Vertex AI 资源的权限

如需获得在 Data Catalog 中将标记附加到 Vertex AI 资源所需的权限，请让您的管理员授予您以下 IAM 角色：

• roles/datacatalog.tagTemplateUser
• roles/datacatalog.tagEditor
• roles/aiplatform.admin

如需了解详情，请参阅预定义角色。

后续步骤

• 什么是 Data Catalog
• 搜索 Google Cloud 资源的角色