对存储在 Dataplex Universal Catalog 中的元数据所做的更改

在 2026 年 1 月 12 日至 2026 年 2 月 2 日期间，Dataplex Universal Catalog 中存储的部分元数据将会发生变化。

此更改可使 Dataplex Universal Catalog 中存储的元数据与原始源系统中的元数据保持一致。

如果您的工作负载属于下一部分中所述的更改范围，请按照本文档中的说明操作。

变更范围

本部分中所述的变更适用于以下来源系统中的条目：

  • Vertex AI
  • Bigtable
  • Spanner
  • Pub/Sub
  • Dataform
  • Dataproc Metastore

以下 Dataplex API 方法会受到这些更改的影响：

资源名称

顶级条目字段 entrySource.resource 的资源名称发生更改。 该字段已修改为包含相对资源名称，而不是包含 API 的完整资源名称。从资源名称中移除 //<service_name>.googleapis.com/ 前缀。下表列出了一些示例。

源系统 更改之前的值 更改后的价值
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
示例：//aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
示例：projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
示例：//bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
示例：projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
示例：//spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
示例：projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
示例：//pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
示例：projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
示例：//dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
示例：projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
示例：//metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
示例：projects/test-project-id/locations/us-central1/services/test-service

如需详细了解此字段，请参阅 EntrySource API 参考文档。

祖先类型值

顶级条目字段 entrySource.ancestors.type 发生更改，包含 Dataplex 类型项目 ID (dataplex-types) 而不是 Dataplex 类型项目编号 (655216118709)。下表列出了一些示例。

源系统 更改之前的值 更改后的价值
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
示例：655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
示例：dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
示例：655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
示例：dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
示例：655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
示例：dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
示例：655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
示例：dataplex-types.global.cloud-bigtable-instance

如需详细了解此字段，请参阅 Ancestor API 参考文档。

您需要做什么

推出期从 2026 年 1 月 12 日开始，到 2026 年 2 月 2 日结束。 元数据的更改会在整个发布期间逐步应用。

以下是您需要执行的操作：

  • 在 2026 年 1 月 12 日之前，请更新您的工作负载，使其能够解读旧版元数据和更新版元数据。

  • 在推出期间，条目可能会捕获旧版元数据或更新版元数据。工作负载必须能够解读这两个版本。

  • 2026 年 2 月 2 日之后，您可以选择更新工作负载，使其仅解读新版本的元数据。

如何确定元数据版本

如需确定条目是否使用更新后的元数据，请查找条目的 aspects 对象，然后找到相关切面类型。在方面类型的 aspectSource 对象中，如果 dataVersion 字段存在且设置为 Ingestion/1.0.0，则相应条目使用更新后的元数据版本。如需了解详情，请参阅 lookupEntry 和 getAspectType API。

支持

如有疑问，请发送电子邮件至 dataplex-msa-support@google.com。

其他信息