Cambios en los metadatos almacenados en Dataplex Universal Catalog

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

Con este cambio, los metadatos almacenados en Dataplex Universal Catalog se ajustan a los metadatos de los sistemas de origen originales.

Si tus cargas de trabajo se incluyen en el ámbito de los cambios descritos en la siguiente sección, sigue las instrucciones de este documento.

Ámbito de los cambios

Los cambios descritos en esta sección se aplican a las entradas de los siguientes sistemas de origen:

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

Estos cambios afectan a los siguientes métodos de la API Dataplex:

Nombres de recursos

El nombre del recurso cambia en el campo de entrada de nivel superior entrySource.resource. El campo se modifica para que contenga un nombre de recurso relativo en lugar del nombre de recurso completo con la API. El prefijo //<service_name>.googleapis.com/ se quita del nombre del recurso. En la siguiente tabla se muestran 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 EntrySource.

Valores de tipo de ancestro

El campo de entrada de nivel superior entrySource.ancestors.type cambia para incluir el ID de proyecto de tipo Dataplex (dataplex-types) en lugar del número de proyecto de tipo Dataplex (655216118709). En la siguiente tabla se muestran 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 Ancestor.

Qué debes hacer

El periodo de lanzamiento empieza el 12 de enero del 2026 y termina el 2 de febrero del 2026. Los cambios en los metadatos se aplican gradualmente durante el periodo de lanzamiento.

Esto es lo que tienes que hacer:

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

  • Durante el periodo de lanzamiento, las entradas pueden registrar la versión antigua o la actualizada de los metadatos. Tus cargas de trabajo deben poder interpretar ambas versiones.

  • Después del 2 de febrero del 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 tiene el valor Ingestion/1.0.0, la entrada utiliza la versión actualizada de los metadatos. Para obtener más información, consulta las APIs lookupEntry y getAspectType.

Asistencia

Si tienes alguna pregunta, ponte en contacto con dataplex-msa-support@google.com.

Información adicional