Gestire un glossario aziendale

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".

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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Fai clic su Crea glossario aziendale.

  3. 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.

  4. Fai clic su Crea. Il glossario viene creato nel progetto attuale.

  5. (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.

  1. 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 glossario
    • LOCATION_ID: l'ID della località in cui vuoi creare il glossario
    • GLOSSARY_ID: l'ID del glossario
    • DISPLAY_NAME: il nome visualizzato del glossario
    • DESCRIPTION: la descrizione del glossario, fino a un massimo di 1024 caratteri
  2. (Facoltativo) Aggiungi una panoramica al glossario.

    1. 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.

    2. 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.

    Vai a Glossari.

    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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Fai clic sul glossario da modificare.

  3. Fai clic su Modifica accanto al nome, alla descrizione o alla panoramica, quindi apporta la modifica.

  4. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Fai clic sul glossario che vuoi eliminare.

  3. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Seleziona il glossario in cui vuoi creare una categoria, quindi fai clic su Crea categoria.

  3. Inserisci un nome per la categoria.

  4. Fai clic su Crea.

  5. (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.

  1. 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 categoria
    • CATEGORY_DISPLAY_NAME: il nome visualizzato della categoria
    • CATEGORY_DESCRIPTION: la descrizione della categoria
  2. (Facoltativo) Aggiungi una panoramica alla categoria.

    1. 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
    2. 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.

  3. (Facoltativo) Aggiungere contatti

    1. 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
    2. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario in cui vuoi creare una categoria.

  3. Seleziona la categoria principale in cui vuoi creare un'altra categoria e fai clic su Crea categoria.

  4. Inserisci un nome per la categoria.

  5. Fai clic su Crea.

  6. (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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Per visualizzare le categorie in un glossario, espandilo.

  3. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sulla categoria che vuoi modificare.

  3. Fai clic su Modifica accanto al nome, alla descrizione o alla panoramica, quindi apporta la modifica.

  4. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sulla categoria che vuoi eliminare.

  3. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Per creare un termine a livello di glossario, seleziona il glossario in cui vuoi creare un termine e fai clic su Crea termine.

  3. Inserisci un nome per il termine.

  4. Fai clic su Crea.

  5. (Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).

  6. (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.

  1. 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
  2. (Facoltativo) Aggiungi una panoramica al termine.

    1. 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
    2. 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.

  3. (Facoltativo) Aggiungi contatti.

    1. 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
    2. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Per creare un termine in una categoria, seleziona la categoria in cui vuoi creare un termine, quindi fai clic su Aggiungi termine.

  3. Inserisci un nome per il termine.

  4. Fai clic su Crea.

  5. (Facoltativo) Aggiungi una breve descrizione in Descrizione (fino a 1024 caratteri) o una descrizione lunga in Panoramica (fino a 120 KB).

  6. (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.

  1. 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
  2. (Facoltativo) Aggiungi una panoramica al termine.

    1. 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
    2. 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.

  3. (Facoltativo) Aggiungi contatti.

    1. 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
    2. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Per visualizzare l'elenco dei termini in un glossario, espandi il glossario.

  3. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sul termine che vuoi modificare.

  3. Fai clic su Modifica.

  4. 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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sul termine che vuoi eliminare.

  3. 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

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.

Console

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sul termine con cui vuoi creare i link.

  3. Fai clic su Modifica accanto a Termini sinonimi.

  4. Cerca e seleziona i termini a cui creare un link.

    Il termine viene collegato immediatamente quando lo selezioni.

  5. 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.

Console

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sul termine con cui vuoi creare i link.

  3. Fai clic su Modifica accanto a Termini correlati.

  4. Cerca e seleziona i termini a cui creare un link.

    Il termine viene collegato immediatamente quando lo selezioni.

  5. 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.

Console

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. Espandi il glossario e fai clic sul termine di cui vuoi rimuovere i sinonimi o i termini correlati.

  3. 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.

  4. 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

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.

Console

  1. Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.

    Vai a Cerca

  2. 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.

  3. 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 collegato
  • ENTRY_LOCATION_ID: l'ID posizione dell'asset di dati a cui viene eseguito il collegamento
  • ENTRY_GROUP_ID: il gruppo di voci dell'asset di dati a cui viene collegato
  • ENTRY_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

  1. Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.

    Vai a Cerca

  2. 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.

  3. 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 collegato
  • ENTRY_LOCATION_ID: l'ID posizione dell'asset di dati a cui viene eseguito il collegamento
  • ENTRY_GROUP_ID: il gruppo di voci dell'asset di dati a cui viene collegato
  • ENTRY_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
  • COLUMN_NAME: la colonna a cui vuoi allegare il termine

Console

  1. Nella Google Cloud console, vai alla pagina Cerca di Dataplex Universal Catalog.

    Vai a Cerca

  2. 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.

  3. 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.

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. 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 frase Finance.
    • 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 frase profit.
    • 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 a alex@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

  1. Nella Google Cloud console, vai alla pagina Glossari di Dataplex Universal Catalog.

    Vai a Glossari.

  2. 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.

  3. Fai clic su un termine corrispondente.

  4. Nella pagina Dettagli termine, visualizza i termini collegati (sinonimi e termini correlati) e le voci collegate (asset di dati) a questo termine.

  5. 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.

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.

  1. 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 glossario
    • LOCATION_ID: la località in cui vogliamo creare il glossario
    • GLOSSARY_ID: l'ID glossario
    • DISPLAY_NAME: il nome visualizzato del glossario
    • DESCRIPTION: la descrizione del glossario
  2. 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 formato dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  3. (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.

  4. (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
  5. 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 con dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  6. 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 con dataplex.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