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

Knowledge Catalog (in precedenza Dataplex Universal Catalog) consente di importare ed esportare in blocco i glossari aziendali e i link alle voci per gestire il vocabolario aziendale su larga scala. Man mano che il tuo catalogo cresce, le operazioni in blocco ti aiutano ad aggiornare i termini e le loro relazioni senza gestirli singolarmente nella Google Cloud console.

Terminologia

Il glossario aziendale di Knowledge Catalog consente di definire un vocabolario aziendale comune e di associare questi termini agli asset di dati fisici. Prima di utilizzare le utilità di importazione ed esportazione, familiarizza 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, ad esempio tra i termini del glossario e gli asset di dati. 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 in blocco 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 definite nei file di metadati in formato JSON.

Esempio di caso d'uso: 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 saperne di più, 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.

Esempio di caso d'uso: 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 andata e ritorno con Fogli Google

Un flusso di lavoro amministrativo comune è l'esecuzione della modifica round trip. Ciò comporta l'esportazione della configurazione del catalogo esistente, l'apporto di modifiche in blocco 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 (ad esempio 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. Prepara 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, tutti i nuovi termini o categorie vengono creati correttamente nel glossario aziendale.

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

Passaggi successivi