Questo documento spiega come utilizzare l'utilità di esportazione del glossario aziendale per estrarre glossari, categorie e termini da Knowledge Catalog (in precedenza Dataplex Universal Catalog) in un Foglio Google per la gestione e la generazione di report in blocco.
L'utilità glossary_export recupera i metadati dal glossario aziendale di Knowledge Catalog e compila un Foglio Google con uno schema strutturato, incluse descrizioni, responsabili dei dati ed etichette.
Prima di iniziare
Prima di esportare i glossari, completa i seguenti prerequisiti.
Configurare il account di servizio
Per eseguire l'utilità di esportazione, devi configurare un account di servizio con le autorizzazioni necessarie per accedere all'API Google Sheets e simulare le credenziali utente:
Identifica o crea un account di servizio.
Seleziona un account di servizio esistente o creane uno nuovo nel progetto in cui esegui l'utilità di importazione. Per ulteriori informazioni, consulta Creare service account. Prendi nota dell'indirizzo email del account di servizio (ad esempio,
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com).Configura la simulazione dell'identità del account di servizio.
Per eseguire lo script dell'utilità di esportazione in locale, il tuo account utente deve disporre dell'autorizzazione per simulare l'identità del account di servizio. Concedi al tuo account utente il ruolo Creatore token account di servizio (
roles/iam.serviceAccountTokenCreator) nel service account.Per ulteriori informazioni, consulta Gestire l'accesso ai service account.
Concedi al account di servizio l'accesso
Editoral Foglio Google.Apri il Foglio Google che vuoi utilizzare per la procedura di importazione, fai clic su Condividi, e aggiungi l'indirizzo email del account di servizio come
Editor. Questa autorizzazione consente al account di servizio di leggere o scrivere dati nel foglio.
Ruoli obbligatori
Per assicurarti che il account di servizio disponga delle autorizzazioni necessarie per esportare i glossari in un Foglio Google, chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio:
- Dataplex Administrator (
roles/dataplex.admin) sul progetto - Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) sul progetto - Dataplex Catalog Editor (
roles/dataplex.catalogEditor) sul progetto
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
L'amministratore potrebbe anche assegnare al account di servizio le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.
Abilitare le API
Per esportare i glossari, abilita le seguenti API nel tuo progetto:
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai
creato il progetto, probabilmente hai già questa autorizzazione tramite il
ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il
ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin).
Scopri come concedere i ruoli.
Configurare il repository Git
Clona il repository dataplex-labs:
git clone https://github.com/GoogleCloudPlatform/dataplex-labs.git cd dataplex-labs/dataplex-quickstart-labs/00-resources/scripts/python/business-glossary-import/dataplex-glossary/export
Installare le dipendenze
Installa le dipendenze Python richieste:
pip3