變更儲存在 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。

其他資訊