Modifiche ai metadati di BigQuery archiviati in Dataplex Catalog

Tra il 15 ottobre 2024 e il 31 gennaio 2025, alcuni dei metadati di BigQuery memorizzati in Dataplex Catalog cambieranno.

Questa modifica rende coerenti i metadati archiviati in Dataplex Catalog con i metadati di BigQuery e di altre origini Google Cloud.

Se hai carichi di lavoro che dipendono dai metadati di BigQuery, devi modificarli per preservare la continuità.

Per saperne di più sui metadati di Dataplex Catalog, consulta Panoramica di Dataplex Catalog.

Ambito delle modifiche

Le modifiche descritte in questa sezione si applicano a tutte le voci BigQuery. Le voci BigQuery appartengono a un tipo di voce del sistema BigQuery.

I seguenti metodi API sono interessati da queste modifiche:

• lookupEntry
• entryGroups.entries.get

Le modifiche ai valori dei tipi di dati e ai valori dei sottotipi di tabelle si riflettono anche nella console Google Cloud, nella pagina Dettagli voce.

Valori dei tipi di dati

I valori del tipo di dati stanno cambiando per il tipo di aspetto SchemaAspect. Il campo dataType è interessato.

Valore prima della modifica	Valore dopo la modifica
INT64	INTEGER
FLOAT64	FLOAT
STRUCT	RECORD
BOOL	BOOLEAN

Nomi delle risorse

Il nome della risorsa sta cambiando per il campo di immissione di primo livello entrySource.resource. Il campo viene modificato in modo da contenere l'ID risorsa anziché il nome completo della risorsa.

Valore prima della modifica	Valore dopo la modifica
//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET/tables/TABLE	projects/PROJECT_ID/datasets/DATASET/tables/TABLE

Valori del tipo di antenato

Il valore del tipo di antenato sta cambiando per il campo di voce di primo livello entrySource.ancestors.type.

Valore prima della modifica	Valore dopo la modifica
655216118709.global.Dataset	dataplex-types.global.bigquery-dataset

Che cosa devi fare

Il periodo di implementazione inizia il 15 ottobre 2024 e termina il 31 gennaio 2025. Le modifiche ai metadati di BigQuery verranno applicate gradualmente durante il periodo di implementazione.

Ecco cosa devi fare:

• Prima del 15 ottobre 2024: aggiorna i tuoi carichi di lavoro in modo da interpretare sia la versione precedente sia quella aggiornata dei metadati.

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

  Per determinare se una voce BigQuery utilizza i metadati aggiornati, nell'oggetto aspects della voce individua il tipo di aspetto pertinente. Nell'oggetto aspectSource del tipo di aspetto, il campo data_version indica la versione dei metadati. Ad esempio, per una voce bigquery-table, fai riferimento al campo Entry.aspects.dataplex-types.global.bigquery-table.aspectSource.data_version.

  Utilizza la versione legacy dei metadati	Utilizza la versione aggiornata dei metadati
  "" (stringa vuota)	"Ingestion/1.0.0"

• Dopo il 31 gennaio 2025: facoltativamente, aggiorna i tuoi carichi di lavoro in modo da interpretare solo la nuova versione dei metadati.

Assistenza

Per eventuali domande, contatta [e-mail].