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 タイプ プロジェクト番号（655216118709）ではなく、Dataplex タイプ プロジェクト ID（dataplex-types）を含むように変更されます。次の表に、いくつかのサンプル例を示します。

ソースシステム 変更前の値 変更後の値
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 API と getAspectType API をご覧ください。

サポート

不明な点がございましたら、dataplex-msa-support@google.com までお問い合わせください。

その他の情報