Informazioni sull'importazione e l'esportazione di glossari e link alle voci

Questo documento fornisce una panoramica su come importare ed esportare glossari aziendali e link alle voci in Knowledge Catalog (in precedenza Dataplex Universal Catalog).

Il glossario aziendale di Knowledge Catalog consente di definire un vocabolario aziendale comune e di associare questi termini agli asset di dati fisici. Man mano che il tuo catalogo cresce, la gestione di questi termini e delle loro relazioni singolarmente nella Google Cloud console può diventare difficile.

Per gestire il glossario aziendale su larga scala, puoi importare ed esportare in blocco glossari (categorie e termini) e link alle voci (le associazioni tra termini e asset di dati).

Terminologia

Prima di utilizzare le utilità di importazione ed esportazione, acquisisci familiarità con i seguenti componenti chiave:

  • Risorse del glossario: sono costituite da categorie e termini che stabiliscono il vocabolario aziendale.

  • Link alle voci: le relazioni o le associazioni tra le risorse. Knowledge Catalog supporta tre tipi di link alle voci:

    • definition: associa un termine del glossario a un asset di dati specifico (ad esempio, una colonna BigQuery)
    • related: stabilisce una relazione tra due termini del glossario correlati
    • synonym: stabilisce una relazione tra due termini del glossario sinonimi

Metodi per importare ed esportare glossari e link alle voci

Knowledge Catalog supporta due metodi principali per la gestione collettiva dei glossari. Scegli il metodo più adatto alle tue esigenze di automazione e all'interfaccia che preferisci:

  • Importazione di metadati basata su JSON
  • Utilità basate su Fogli Google per l'importazione e l'esportazione

Importazione di metadati basata su JSON

Si tratta del meccanismo integrato e completamente gestito di Knowledge Catalog. Utilizza l'API Dataplex per importare i termini del glossario e le relative associazioni definiti nei file di metadati in formato JSON.

Caso d'uso di esempio: aggiorna automaticamente i metadati di Knowledge Catalog nell'ambito di una pipeline di dati pianificata giornalmente, ad esempio sincronizza i termini direttamente da un database aziendale esterno.

Per ulteriori informazioni, consulta Importare glossari e link alle voci utilizzando file JSON.

Utilità basate su Fogli Google per l'importazione e l'esportazione

Si tratta di un approccio open source basato su script fornito nel repository dataplex-labs. Utilizza uno script Python per sincronizzare i metadati del glossario tra un foglio Google e Knowledge Catalog.

Caso d'uso di esempio: un team di governance dei dati vuole redigere e rivedere in collaborazione decine di nuovi termini aziendali con stakeholder aziendali non tecnici. Il team utilizza questo metodo basato su fogli di lavoro in modo che tutti possano modificare, commentare e approvare i termini in Fogli Google prima che un amministratore esegua lo script per caricarli in blocco in Knowledge Catalog.

Per ulteriori informazioni, consulta i seguenti documenti:

Caso d'uso comune: modifica di andata e ritorno con Fogli Google

Un flusso di lavoro amministrativo comune è quello di eseguire la modifica di andata e ritorno. Ciò comporta l'esportazione della configurazione del catalogo esistente, l'apporto di modifiche collettive e l'applicazione di queste modifiche a Knowledge Catalog.

Il seguente flusso di lavoro illustra come eseguire questa procedura:

  1. Esporta i metadati esistenti da Knowledge Catalog a Fogli Google.

    Utilizza le utilità di esportazione del glossario e esportazione dei link alle voci per estrarre la struttura del glossario e i link alle voci esistenti in un foglio Google.

  2. Modifica i metadati in Fogli Google.

    Apporta le modifiche necessarie nel foglio Google. Poiché i link simmetrici (come i link alle voci synonym e related) vengono semplificati in una singola direzione durante l'esportazione per evitare righe duplicate, devi gestirli una sola volta.

    Puoi aggiungere nuove righe al rispettivo foglio seguendo lo schema di colonna richiesto. Puoi anche modificare i dettagli, ad esempio le descrizioni o i nomi visualizzati, direttamente nelle righe.

  3. Organizza e importa le modifiche da Fogli Google a Knowledge Catalog.

    Esegui prima l'utilità di importazione del glossario. In questo modo, prima di tentare di collegarli, i nuovi termini o le nuove categorie vengono creati correttamente nel glossario aziendale.

    Esegui l'utilità di importazione dei link alle voci. Questa utilità legge le associazioni aggiornate, le organizza nel bucket Cloud Storage e applica i link definition, related e synonym al glossario appena aggiornato.

Passaggi successivi