Modifications apportées aux métadonnées stockées dans Dataplex Universal Catalog

Entre le 12 janvier 2026 et le 2 février 2026, certaines métadonnées stockées dans Dataplex Universal Catalog seront modifiées.

Cette modification permet d'assurer la cohérence entre les métadonnées stockées dans Dataplex Universal Catalog et celles des systèmes sources d'origine.

Si vos charges de travail entrent dans le champ d'application des modifications décrites dans la section suivante, suivez les instructions de ce document.

Étendue des modifications

Les modifications décrites dans cette section s'appliquent aux entrées des systèmes sources suivants :

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

Les méthodes d'API Dataplex suivantes sont concernées par ces modifications :

Noms de ressources

Le nom de ressource change pour le champ d'entrée de niveau supérieur entrySource.resource. Le champ est modifié pour contenir un nom de ressource relatif au lieu du nom de ressource complet avec l'API. Le préfixe //<service_name>.googleapis.com/ est supprimé du nom de la ressource. Le tableau suivant présente quelques exemples.

Système source Valeur avant la modification Valeur après la modification
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Exemple : //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Exemple : projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Exemple : //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Exemple : projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Exemple : //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Exemple : projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
Exemple : //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
Exemple : projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Exemple : //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Exemple : projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Exemple : //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Exemple : projects/test-project-id/locations/us-central1/services/test-service

Pour en savoir plus sur ce champ, consultez la documentation de référence de l'API EntrySource.

Valeurs du type d'ancêtre

Le champ d'entrée de premier niveau entrySource.ancestors.type est modifié pour contenir l'ID de projet de type Dataplex (dataplex-types) au lieu du numéro de projet de type Dataplex (655216118709). Le tableau suivant présente quelques exemples.

Système source Valeur avant la modification Valeur après la modification
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
Exemple : 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
Exemple : dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
Exemple : 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
Exemple : dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
Exemple : 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
Exemple : dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
Exemple : 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
Exemple : dataplex-types.global.cloud-bigtable-instance

Pour en savoir plus sur ce champ, consultez la documentation de référence de l'API Ancestor.

Que devez-vous faire ?

La période de déploiement commence le 12 janvier 2026 et se termine le 2 février 2026. Les modifications apportées aux métadonnées s'appliqueront progressivement au cours de la période de déploiement.

Voici ce que vous devez faire :

  • Avant le 12 janvier 2026, mettez à jour vos charges de travail pour qu'elles interprètent à la fois l'ancienne version et la version mise à jour des métadonnées.

  • Pendant la période de déploiement, les entrées peuvent capturer l'ancienne version des métadonnées ou la version mise à jour. Vos charges de travail doivent pouvoir interpréter les deux versions.

  • Après le 2 février 2026, vous pourrez éventuellement mettre à jour vos charges de travail pour qu'elles n'interprètent que la nouvelle version des métadonnées.

Déterminer la version des métadonnées

Pour déterminer si une entrée utilise les métadonnées mises à jour, recherchez l'objet aspects de l'entrée et localisez le type d'aspect concerné. Dans l'objet aspectSource du type d'aspect, si le champ dataVersion est présent et défini sur Ingestion/1.0.0, l'entrée utilise la version mise à jour des métadonnées. Pour en savoir plus, consultez les API lookupEntry et getAspectType.

Assistance

Pour toute question, contactez dataplex-msa-support@google.com.

Informations supplémentaires