Cambios en los metadatos de BigQuery almacenados en Dataplex Catalog

Entre el 15 de octubre de 2024 y el 31 de enero de 2025, cambiarán algunos de los metadatos de BigQuery que se almacenan en Dataplex Catalog.

Este cambio hace que los metadatos almacenados en el catálogo de Dataplex sean coherentes con los metadatos de BigQuery y los metadatos de otras fuentes de Google Cloud .

Si tienes cargas de trabajo que dependen de los metadatos de BigQuery, debes ajustarlas para preservar la continuidad.

Para obtener más información sobre los metadatos de Dataplex Catalog, consulta Descripción general de Dataplex Catalog.

Alcance de los cambios

Los cambios que se describen en esta sección se aplican a todas las entradas de BigQuery. Las entradas de BigQuery son entradas que pertenecen a un tipo de entrada en el sistema de BigQuery.

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

• lookupEntry
• entryGroups.entries.get

Los cambios en los valores de los tipos de datos y los subtipos de tablas también se reflejan en la consola de Google Cloud , en la página Detalles de la entrada.

Valores de tipo de datos

Los valores del tipo de datos cambian para el tipo de aspecto SchemaAspect. Se ve afectado el campo dataType.

Valor anterior al cambio	Valor después del cambio
INT64	INTEGER
FLOAT64	FLOAT
STRUCT	RECORD
BOOL	BOOLEAN

Nombres de recursos

El nombre del recurso cambiará para el campo de entrada de nivel superior entrySource.resource. El campo se modifica para contener el ID del recurso en lugar del nombre completo del recurso.

Valor anterior al cambio	Valor después del cambio
//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET/tables/TABLE	projects/PROJECT_ID/datasets/DATASET/tables/TABLE

Valores de tipo de ancestro

El valor del tipo de ancestro cambia para el campo de entrada de nivel superior entrySource.ancestors.type.

Valor anterior al cambio	Valor después del cambio
655216118709.global.Dataset	dataplex-types.global.bigquery-dataset

Qué debe hacer

El período de lanzamiento comienza el 15 de octubre de 2024 y finaliza el 31 de enero de 2025. Los cambios en los metadatos de BigQuery se aplicarán gradualmente durante el período de lanzamiento.

Sigue estos pasos:

• Antes del 15 de octubre de 2024: Actualiza tus cargas de trabajo para interpretar la versión heredada de los metadatos y la versión actualizada de los metadatos.

• Durante el período de lanzamiento: Es posible que las entradas de BigQuery capturen la versión heredada de los metadatos o la versión actualizada de los metadatos. Tus cargas de trabajo deberían poder interpretar ambas versiones.

  Para determinar si una entrada de BigQuery usa los metadatos actualizados, en el objeto aspects de la entrada, busca el tipo de aspecto relevante. En el objeto aspectSource del tipo de aspecto, el campo data_version indica la versión de los metadatos. Por ejemplo, para una entrada bigquery-table, consulta el campo Entry.aspects.dataplex-types.global.bigquery-table.aspectSource.data_version.

  Usa la versión heredada de metadatos	Usa la versión actualizada de los metadatos
  "" (string vacía)	"Ingestion/1.0.0"

• Después del 31 de enero de 2025: De manera opcional, actualiza tus cargas de trabajo para interpretar solo la nueva versión de metadatos.

Asistencia

Si tienes preguntas, comunícate con [e-mail].