使用 Knowledge Catalog 管理 AlloyDB 资源

所有新的 AlloyDB 集群默认启用知识目录集成，让您可以使用知识目录（一个可用于存储、管理和访问元数据的平台）搜索和管理 AlloyDB for PostgreSQL 资源。此集成可帮助您发现和了解 AlloyDB 元数据，支持以下使用情形：

分析：了解依赖关系并评估对各种使用情形的适用性。
变更管理：有效跟踪和管理元数据变更。
架构演变：监控和规划架构修改。

知识目录会自动从 AlloyDB 集群、实例、数据库、表、列和视图中检索以下元数据：

名称
位置（区域）
标签（适用于集群和实例）
已启用 Dataplex 集成（针对集群）
数据库版本
机器 CPU 数量（针对实例）
可用性类型（适用于实例）
字符集（适用于数据库）
排序规则（适用于数据库）
所有者
说明（适用于表、视图、列和外键）
类型（适用于集群、实例和机器）
列
- 数据类型
- 模式
主键
外键
- 被引用的表
- 列映射
创建时间
上次修改时间

元数据发现类型

知识目录元数据发现是一个自动化流程，用于扫描已连接的数据源（例如 AlloyDB），以识别表、视图和数据库等数据资产。然后，知识目录会将资产（例如架构、说明和位置）中的技术元数据提取到知识目录中。

此进程会近乎实时地同步元数据，从而使目录与源系统保持同步。对于 AlloyDB，系统默认会发现集群和实例元数据。在新集群上，默认启用数据库、架构、表和视图元数据发现功能。对于在实施此默认设置（2026 年 2 月 26 日）之前创建的集群，请手动启用集成。

关键字搜索和自然语言搜索

知识目录支持关键字搜索和自然语言搜索。

借助关键字搜索，您可以使用特定关键字、过滤条件和定义的语法来查找资源。例如，如需查看所有 AlloyDB 数据库，请输入 system=AlloyDB AND type=Database。
自然语言搜索（预览版）使用 AI 来理解语义查询。借助它，您可以使用日常语言查找资源，无需使用复杂的语法。例如，输入 List all AlloyDB tables related to sales 等查询内容。

如需了解详情，请参阅知识目录的搜索语法。

示例：发现 AlloyDB 数据库架构

为了解元数据发现过程，不妨考虑一个名为 user-data-cluster 且已启用 Knowledge Catalog 集成的 AlloyDB 集群示例。在此集群的主实例中，存在一个名为 profiles 的数据库，其中包含一个表 customers（id、email、signup_date）和一个视图 active_users（id、email）。

由于 AlloyDB 会近乎实时地与知识目录同步，因此以下资源可供使用：

集群
列
数据库
实例
表格
视图

发现完成后，您可以在 Google Cloud 控制台的知识目录页面中或使用 API 搜索这些资产（customers 表和 active_users）。然后，查看其架构，并使用其他业务或运营元数据丰富这些资产。

使用切面丰富元数据

切面类型是可重复使用的资源，可用作切面的模板。切面类型有助于避免重复性工作和创建不完整的切面。使用知识目录创建必要的切面类型。

创建自定义切面类型后，将切面关联到 AlloyDB 资产。通过将切面关联到 AlloyDB 资产，您可以执行以下操作：

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

如需详细了解如何创建切面类型并将切面附加到 AlloyDB，请参阅管理切面并丰富元数据。

元数据发现工作流

默认情况下，集群和实例资源会被注入并可供发现。如需注入和发现数据库、架构、表和视图资源，请按以下步骤操作：

使用 AlloyDB API 为 AlloyDB 集群启用 Knowledge Catalog 集成（如果尚未启用）。对于 2026 年 2 月 26 日之前创建的集群，这是必需的。
使用 Google Cloud 控制台中的 Knowledge Catalog 搜索页面搜索 AlloyDB 资产。如需了解详情，请参阅在知识目录中搜索资源。
如需为 AlloyDB 资产添加更多上下文，请将切面附加到资产。切面是自定义元数据条目，有助于进行数据治理和分析。例如，您可以使用切面来标记包含个人身份信息 (PII) 的列。如需了解详情，请参阅管理切面并丰富元数据。
您可以按照以下层次结构浏览 AlloyDB 资源：集群 > 数据库 > 架构 > 表或视图 > 列。此层次结构可让您详细了解自己的数据格局。如需了解详情，请参阅在知识目录中搜索资源。

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

