Il glossario aziendale di Dataplex Universal Catalog fornisce un unico punto per gestire la terminologia e le definizioni correlate all'attività in tutta l'azienda.
Quando team diversi lavorano a un progetto condiviso o una grande azienda ha molti reparti, è normale che ogni parte dell'impresa crei una propria terminologia per descrivere le varie risorse di dati con cui lavora. Ciò può portare a problemi di comunicazione e a una comprensione incoerente di queste risorse. Inoltre, a volte un concetto può richiedere conoscenze tecniche o specialistiche. Questo può rendere difficile per gli utenti aziendali di altri domini comprendere il concetto.
Il glossario aziendale di Dataplex Universal Catalog consente di creare un vocabolario centrale e standardizzato per le risorse di dati. Puoi utilizzare un glossario aziendale per:
- Definisci una struttura gerarchica di categorie e concetti aziendali, chiamati termini.
- Crea collegamenti tra i concetti definendo sinonimi e termini correlati.
- Associa le tue risorse di dati ai termini del glossario, il che ti consente di cercare le risorse di dati in base ai concetti aziendali.
Un glossario aziendale aiuta a semplificare l'individuazione dei dati e a ridurre l'ambiguità, il che può portare a un'analisi più accurata, a una migliore governance e a insight più rapidi.
Elementi di un glossario aziendale
Questa sezione descrive gli elementi chiave che puoi utilizzare per strutturare un glossario aziendale.
Glossario
Un glossario ha le seguenti proprietà:
- Panoramica. Descrive lo scopo e i contenuti del glossario aziendale. Puoi aggiungere immagini, link, tabelle o testo formattato al glossario. La dimensione massima supportata è 120 kB.
- Descrizione. Descrive il glossario. Il testo in questo campo è indicizzato per la ricerca. La dimensione massima supportata è 1 KB.
- Regione. Specifica la regione in cui si trova il glossario.
Categoria
Una categoria ti consente di organizzare e strutturare varie categorie e termini. Le categorie sono definite all'interno di un glossario aziendale. Puoi nidificare le categorie fino a tre livelli.
Una categoria ha le proprietà di un glossario, oltre alle seguenti:
- Contatti. Specifica la persona responsabile della manutenzione della categoria. Questa proprietà è descrittiva e non influisce sulle autorizzazioni della categoria.
- Genitore. Specifica una relazione utilizzata per stabilire la categoria principale della categoria attuale. Puoi nidificare fino a tre categorie.
La regione di una categoria è la stessa del glossario che la contiene.
Termine
Un termine (abbreviazione di "termine del glossario") descrive un concetto utilizzato in un particolare ramo di attività all'interno della tua azienda. Ad esempio, il reparto marketing di un'azienda potrebbe creare un termine che descrive il costo per clic. I termini sono definiti all'interno di un glossario aziendale, direttamente nel glossario o all'interno di qualsiasi categoria presente nel glossario.
Un termine ha le proprietà di una categoria, oltre alle seguenti:
- Sinonimi. Specifica i collegamenti tra termini che hanno lo stesso significato. Vedi Termini sinonimi.
- Termini correlati. Specifica i collegamenti tra termini concettualmente correlati tra loro, ma con significati diversi. Vedi Termini correlati.
- Voci correlate. Specifica i collegamenti tra i termini e gli asset di dati o tra i termini e le colonne all'interno degli asset di dati.
- Contatti. Specifica la persona responsabile della manutenzione del termine. I termini non ereditano i contatti definiti nelle categorie.
La regione di un termine è la stessa del glossario che lo contiene.
Termini sinonimi
Un sinonimo è una relazione che indica l'equivalenza tra due termini diversi. Utilizza i sinonimi quando due termini con lo stesso significato sono definiti da team diversi in glossari diversi. Ad esempio, puoi creare un sinonimo per collegare i termini "profitto" e "utili".
Termini correlati
Un termine correlato è una relazione che indica che due termini sono associati tra loro, ma hanno significati diversi. Ad esempio, puoi creare un termine correlato per collegare i termini "entrate" e "utile".
Limitazioni
- Il glossario aziendale di Dataplex Universal Catalog non è supportato per i progetti Assured Workload.
- I glossari aziendali sono ospitati all'interno di progetti e località; i limiti per progetti e località si applicano ai glossari.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare e gestire glossari, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:
-
Per gli amministratori dei dati, ottieni l'accesso completo a glossari, categorie, termini, sinonimi e termini correlati e per impostare i criteri IAM:
Dataplex Catalog Admin (
roles/dataplex.catalogAdmin
) -
Per i responsabili della gestione dei dati o i proprietari dei dati, ottieni l'accesso alla creazione, alla modifica o all'eliminazione di glossari, categorie, termini, link tra termini, link tra termini e asset di dati e alla ricerca:
Editor di Dataplex Catalog (
roles/dataplex.catalogEditor
) -
Per gli analisti o i consumatori di dati, ottieni l'accesso in sola lettura a glossari, categorie, termini, link tra termini e tra termini e asset di dati e ricerca:
Visualizzatore Dataplex Catalog (
roles/dataplex.catalogViewer
)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e gestire glossari. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e gestire glossari sono necessarie le seguenti autorizzazioni:
-
Crea, leggi, aggiorna ed elimina un glossario aziendale, una categoria e dei termini nel tuo progetto:
-
dataplex.glossaries.list
-
dataplex.glossaries.create
-
dataplex.glossaries.get
-
dataplex.glossaries.update
-
dataplex.glossaries.delete
-
dataplex.glossaryCategories.create
-
dataplex.glossaryCategories.list
-
dataplex.glossaryCategories.get
-
dataplex.glossaryCategories.update
-
dataplex.glossaryCategories.delete
-
dataplex.glossaryTerms.create
-
dataplex.glossaryTerms.list
-
dataplex.glossaryTerms.get
-
dataplex.glossaryTerms.update
-
dataplex.glossaryTerms.delete
-
-
Crea ed elimina i link da termine a termine dei sinonimi nel tuo progetto:
-
dataplex.entryLinks.create
nel gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui viene concessa l'autorizzazione. -
dataplex.entryGroups.useSynonymEntryLink
nel gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui viene concessa l'autorizzazione. -
dataplex.glossaryTerms.use
sui glossari i cui termini devono essere associati. -
dataplex.entryLinks.delete
sul gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente il link.
-
-
Crea ed elimina i collegamenti tra termini correlati nel tuo progetto:
-
dataplex.entryLinks.create
nel gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui viene concessa l'autorizzazione. -
dataplex.entryGroups.useRelatedEntryLink
nel gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui viene concessa l'autorizzazione. -
dataplex.entries.link
nel gruppo di voci di Dataplex Universal Catalog nei progetti in cui sono presenti voci corrispondenti ai termini del glossario. -
dataplex.entryLinks.delete
sul gruppo di voci di Dataplex Universal Catalog nel progetto in cui è presente il link.
-
-
Crea collegamenti tra i termini e gli asset o le colonne di dati nel tuo progetto:
-
dataplex.entryLinks.create
nel gruppo di voci di sistema corrispondente agli asset di dati o alle colonne del progetto. Il collegamento viene creato nel progetto per il quale viene concessa l'autorizzazione. -
dataplex.entryGroups.useDefinitionEntryLink
nel gruppo di voci di sistema corrispondente agli asset di dati o alle colonne del progetto. Il collegamento viene creato nel progetto per il quale viene concessa l'autorizzazione. -
dataplex.entries.link
nel gruppo di voci di sistema corrispondente agli asset di dati o alle colonne del progetto. Il collegamento viene creato nel progetto per il quale viene concessa l'autorizzazione. -
dataplex.glossaryTerms.use
sul glossario il cui termine deve essere associato. -
dataplex.entryLinks.delete
nel gruppo di voci di sistema in cui è presente il link.
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per maggiori informazioni, consulta la pagina Ruoli predefiniti per Data Catalog.
Creare e gestire glossari aziendali
Le sezioni seguenti descrivono come creare, visualizzare, modificare ed eliminare un glossario aziendale.
Creare un glossario aziendale
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Fai clic su Crea glossario aziendale.
Nella pagina Crea glossario aziendale, specifica un nome e una posizione per il glossario aziendale. Dopo aver creato il glossario, non puoi modificarne la posizione.
Fai clic su Crea. Il glossario viene creato nel progetto attuale.
(Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).
REST
Quando crei un glossario, Dataplex Universal Catalog crea una voce per rappresentarlo.
Crea il glossario.
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF { "displayName": "DISPLAY_NAME", "description": "DESCRIPTION" } EOF
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui vuoi creare il glossarioLOCATION_ID
: l'ID della località in cui vuoi creare il glossarioGLOSSARY_ID
: l'ID del glossarioDISPLAY_NAME
: il nome visualizzato del glossarioDESCRIPTION
: la descrizione del glossario, fino a un massimo di 1024 caratteri
(Facoltativo) Aggiungi una panoramica al glossario.
Cerca la voce del glossario:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID \ \&view=ALL
Sostituisci
PROJECT_NUMBER
con il numero del progetto in cui è stato creato il glossario.Aggiungere una panoramica al glossario:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\ ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \ --data @- << EOF { "aspects": { "dataplex-types.global.overview": { "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview", "data": { "content": "OVERVIEW", "links": [] }, } } } EOF
Sostituisci
OVERVIEW
con testo normale o HTML per descrivere la categoria o il termine del glossario.
Visualizzare i glossari disponibili
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Il riquadro I miei glossari mostra tutti i glossari dell'organizzazione che hai l'autorizzazione a visualizzare, insieme alle relative descrizioni e ai timestamp dell'ultima modifica.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries
Modificare un glossario
Puoi modificare il nome e la descrizione di un glossario.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Fai clic sul glossario da modificare.
Fai clic su Modifica accanto al nome, alla descrizione o alla panoramica, quindi apporta la modifica.
Fai clic su Salva.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF { "displayName": "DISPLAY_NAME", "description": "DESCRIPTION" } EOF
Eliminare un glossario
Prima di poter eliminare un glossario, devi prima eliminare tutte le categorie e tutti i termini del glossario.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Fai clic sul glossario che vuoi eliminare.
Fai clic su Elimina e poi conferma quando richiesto.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID
Creare e gestire le categorie
Le sezioni seguenti descrivono come creare, visualizzare, aggiornare ed eliminare le categorie.
Crea una categoria in un glossario
Un glossario aziendale può avere un massimo di 200 categorie.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Seleziona il glossario in cui vuoi creare una categoria, quindi fai clic su Crea categoria.
Inserisci un nome per la categoria.
Fai clic su Crea.
(Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).
REST
Quando crei una categoria, Dataplex Universal Catalog crea una voce per rappresentarla.
Crea la categoria.
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF { "displayName": "CATEGORY_DISPLAY_NAME", "description": "CATEGORY_DESCRIPTION", "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID" } EOF
Sostituisci quanto segue:
CATEGORY_ID
: l'ID categoriaCATEGORY_DISPLAY_NAME
: il nome visualizzato della categoriaCATEGORY_DESCRIPTION
: la descrizione della categoria
(Facoltativo) Aggiungi una panoramica alla categoria.
Cerca la voce relativa alla tua categoria:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID \ \&view=ALL
Aggiungi una panoramica alla tua categoria:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\ ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \ --data @- << EOF { "aspects": { "dataplex-types.global.overview": { "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview ", "data": { "content": "OVERVIEW", "links": [] }, } } } EOF
Sostituisci
OVERVIEW
con testo normale o HTML per descrivere la categoria o il termine del glossario.
(Facoltativo) Aggiungere contatti
Cerca la voce relativa alla tua categoria:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID \ \&view=ALL
Aggiorna la voce della tua categoria con i contatti:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\ ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \ --data @- << EOF { "aspects": { "dataplex-types.global.contacts": { "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts", "data": { "identities": [ { "role": "steward", "name": "CONTACT_NAME", "id": "CONTACT_EMAIL" } ] }, } } } EOF
Creare una categoria nidificata
Un glossario aziendale può avere un massimo di tre livelli di categorie nidificate, escluso il livello principale del glossario.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario in cui vuoi creare una categoria.
Seleziona la categoria principale in cui vuoi creare un'altra categoria e fai clic su Crea categoria.
Inserisci un nome per la categoria.
Fai clic su Crea.
(Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF { "displayName": "CATEGORY_DISPLAY_NAME", "description": "CATEGORY_DESCRIPTION", "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID" } EOF
Sostituisci PARENT_CATEGORY_ID
con l'ID della categoria
principale.
Visualizzare le categorie che appartengono a un glossario
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Per visualizzare le categorie in un glossario, espandilo.
Per visualizzare le categorie nidificate in una categoria, espandi la categoria.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories
Modificare una categoria
Puoi modificare il nome, la descrizione e i contatti di una categoria. Per le categorie nidificate, puoi anche modificare la categoria principale.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sulla categoria che vuoi modificare.
Fai clic su
Modifica accanto al nome, alla descrizione o alla panoramica, quindi apporta la modifica.Fai clic su Salva.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF { "displayName": "CATEGORY_DISPLAY_NAME", "description": "DESCRIPTION" } EOF
Eliminare una categoria
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sulla categoria che vuoi eliminare.
Fai clic su Elimina e poi conferma quando richiesto.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
Creare e gestire termini
Le sezioni seguenti descrivono come creare, visualizzare, accedere, modificare ed eliminare i termini.
Creare un termine in un glossario aziendale
Un glossario aziendale può contenere un massimo di 5000 termini.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Per creare un termine a livello di glossario, seleziona il glossario in cui vuoi creare un termine e fai clic su Crea termine.
Inserisci un nome per il termine.
Fai clic su Crea.
(Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).
(Facoltativo) Per aggiungere contatti, fai clic su Modifica e poi fornisci un elenco di indirizzi email per i responsabili della gestione dei dati, i proprietari dei dati o i proprietari dei domini di dati. Quindi, fai clic su Salva.
REST
Quando crei un termine, Dataplex Universal Catalog crea una voce per rappresentarlo.
Crea il termine.
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF { "displayName": "TERM_DISPLAY_NAME", "description": "TERM_DESCRIPTION", "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID" } EOF
Sostituisci quanto segue:
- TERM_ID: l'ID del termine che stai creando
- TERM_DISPLAY_NAME: il nome visualizzato del termine che stai creando
- TERM_DESCRIPTION: la descrizione del termine che stai creando
(Facoltativo) Aggiungi una panoramica al termine.
Cerca la voce relativa al tuo termine:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ \&view=ALL
Aggiungi una panoramica al termine:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \ --data @- << EOF { "aspects": { "dataplex-types.global.overview": { "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview ", "data": { "content": "OVERVIEW", "links": [] }, } } } EOF
Sostituisci
OVERVIEW
con testo normale o HTML per descrivere la categoria o il termine del glossario.
(Facoltativo) Aggiungi contatti.
Cerca la voce relativa al tuo termine:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ \&view=ALL
Aggiorna la voce relativa al termine con i contatti:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \ --data @- << EOF { "aspects": { "dataplex-types.global.contacts": { "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts", "data": { "identities": [ { "role": "steward", "name": "CONTACT_NAME", "id": "CONTACT_EMAIL" } ] }, } } } EOF
Crea un termine in una categoria
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Per creare un termine in una categoria, seleziona la categoria in cui vuoi creare un termine, quindi fai clic su Aggiungi termine.
Inserisci un nome per il termine.
Fai clic su Crea.
(Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).
(Facoltativo) Per aggiungere contatti, fai clic su Modifica e poi fornisci un elenco di indirizzi email per i responsabili della gestione dei dati, i proprietari dei dati o i proprietari dei domini di dati. Quindi, fai clic su Salva.
REST
Quando crei un termine, Dataplex Universal Catalog crea una voce per rappresentarlo.
Crea un termine.
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF { "displayName": "TERM_DISPLAY_NAME", "description": "TERM_DESCRIPTION", "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID" } EOF
Sostituisci quanto segue:
- TERM_ID: l'ID del termine che stai creando
- TERM_DISPLAY_NAME: il nome visualizzato del termine che stai creando
- TERM_DESCRIPTION: la descrizione del termine che stai creando
(Facoltativo) Aggiungi una panoramica al termine.
Cerca la voce relativa al tuo termine:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ \&view=ALL
Aggiungi una panoramica al termine:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \ --data @- << EOF { "aspects": { "dataplex-types.global.overview": { "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview ", "data": { "content": "OVERVIEW", "links": [] }, } } } EOF
Sostituisci
OVERVIEW
con testo normale o HTML per descrivere la categoria o il termine del glossario.
(Facoltativo) Aggiungi contatti.
Cerca la voce relativa al tuo termine:
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID :lookupEntry\ ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID \ \&view=ALL
Aggiorna la voce relativa al termine con i contatti:
gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID ?update_mask=aspects\ \&deleteMissingAspects=false\ \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \ --data @- << EOF { "aspects": { "dataplex-types.global.contacts": { "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts", "data": { "identities": [ { "role": "steward", "name": "CONTACT_NAME", "id": "CONTACT_EMAIL" } ] }, } } } EOF
Visualizzare i termini in un glossario o in una categoria
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Per visualizzare i termini in un glossario, espandilo. Per visualizzare i termini di una categoria all'interno di questo glossario, espandi la categoria. Per visualizzare i termini all'interno di una categoria nidificata, espandi la categoria nidificata.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms
Visualizzare i dettagli di un termine
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Per visualizzare l'elenco dei termini in un glossario, espandi il glossario.
Fai clic su un termine. La pagina Dettagli termine mostra il nome del termine, la descrizione, i termini correlati, i sinonimi e le voci correlate.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
Modificare un termine
Puoi modificare il nome, la descrizione, la panoramica, i contatti e il genitore di un termine.
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sul termine che vuoi modificare.
Fai clic su Modifica.
Modifica uno dei campi e fai clic su Salva.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF { "displayName": "TERM_DISPLAY_NAME", "description": "TERM_DESCRIPTION" } EOF
Eliminare un termine
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sul termine che vuoi eliminare.
Fai clic su Elimina e poi conferma quando richiesto.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
Gestire i sinonimi e i termini correlati
Puoi aggiungere relazioni tra i termini collegandoli come sinonimi o termini correlati.
Le relazioni dei termini sono bidirezionali. Ad esempio, quando colleghi profit
come sinonimo di earnings
, earnings
diventa anche un sinonimo di profit
.
Creare collegamenti di sinonimi tra i termini
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sul termine con cui vuoi creare i link.
Fai clic su
Modifica accanto a Termini sinonimi.Cerca e seleziona i termini a cui creare un link.
Il termine viene collegato immediatamente quando lo selezioni.
Fai clic su Chiudi.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF { "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym", "entry_references": [{ "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID", "type": "UNSPECIFIED" }, { "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID", "type": "UNSPECIFIED" } ] } EOF )"
Sostituisci quanto segue:
TERM1_PROJECT_NUMBER
: il numero di progetto del primo termine da collegare.TERM1_LOCATION_ID
: l'ID località del glossario che contiene il primo termine.TERM1_GLOSSARY_ID
: l'ID del glossario che contiene il primo termine.TERM1_ID
: l'ID del primo termine.TERM2_PROJECT_NUMBER
: il numero di progetto del secondo termine che vuoi collegare come termine sinonimo. Se entrambi i termini si trovano nello stesso progetto, questo valore è uguale al numero di progetto del primo termine.TERM2_LOCATION_ID
: l'ID della località del glossario che contiene il secondo termine. Se entrambi i termini si trovano nella stessa posizione, questo valore è uguale all'ID posizione del primo termine.TERM2_GLOSSARY_ID
: l'ID del glossario che contiene il secondo termine. Se entrambi i termini si trovano nello stesso glossario, questo valore è uguale all'ID glossario del primo termine.TERM2_ID
: l'ID del secondo termine.ENTRY_LINK_ID
: un ID per il collegamento tra i due termini. Ogni termine è rappresentato come una voce di Dataplex Universal Catalog. Il collegamento di voce è la relazione tra i termini sinonimi.
Creare link correlati tra i termini
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sul termine con cui vuoi creare i link.
Fai clic su
Modifica accanto a Termini correlati.Cerca e seleziona i termini a cui creare un link.
Il termine viene collegato immediatamente quando lo selezioni.
Fai clic su Chiudi.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF { "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related", "entry_references": [{ "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID", "type": "UNSPECIFIED" }, { "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID", "type": "UNSPECIFIED" } ] } EOF )"
Sostituisci quanto segue:
TERM1_PROJECT_NUMBER
: il numero di progetto del primo termine da collegare.TERM1_LOCATION_ID
: l'ID località del glossario che contiene il primo termine.TERM1_GLOSSARY_ID
: l'ID del glossario che contiene il primo termine.TERM1_ID
: l'ID del primo termine.TERM2_PROJECT_NUMBER
: il numero di progetto del secondo termine che vuoi collegare come termine correlato. Se entrambi i termini si trovano nello stesso progetto, questo valore è uguale al numero di progetto del primo termine.TERM2_LOCATION_ID
: l'ID della località del glossario che contiene il secondo termine. Se entrambi i termini si trovano nella stessa posizione, questo valore è uguale all'ID posizione del primo termine.TERM2_GLOSSARY_ID
: l'ID del glossario che contiene il secondo termine. Se entrambi i termini si trovano nello stesso glossario, questo valore è uguale all'ID glossario del primo termine.TERM2_ID
: l'ID del secondo termine.ENTRY_LINK_ID
: un ID per il collegamento tra i due termini. Ogni termine è rappresentato come una voce di Dataplex Universal Catalog. Il collegamento di voce è la relazione tra termini correlati.
Rimuovere i collegamenti tra sinonimi e termini correlati
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Espandi il glossario e fai clic sul termine di cui vuoi rimuovere i sinonimi o i termini correlati.
Per eliminare i link tra i termini correlati, fai clic su
Modifica accanto a Termini correlati. Elimina i termini correlati, quindi fai clic su Chiudi.Per eliminare i link tra i sinonimi, fai clic su
Modifica accanto a Termini sinonimi. Elimina i sinonimi, poi fai clic su Chiudi.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID
Gestire i collegamenti tra i termini e gli asset di dati
Puoi allegare termini agli asset di dati o alle colonne degli asset di dati. Ad esempio, puoi allegare termini a un set di dati BigQuery.
Allegare termini a un asset di dati
Console
Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.
Cerca l'asset di dati (ad esempio un set di dati, un file o una tabella) a cui vuoi collegare un termine e poi fai clic.
Nella pagina dell'asset di dati, esegui una delle seguenti operazioni:
- Per collegare i termini a un asset, nella scheda Dettagli, fai clic su Aggiungi nella sezione Termini del glossario. Cerca e seleziona i termini, quindi fai clic su Chiudi.
- Se l'asset ha uno schema, puoi collegare i termini a una colonna. Nella scheda Schema, seleziona una colonna a cui collegare i termini e poi fai clic su Aggiungi termine aziendale. Cerca e seleziona i termini, quindi fai clic su Chiudi.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF { "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition", "entry_references": [{ "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID", "type": "SOURCE" }, { "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID", "type": "TARGET" } ] } EOF )"
Sostituisci quanto segue:
PROJECT_NUMBER
: il numero di progetto dell'asset di dati a cui viene collegatoENTRY_LOCATION_ID
: l'ID posizione dell'asset di dati a cui viene eseguito il collegamentoENTRY_GROUP_ID
: il gruppo di voci dell'asset di dati a cui viene collegatoENTRY_LINK_ID
: un ID per il collegamento tra il termine e la voce del Catalogo universale Dataplex che rappresenta l'asset di dati.TERM_PROJECT_NUMBER
: il numero di progetto del termine da collegare.
Collegare termini a una colonna in uno schema di voci
Console
Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.
Cerca l'asset di dati (ad esempio un set di dati, un file o una tabella) che ha uno schema con una colonna a cui vuoi collegare un termine. Fai clic sull'asset di dati.
Nella pagina dell'asset di dati, esegui una delle seguenti operazioni:
- Per collegare i termini a una colonna nell'asset di dati, nella scheda Schema, seleziona le colonne a cui vuoi allegare il termine.
- Fai clic su Aggiungi termine aziendale. Cerca il termine da allegare e fai clic per allegarlo.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID", "type": "SOURCE" "path": "Schema/COLUMN_NAME" }, { "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID", "type": "TARGET" } ] } EOF )"
Sostituisci quanto segue:
PROJECT_NUMBER
: il numero di progetto dell'asset di dati a cui viene collegatoENTRY_LOCATION_ID
: l'ID posizione dell'asset di dati a cui viene eseguito il collegamentoENTRY_GROUP_ID
: il gruppo di voci dell'asset di dati a cui viene collegatoENTRY_LINK_ID
: un ID per il collegamento tra il termine e la voce del Catalogo universale Dataplex che rappresenta l'asset di datiTERM_PROJECT_NUMBER
: il numero di progetto del termine da collegareCOLUMN_NAME
: la colonna a cui vuoi allegare il termine
Rimuovere i termini da un asset di dati
Console
Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.
Cerca l'asset di dati (ad esempio un set di dati, un file o una tabella) da cui vuoi rimuovere i termini e fai clic.
Nella pagina dell'asset di dati, esegui una delle seguenti operazioni:
- Per rimuovere un termine da un asset, nella scheda Dettagli, fai clic sul termine nella sezione Termini del glossario. Quindi, fai clic su .
- Per rimuovere un termine da una colonna, nella scheda Schema, fai clic su accanto al termine.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID
Trovare glossari, termini e asset di dati collegati
Console
Per navigare tra i contenuti del glossario aziendale, utilizza l'albero del glossario e dei termini nella pagina Glossari.
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Nella pagina Glossari, utilizza la barra dei filtri per trovare le categorie. Sono disponibili i seguenti filtri:
- Nome: restituisce i glossari, le categorie e i termini il cui nome contiene il testo che fornisci.
- Genitore: restituisce i termini il cui nome o descrizione del glossario principale
corrisponde al testo che fornisci. Ad esempio,
parent:Finance
restituisce i termini collegati al glossario principale il cui nome o descrizione contiene la fraseFinance
. - Sinonimo: restituisce l'elenco dei termini con un sinonimo il cui nome o ID
contiene il testo che fornisci. Ad esempio,
synonym:Profit
restituisce i termini che hanno un termine sinonimo il cui nome o ID contiene la fraseprofit
. - Contatto: restituisce i termini in cui il gestore dati è elencato come
contatto. Ad esempio,
contact:alex@example.com
restituisce le voci collegate a termini con un responsabile dei dati corrispondente aalex@example.com
.
REST
Per trovare glossari, termini e asset di dati collegati utilizzando l'API REST, devi registrarti per la versione di anteprima.
Cerca asset di dati collegati ai termini
Console
Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.
Nella pagina Glossari, utilizza la barra dei filtri per inserire una query di ricerca di testo in formato libero. Viene restituito un elenco di corrispondenze nel glossario, nella categoria e nei nomi dei termini.
Fai clic su un termine corrispondente.
Nella pagina Dettagli termine, visualizza i termini collegati (sinonimi e termini correlati) e le voci collegate (asset di dati) a questo termine.
Se vuoi visualizzare i dettagli di una voce in Dataplex Universal Catalog, fai clic sulla voce.
REST
Per trovare glossari, termini e asset di dati collegati utilizzando l'API REST, devi registrarti per la versione di anteprima.
Importare glossari e link tra termini e asset di termini o dati
Per importare glossari e link da un altro strumento di catalogazione o per aggiornare i glossari in Dataplex Universal Catalog, puoi importare in blocco glossari, categorie, termini, link tra termini, link tra termini e asset di dati o colonne utilizzando l'API REST.
Crea il glossario di destinazione.
REST
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF { "displayName": "DISPLAY_NAME", "description": "DESCRIPTION" } EOF )"
Sostituisci quanto segue:
PROJECT_ID
: l'ID progetto in cui stai creando il glossarioLOCATION_ID
: la località in cui vogliamo creare il glossarioGLOSSARY_ID
: l'ID glossarioDISPLAY_NAME
: il nome visualizzato del glossarioDESCRIPTION
: la descrizione del glossario
Per importare categorie, termini e link tra termini e asset di dati nel glossario di destinazione creato, carica i file per ciascuno di questi in un bucket Cloud Storage. Questi file hanno il seguente formato:
Formato di esempio per i termini e le categorie di un glossario
{"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}} {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}} {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
Formato di esempio per i link tra i termini
{"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}} {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
Formato di esempio per i link tra termini e asset di dati
projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
# Set GCURL alias alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"' gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF { "type":"IMPORT", "import_spec":{ "log_level":"DEBUG", "source_storage_uri":"gs://STORAGE_BUCKET/", "entry_sync_mode":"FULL", "aspect_sync_mode":"INCREMENTAL", "scope":{ "glossaries": "GLOSSARY_NAME" } } } EOF )"
Sostituisci
DATAPLEX_API
con l'endpoint API di Dataplex Universal Catalog nel formatodataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
.(Facoltativo) Recupera lo stato dell'operazione.
gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID
Sostituisci
OPERATION_ID
con l'ID dell'operazione.(Facoltativo) Recupera lo stato del job dei metadati.
gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID
Importa i link tra i termini come sinonimi o termini correlati.
gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF { "type":"IMPORT", "import_spec":{ "log_level":"DEBUG", "source_storage_uri":"gs://STORAGE_BUCKET/", "entry_sync_mode":"FULL", "aspect_sync_mode":"INCREMENTAL", "scope":{ "entry_groups":[ "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex" ], "entry_link_types":[ "projects/dataplex-types/locations/global/entryLinkTypes/synonym", "projects/dataplex-types/locations/global/entryLinkTypes/related" ], "referenced_entry_scopes":[ "PROJECT_IDS" ] } } } EOF )"
Sostituisci
DATAPLEX_API
condataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
.Importa i link tra i termini e gli asset o le colonne di dati.
Per creare un collegamento tra i termini del glossario e gli asset di dati, esegui l'importazione per ogni gruppo di voci a cui appartiene la voce per l'asset di dati. Tutti i link alle voci di definizione vengono creati in questo gruppo di voci.
gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF { "type":"IMPORT", "import_spec":{ "log_level":"DEBUG", "source_storage_uri":"gs://STORAGE_BUCKET/", "entry_sync_mode":"FULL", "aspect_sync_mode":"INCREMENTAL", "scope":{ "entry_groups":[ "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex" ], "entry_link_types":[ "projects/dataplex-types/locations/global/entryLinkTypes/definition" ], "referenced_entry_scopes":[ "PROJECT_IDS" ] } } } EOF )"
Sostituisci
DATAPLEX_API
condataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
.
Prezzi
A partire da luglio 2026, il glossario aziendale di Dataplex Universal Catalog verrà fatturato allo stesso modo dei prezzi di archiviazione dei metadati. Consulta Prezzi dello spazio di archiviazione dei metadati del Catalogo universale Dataplex.
Passaggi successivi
- Se utilizzi la versione di anteprima del glossario aziendale per Data Catalog, consulta Eseguire la transizione al glossario aziendale su Dataplex Universal Catalog.