Modifiche ai metadati archiviati in Dataplex Universal Catalog

Tra il 12 gennaio 2026 e il 2 febbraio 2026, alcuni metadati memorizzati in Dataplex Universal Catalog cambieranno.

Questa modifica rende coerenti i metadati archiviati in Dataplex Universal Catalog con i metadati dei sistemi di origine originali.

Se i tuoi workload rientrano nell'ambito delle modifiche descritte nella sezione successiva, segui le istruzioni riportate in questo documento.

Ambito delle modifiche

Le modifiche descritte in questa sezione si applicano alle voci dei seguenti sistemi di origine:

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

I seguenti metodi dell'API Dataplex sono interessati da queste modifiche:

Nomi delle risorse

Il nome della risorsa cambia per il campo di inserimento di primo livello entrySource.resource. Il campo viene modificato in modo da contenere un nome risorsa relativo anziché il nome risorsa completo con l'API. Il prefisso //<service_name>.googleapis.com/ viene rimosso dal nome della risorsa. La tabella seguente elenca alcuni esempi di campioni.

Sistema di origine Valore prima della modifica Valore dopo la modifica
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Esempio: //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Esempio: projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Esempio: //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Esempio: projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Esempio: //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Esempio: projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
Esempio: //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
Esempio: projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Esempio: //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Esempio: projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Esempio: //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Esempio: projects/test-project-id/locations/us-central1/services/test-service

Per ulteriori informazioni su questo campo, consulta il EntrySource riferimento API.

Valori del tipo di antenato

Il campo di inserimento di primo livello entrySource.ancestors.type cambia per contenere l'ID progetto di tipo Dataplex (dataplex-types) anziché il numero di progetto di tipo Dataplex (655216118709). La seguente tabella elenca alcuni esempi.

Sistema di origine Valore prima della modifica Valore dopo la modifica
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
Esempio: 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
Esempio: dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
Esempio: 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
Esempio: dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
Esempio: 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
Esempio: dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
Esempio: 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
Esempio: dataplex-types.global.cloud-bigtable-instance

Per ulteriori informazioni su questo campo, consulta il Ancestor riferimento API.

Che cosa devi fare

Il periodo di implementazione inizia il 12 gennaio 2026 e termina il 2 febbraio 2026. Le modifiche ai metadati vengono applicate gradualmente durante il periodo di implementazione.

Ecco cosa devi fare:

  • Prima del 12 gennaio 2026, aggiorna i tuoi carichi di lavoro in modo che interpretino sia la versione precedente dei metadati sia quella aggiornata.

  • Durante il periodo di implementazione, le voci potrebbero acquisire la versione precedente dei metadati o la versione aggiornata. I carichi di lavoro devono essere in grado di interpretare entrambe le versioni.

  • Dopo il 2 febbraio 2026, aggiorna facoltativamente i tuoi workload per interpretare solo la nuova versione dei metadati.

Come determinare la versione dei metadati

Per determinare se una voce utilizza i metadati aggiornati, cerca l'oggetto aspects della voce e individua il tipo di aspetto pertinente. Nell'oggetto aspectSource del tipo di aspetto, se il campo dataVersion è presente e impostato su Ingestion/1.0.0, la voce utilizza la versione aggiornata dei metadati. Per ulteriori informazioni, consulta le API lookupEntry e getAspectType.

Assistenza

Per domande, contatta dataplex-msa-support@google.com.

Informazioni aggiuntive