为项目启用 Dataplex API。

启用 Dataplex API
请检查权限。

您必须拥有特定的 Identity and Access Management (IAM) 角色和权限才能搜索条目并将其关联到 AlloyDB 资产。如需了解详情，请参阅 Knowledge Catalog 所需的 IAM 角色和权限。

所需 IAM 角色

本部分介绍搜索资源和访问搜索结果所需的角色和权限。

访问搜索结果所需的角色

如需在 Knowledge Catalog 中搜索和查看 AlloyDB 元数据，主账号必须拥有查看 AlloyDB 资源的权限，包括 dataplex.projects.search 权限。

如需向主账号（例如用户、组或服务账号）授予这些权限，请向其分配包含 AlloyDB 资源的项目的 AlloyDB Viewer (roles/alloydb.viewer) IAM 角色。

知识目录操作	AlloyDB 资源	所需的角色或权限
搜索 AlloyDB 资源	集群	`alloydb.clusters.get`
	列	`alloydb.databases.get`
	实例	`alloydb.instances.get`
	数据库	`alloydb.databases.get`
	表格	`alloydb.databases.get`
	视图	`alloydb.databases.get`

如果您不想使用预定义的 AlloyDB Viewer 角色，请分配包含 alloydb.clusters.get、alloydb.instances.get 和 alloydb.databases.get 权限的自定义角色。

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

搜索条目所需的角色

您必须在用于搜索的项目中至少拥有下列一个 IAM 角色：

Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
Dataplex Catalog Editor (roles/dataplex.catalogEditor)
Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

搜索结果的权限检查独立于所选项目。如需了解详情，请参阅使用 Knowledge Catalog 搜索数据资产。

知识目录集成数据新鲜度

默认情况下，知识目录会注入并发现集群和实例资源，并且其元数据新鲜度近乎实时。

创建新的 AlloyDB 集群时，系统会默认启用针对数据库、架构、表和视图资源的知识目录集成。如需阻止同步此元数据，请停用集成。

启用集成后，系统会启用 AlloyDB 元数据（例如数据库、架构和表）导出到 Cloud Storage 存储分区以进行定期同步，或导出到 Pub/Sub 主题以进行近乎实时的同步，从而使 Knowledge Catalog 可以使用这些元数据。此功能仅适用于主集群。用于跨区域复制的辅助集群不支持将知识目录集成到数据库、架构、表和视图元数据中。

这些资源的元数据新鲜度取决于集群的创建或恢复时间：

近乎实时：在 2026 年 4 月 3 日或之后创建或恢复的集群会近乎实时地将元数据同步到知识目录。知识目录中的更新最多可能需要 5 分钟才会生效。提取过程通常需要几秒钟。
每隔几个小时：在 2026 年 2 月 26 日至 2026 年 4 月 3 日之间创建或恢复的集群每隔几个小时会在知识目录中刷新元数据。知识目录中的更新最多可能需要 48 小时才能生效。提取过程通常需要几分钟，但完成时间取决于 CPU 大小和表数量。

创建已停用 Knowledge Catalog 集成的 AlloyDB

您可以在使用 Google Cloud CLI 或 AlloyDB API 创建或更新集群时控制此集成：

gcloud

使用 gcloud alloydb clusters create 命令创建 AlloyDB 集群。如果您省略 --enable-dataplex-integration 标志，系统会默认启用 Knowledge Catalog 集成，以获取数据库、架构、表和视图元数据。如需查看此调用的完整参数列表，请参阅 gcloud alloydb clusters create。如需了解集群设置，请参阅查看集群和实例设置。

