Cambios en los metadatos almacenados en Dataplex Universal Catalog

Entre el 12 de enero de 2026 y el 2 de febrero de 2026, cambiará parte de los metadatos almacenados en Dataplex Universal Catalog.

Este cambio hace que los metadatos almacenados en Dataplex Universal Catalog sean coherentes con los metadatos de los sistemas fuente originales.

Si tus cargas de trabajo se encuentran dentro del alcance de los cambios que se describen en la siguiente sección, sigue las instrucciones de este documento.

Alcance de los cambios

Los cambios que se describen en esta sección se aplican a las entradas de los siguientes sistemas fuente:

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

Los siguientes métodos de la API de Dataplex se ven afectados por estos cambios:

Nombres de recursos

El nombre del recurso cambia para el campo de entrada de nivel superior entrySource.resource. El campo se modifica para contener un nombre de recurso relativo en lugar del nombre de recurso completo con la API. Se quita el prefijo //<service_name>.googleapis.com/ del nombre del recurso. En la siguiente tabla, se enumeran algunos ejemplos.

Sistema de origen Valor antes del cambio Valor después del cambio
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Ejemplo: //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Ejemplo: projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Ejemplo: //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Ejemplo: projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Ejemplo: //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Ejemplo: projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
Ejemplo: //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
Ejemplo: projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Ejemplo: //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Ejemplo: projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Ejemplo: //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Ejemplo: projects/test-project-id/locations/us-central1/services/test-service

Para obtener más información sobre este campo, consulta la referencia de la API de EntrySource.

Valores de tipos de elementos superiores

El campo de entrada de nivel superior entrySource.ancestors.type cambia para contener el ID del proyecto de tipo Dataplex (dataplex-types) en lugar del número del proyecto de tipo Dataplex (655216118709). En la siguiente tabla, se incluyen algunos ejemplos.

Sistema de origen Valor antes del cambio Valor después del cambio
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
Ejemplo: 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
Ejemplo: dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
Ejemplo: 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
Ejemplo: dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
Ejemplo: 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
Ejemplo: dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
Ejemplo: 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
Ejemplo: dataplex-types.global.cloud-bigtable-instance

Para obtener más información sobre este campo, consulta la referencia de la API de Ancestor.

Qué debe hacer

El período de lanzamiento comienza el 12 de enero de 2026 y finaliza el 2 de febrero de 2026. Los cambios en los metadatos se aplican de forma gradual durante el período de lanzamiento.

Sigue estos pasos:

  • Antes del 12 de enero de 2026, actualiza tus cargas de trabajo para que interpreten tanto la versión heredada de los metadatos como la versión actualizada.

  • Durante el período de lanzamiento, es posible que las entradas capturen la versión heredada de los metadatos o la versión actualizada. Tus cargas de trabajo deben poder interpretar ambas versiones.

  • Después del 2 de febrero de 2026, puedes actualizar tus cargas de trabajo para que interpreten solo la nueva versión de los metadatos.

Cómo determinar la versión de los metadatos

Para determinar si una entrada usa los metadatos actualizados, busca el objeto aspects de la entrada y localiza el tipo de aspecto pertinente. En el objeto aspectSource del tipo de aspecto, si el campo dataVersion está presente y configurado como Ingestion/1.0.0, la entrada usa la versión actualizada de los metadatos. Para obtener más información, consulta las APIs de lookupEntry y getAspectType.

Asistencia

Si tienes preguntas, comunícate con dataplex-msa-support@google.com.

Información adicional