请勿在集群 ID 中包含敏感信息或个人身份信息，因为集群 ID 可能会在各种操作环境中显示，例如系统日志、监控信息中心和支持通信。无需在集群名称中包含项目 ID。系统会在适当的位置（例如在日志文件中）自动包含此信息。

如需针对数据库、架构、表和视图资源停用 Knowledge Catalog 集成，请添加 --no-enable-dataplex-integration 标志：

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

进行以下替换：

CLUSTER_ID：您创建的集群的 ID。集群 ID 必须以小写字母开头，可以包含小写字母、数字和连字符。
PASSWORD：您用于默认 postgres 用户的密码。
REGION：集群区域的 ID。

REST

使用 POST 方法创建 AlloyDB 集群。如果您在请求中省略 dataplexConfig，系统会默认为数据库、架构、表和视图元数据启用 Knowledge Catalog 集成。如需查看此调用的完整参数列表，请参阅方法：projects.locations.clusters.create。如需了解集群设置，请参阅查看集群和实例设置。

如需针对数据库、架构、表和视图资源停用 Knowledge Catalog 集成，请在请求正文中添加 "dataplexConfig": { "enabled": false }：

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : false
  }
}

进行以下替换：

DATABASE_VERSION：数据库版本的枚举字符串，例如 POSTGRES_16。
INITIAL_USERNAME：您用于默认 postgres 用户的用户名。
INITIAL_USER_PASSWORD：您用于默认 postgres 用户的密码。

使用以下 HTTP 方法和网址：

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

进行以下替换：

PROJECT_ID：包含集群的 Google Cloud 项目的 ID 或项目编号。
LOCATION_ID：集群区域的 ID。
CLUSTER_ID：您创建的集群的 ID。集群 ID 必须以小写字母开头，可以包含小写字母、数字和连字符。

如需发送您的请求，请使用以下方式之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

您会收到类似以下内容的 JSON 响应：

响应

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

为 AlloyDB 集群启用知识目录集成

如需在现有集群上启用 Knowledge Catalog 集成，请按照以下过程之一操作：

gcloud

如需在现有集群上启用 Knowledge Catalog 集成，请使用带有 --enable-dataplex-integration 标志的 gcloud alloydb clusters update 命令。

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

进行以下替换：

CLUSTER_ID：集群的名称。
REGION：集群区域的 ID。

REST

如需更新现有集群的特定字段，请对 projects.locations.clusters resource 使用 PATCH 方法。

使用以下 HTTP 方法和网址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

进行以下替换：

PROJECT_ID：包含集群的 Google Cloud 项目的 ID 或项目编号。
LOCATION_ID：集群区域的 ID。
CLUSTER_ID：集群的名称。

请求 JSON 正文：

{
  "dataplexConfig": {
    "enabled": true
  }
}

如需发送您的请求，请使用以下方式之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

您会收到类似以下内容的 JSON 响应：

响应

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

验证 AlloyDB 集群上的知识目录集成

如需验证现有集群上是否已启用 Knowledge Catalog 集成，请按照以下过程之一操作：

gcloud

如需验证现有集群上是否已启用 Knowledge Catalog 集成，请使用 gcloud alloydb clusters describe 命令。

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

进行以下替换：

CLUSTER_ID：集群 ID。
REGION：集群区域的 ID。

输出包含 YAML 格式的 dataplexConfig 部分。如果 enabled 为 true，则启用知识目录集成：

dataplexConfig:
  enabled: true

REST

如需验证现有集群上是否已启用 Knowledge Catalog 集成，请使用 GET 方法。

使用以下 HTTP 方法和网址：

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID

进行以下替换：

PROJECT_ID：包含集群的 Google Cloud 项目的 ID 或项目编号。
LOCATION_ID：集群区域的 ID。
CLUSTER_ID：集群 ID。

如需发送您的请求，请使用以下方式之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

您会收到整个 Cluster proto 的 JSON 响应，其中包含 dataplexConfig 消息：

{
  "dataplexConfig": {
    "enabled": true
  }
}

在 AlloyDB 集群上停用 Knowledge Catalog 集成

在 AlloyDB 集群上停用 Knowledge Catalog 集成后，只有集群和实例元数据可用。

gcloud

使用带有 --no-enable-dataplex-integration 标志的 gcloud alloydb clusters update 命令停用集成。

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

进行以下替换：

CLUSTER_ID：集群的 ID。
REGION：集群区域的 ID。

REST

使用以下示例停用集成。

使用以下 HTTP 方法和网址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

进行以下替换：

PROJECT_ID：包含集群的 Google Cloud 项目的 ID 或项目编号。
LOCATION_ID：集群区域的 ID。
CLUSTER_ID：集群 ID。

请求 JSON 正文：

{
  "dataplexConfig": {
    "enabled": false
  }
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

您会收到类似以下内容的 JSON 响应：

响应

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

通过切面丰富 AlloyDB 资产

切面类型是可重复使用的资源，可用作切面的模板。切面类型有助于避免重复性工作和创建不完整的切面。使用知识目录创建必要的切面类型。

创建自定义切面类型后，您可以将切面关联到 AlloyDB 资产。通过将切面关联到 AlloyDB 资产，您可以执行以下操作：

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

如需详细了解如何创建切面类型并将切面附加到 AlloyDB，请参阅管理切面并丰富元数据。

搜索 AlloyDB 资产

使用 Google Cloud 控制台中的知识目录搜索页面可搜索 AlloyDB 资产。

前往知识目录搜索页面。

转到搜索
在选择搜索平台中，选择 Knowledge Catalog。
在过滤条件面板中，点击系统，然后选择 AlloyDB。
可选。在类型别名中，您可以通过选择以下一种或多种类型别名，将搜索结果过滤为特定类型的 AlloyDB 资产：
- 数据库
- 数据库架构
- 集群
- 实例
- 服务
- 表格
- 查看
注意：Service 是 AlloyDB 实例的类型别名。

使用查询执行关键字搜索

您可以使用知识目录中的搜索字段执行关键字搜索查询。例如，输入 system=AlloyDB AND type=Database 可查看所有 AlloyDB 数据库。

如需了解详情，请参阅知识目录的搜索语法。

如需查看所有 AlloyDB 资产，请输入 system=AlloyDB。

然后，输入具体关键字。例如，如需查看所有 AlloyDB 数据库，请输入以下查询：

system=AlloyDB AND type=Database

如需查看所有 AlloyDB 表，请输入以下查询：

system=AlloyDB AND type=Table

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

您可以直接在搜索字段中输入用于特定 AlloyDB 资产的搜索查询。查询字符串的格式如下：

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

替换以下内容：

QUERY_STRING：请使用以下列表根据您要查询的 AlloyDB 资产类型来确定查询字符串：
- alloydb-database
- alloydb-cluster
- alloydb-instance
- alloydb-table
- alloydb-schema
- alloydb-view

示例查询可能如下所示：

type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

按切面类型搜索

知识目录包含一些内置的切面类型，可帮助您执行搜索。

如需按方面类型进行搜索，请按以下步骤操作：

在切面面板中，点击添加更多切面类型菜单。
可选。选择 AlloyDB 访问权限以按 AlloyDB 方言过滤结果。
选择一个或多个以下切面类型，以将搜索结果限制为该类型。
- AlloyDB 数据库
- AlloyDB 集群
- AlloyDB 实例
- AlloyDB 视图
- AlloyDB 架构
- AlloyDB 表
点击确定。
在结果表中，点击资产的名称以查看该资产的元数据。
可选：优化或查看资产。您可以通过以下方式优化或查看资产：
- 如需添加资产的富文本说明，请在概览中点击添加。
- 如需将某个切面附加到资产，请在切面中点击添加。
- 如需查看实例的成员数据库，请点击条目列表标签页，然后点击在搜索结果中显示所有子条目。如果条目列表标签页未显示，则表示该集群没有数据库。
- 在条目详情中，查看资产的完整详情。点击条目名称可展开细目至其他条目。

AlloyDB 中的自然语言搜索

自然语言搜索（预览版）使用 AI 来理解语义查询。借助它，您可以使用日常语言查找资源，无需使用复杂的语法。例如，输入 List all AlloyDB tables related to sales 等查询内容。

如需了解详情，请参阅知识目录的搜索语法。

AlloyDB 中的语法搜索

借助关键字搜索，您可以使用特定关键字、过滤条件和定义的语法来查找资源。例如，输入 system=AlloyDB AND type=Database 可查看所有 AlloyDB 数据库。

如需了解详情，请参阅知识目录的搜索语法。

示例工作流 - 从集群展开细目至列

如需从集群下钻到列，请按以下步骤操作：

前往知识目录搜索页面。

转到搜索
对于选择搜索平台选项，选择 Knowledge Catalog。
在过滤条件面板中，选择系统，然后选择 AlloyDB。或者，在搜索字段中输入 system=AlloyDB。
选择集群名称。
在 AlloyDB 详情页面上，点击条目列表标签页，然后点击在搜索结果中显示所有子条目。知识目录会显示集群中的数据库。

注意：如果条目列表标签页未显示，请返回搜索页面，然后选择其他集群。
在 AlloyDB 数据库详情页面上，点击条目列表标签页，然后点击查看搜索结果中的子条目。知识目录会显示集群中的表。
选择表名称，然后在 AlloyDB 表详情页面上，点击架构以查看表列。
可选：如需向列添加某个切面类型，请点击添加切面按钮。

价格

在知识目录中存储 AlloyDB 技术元数据无需付费。对于 API 调用和额外的业务元数据丰富化，适用标准 Knowledge Catalog 价格。如需了解详情，请参阅 Knowledge Catalog 价格页面。

资源使用情况

Knowledge Catalog 会定期从您的 AlloyDB 集群中提取元数据。此提取过程会消耗集群上的 CPU 资源。CPU 使用率通常极低。例如，管理大型架构（例如包含 10 万个或更多表的架构）的较小机器类型（例如 n2-highmem-2-icelake）的集群在提取过程中可能会出现 CPU 使用率增加（最多增加 5%）的情况。

限制

该集成支持每个数据库最多 100 万个表，每个表的平均列数为 150。如果超出上述任一限制，系统就不会提取数据库、架构、表和视图等资源的元数据。知识目录中仅提供集群和实例元数据。
首次创建集群时，将所有元数据初始同步到知识目录最多可能需要 48 小时。完成初始同步后，后续更新会近乎实时地提供。
如果数据库中的元数据更改率较高（每秒超过 100 次 DDL 更改），与知识目录的近乎实时元数据同步可能会暂停长达 30 分钟，然后才会恢复。
如果因元数据更改频率过高、网络问题或同步过程中断而错过了任何更新，这些更新最终会在 48 小时内显示在知识目录中。
如果实例不存在或未运行，则可能需要 7 天才能删除元数据。
重命名数据库后，知识目录中仅会近乎实时地显示数据库更新。数据库和所有相应表的基础映射将在 48 小时内更新到知识目录中。

使用 Knowledge Catalog 管理 AlloyDB 资源 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

元数据发现类型

关键字搜索和自然语言搜索

示例：发现 AlloyDB 数据库架构

使用切面丰富元数据

元数据发现工作流

准备工作

所需 IAM 角色

访问搜索结果所需的角色

搜索条目所需的角色

知识目录集成数据新鲜度

创建已停用 Knowledge Catalog 集成的 AlloyDB

gcloud

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

响应

为 AlloyDB 集群启用知识目录集成

gcloud

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

响应

验证 AlloyDB 集群上的知识目录集成

gcloud

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

在 AlloyDB 集群上停用 Knowledge Catalog 集成

gcloud

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

响应

通过切面丰富 AlloyDB 资产

搜索 AlloyDB 资产

使用查询执行关键字搜索

按切面类型搜索

AlloyDB 中的自然语言搜索

AlloyDB 中的语法搜索

示例工作流 - 从集群展开细目至列

价格

资源使用情况

限制

后续步骤

使用 Knowledge Catalog 管理 AlloyDB 资源