Gestire un glossario aziendale

I glossari aziendali in Knowledge Catalog (in precedenza Dataplex Universal Catalog) ti consentono di stabilire un vocabolario standardizzato per gli asset di dati della tua organizzazione. Puoi creare e gestire categorie e termini per ridurre l'ambiguità e migliorare il rilevamento e la governance dei dati. Se è la prima volta che crei un glossario aziendale, consulta la guida rapida Crea e utilizza un glossario aziendale.

Casi d'uso del glossario aziendale di Knowledge Catalog

Creando un linguaggio comune per i dati utilizzando il glossario aziendale di Knowledge Catalog, puoi ottenere quanto segue:

• Definisci una gerarchia chiara di categorie dell'attività e termini.
• Collega i concetti utilizzando i sinonimi e mostra le relazioni tra i termini.
• Cerca risorse di dati in base a concetti aziendali, non solo a nomi tecnici.

Il glossario aziendale di Knowledge Catalog aiuta a semplificare il rilevamento dei dati e a ridurre l'ambiguità, con conseguente miglioramento della governance, analisi più accurate e 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 e tabelle. Sebbene la formattazione HTML non sia supportata, puoi includere codice HTML formattato come codice o aggiungere un link a una pagina HTML. Puoi anche utilizzare opzioni di formattazione RTF come grassetto, corsivo, sottolineato, elenchi puntati, paragrafi, intestazioni e blocchi di codice. La dimensione massima supportata è 120 kB.

• Description. Descrive il glossario. Il testo in questo campo viene indicizzato per la ricerca. La dimensione massima supportata è 1 kB.

• Regione. Specifica la regione in cui si trova il glossario.

Categoria

Una categoria 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 proprietà:

• 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 l'elemento principale della categoria corrente. 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à 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 proprietà:

• Sinonimi. Specifica i link tra i termini che hanno lo stesso significato. Consulta i termini sinonimi.
• Termini correlati. Specifica i link tra termini concettualmente correlati tra loro, ma con significati diversi. Consulta i termini correlati.
• Voci correlate. Specifica i link tra i termini e gli asset di dati o tra i termini e le colonne all'interno degli asset di dati.
• Regole sulla qualità dei dati. Specifica i requisiti di qualità dei dati per il termine. Per saperne di più, consulta Riutilizza le regole di qualità dei 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 "profitto".

Limitazioni

• I glossari aziendali sono ospitati all'interno di progetti e località; le limitazioni per progetti e località si applicano ai glossari.
• Quando utilizzi un glossario aziendale con un agente di dati BigQuery, l'agente di dati può importare un massimo di 10 termini del glossario per tabella. Se colleghi più di 10 termini a una tabella, l'agente di dati ignora i termini aggiuntivi. Per prestazioni ottimali dell'agente di dati, assicurati di fornire anche descrizioni complete a livello di tabella e di colonna nelle tabelle.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire i glossari, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Per gli amministratori dei dati, ottieni l'accesso completo a glossari, categorie, termini, sinonimi e termini correlati e imposta i criteri IAM: Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
• Per i data steward o i proprietari dei dati, ottieni l'accesso per creare, modificare o eliminare glossari, categorie, termini, link tra termini, link tra termini e asset di dati e ricerca: Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• Per gli analisti o i consumer di dati, ottieni l'accesso di sola lettura a glossari, categorie, termini, link tra termini e tra termini e asset di dati e ricerca: Dataplex Catalog Viewer (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 i glossari. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare e gestire i glossari sono necessarie le seguenti autorizzazioni:

• Creare, leggere, aggiornare ed eliminare un glossario aziendale, una categoria e i 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, cerca ed elimina i link tra sinonimi nel tuo progetto:
  • dataplex.entryLinks.create sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui è stata concessa l'autorizzazione.
  • dataplex.entryGroups.useSynonymEntryLink sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui è stata concessa l'autorizzazione.
  • dataplex.glossaryTerms.use sui glossari i cui termini devono essere associati.
  • dataplex.glossaryTerms.get sul termine di cui stai cercando i link ai sinonimi. Knowledge Catalog oscura i sinonimi nella risposta se non disponi dell'autorizzazione dataplex.glossaryTerms.get per questi termini.
  • dataplex.entryLinks.delete sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente il link.
• Crea, cerca ed elimina i link correlati tra termini nel tuo progetto:
  • dataplex.entryLinks.create sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui è stata concessa l'autorizzazione.
  • dataplex.entryGroups.useRelatedEntryLink sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente uno dei termini del glossario. Il link viene creato nel gruppo di voci per cui è stata concessa l'autorizzazione.
  • dataplex.entries.link sul gruppo di voci di Knowledge Catalog nei progetti in cui sono presenti voci corrispondenti ai termini del glossario.
  • dataplex.glossaryTerms.get sul termine di cui stai cercando i link correlati. Knowledge Catalog oscura i termini correlati nella risposta se non disponi dell'autorizzazione dataplex.glossaryTerms.get per questi termini.
  • dataplex.entryLinks.delete sul gruppo di voci di Knowledge Catalog nel progetto in cui è presente il link.
• Crea, cerca ed elimina i link tra i termini e gli asset di dati o le colonne nel tuo progetto:
  • dataplex.entryLinks.create sul gruppo di voci di sistema corrispondente agli asset di dati o alle colonne nel progetto. Il link viene creato nel progetto per il quale viene concessa l'autorizzazione.
  • dataplex.entryGroups.useDefinitionEntryLink sul gruppo di voci di sistema corrispondente agli asset di dati o alle colonne del progetto. Il link viene creato nel progetto per il quale è stata concessa l'autorizzazione.
  • dataplex.entries.link sul gruppo di voci di sistema corrispondente agli asset di dati o alle colonne nel progetto. Il link viene creato nel progetto per il quale viene concessa l'autorizzazione.
  • dataplex.glossaryTerms.use sul glossario di cui deve essere associato il termine.
  • Autorizzazione in lettura del sistema di origine (ad esempio bigquery.tables.get o dataplex.glossaryTerms.get) sulla voce di cui stai cercando i link. Knowledge Catalog oscura gli asset di dati nella risposta se non disponi dell'autorizzazione in lettura del sistema di origine per questi asset.
  • dataplex.entryLinks.delete sul gruppo di voci di sistema in cui è presente il link.

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, consulta Ruoli IAM di Knowledge Catalog.

Crea e gestisci glossari aziendali

Le sezioni seguenti descrivono come creare, visualizzare, modificare ed eliminare un glossario aziendale. Quando crei glossari aziendali, categorie o termini, assicurati che i loro ID siano conformi alle linee guida per la denominazione delle risorse di Knowledge Catalog.

Nota: la richiesta di modifiche ai metadati dei glossari aziendali e delle voci di Knowledge Catalog con workflow di governance è disponibile in anteprima privata. Per richiedere l'accesso alla funzionalità, compila il seguente modulo di accesso.

Crea un glossario aziendale

Console

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

   Vai a Glossari

2. Fai clic su Crea glossario aziendale.

3. Nella pagina Crea glossario aziendale, specifica un nome e una località per il glossario aziendale. Dopo aver creato il glossario, non puoi modificare la località.

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

C#

C#

Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using Google.LongRunning;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for CreateGlossary</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CreateGlossaryRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        CreateGlossaryRequest request = new CreateGlossaryRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            GlossaryId = "",
            Glossary = new Glossary(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<Glossary, OperationMetadata> response = businessGlossaryServiceClient.CreateGlossary(request);

        // Poll until the returned long-running operation is complete
        Operation<Glossary, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Glossary result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Glossary, OperationMetadata> retrievedResponse = businessGlossaryServiceClient.PollOnceCreateGlossary(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Glossary retrievedResult = retrievedResponse.Result;
        }
    }
}

Vai

Go

Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateGlossaryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateGlossaryRequest.
	}
	op, err := c.CreateGlossary(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.CreateGlossaryRequest;
import com.google.cloud.dataplex.v1.Glossary;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncCreateGlossary {

  public static void main(String[] args) throws Exception {
    syncCreateGlossary();
  }

  public static void syncCreateGlossary() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      CreateGlossaryRequest request =
          CreateGlossaryRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setGlossaryId("glossaryId1849967577")
              .setGlossary(Glossary.newBuilder().build())
              .setValidateOnly(true)
              .build();
      Glossary response = businessGlossaryServiceClient.createGlossaryAsync(request).get();
    }
  }
}

Node.js

Node.js

Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent resource where this Glossary will be created.
 *  Format: projects/{project_id_or_number}/locations/{location_id}
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Required. Glossary ID: Glossary identifier.
 */
// const glossaryId = 'abc123'
/**
 *  Required. The Glossary to create.
 */
// const glossary = {}
/**
 *  Optional. Validates the request without actually creating the Glossary.
 *  Default: false.
 */
// const validateOnly = true

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callCreateGlossary() {
  // Construct request
  const request = {
    parent,
    glossaryId,
    glossary,
  };

  // Run request
  const [operation] = await dataplexClient.createGlossary(request);
  const [response] = await operation.promise();
  console.log(response);
}

callCreateGlossary();

Python

Python

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_create_glossary():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.CreateGlossaryRequest(
        parent="parent_value",
        glossary_id="glossary_id_value",
    )

    # Make the request
    operation = client.create_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/dataplex/v1"

##
# Snippet for the create_glossary call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#create_glossary.
#
def create_glossary
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::CreateGlossaryRequest.new

  # Call the create_glossary method.
  result = client.create_glossary request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

Quando crei un glossario, Knowledge 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 tuo 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. Aggiungi 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.

Visualizza i glossari disponibili

Console

• Nella console Google Cloud , vai alla pagina Glossari di Knowledge Catalog.

  Vai a Glossari

  Il riquadro I miei glossari mostra tutti i glossari dell'organizzazione che hai l'autorizzazione di visualizzare, insieme alle relative descrizioni e ai timestamp dell'ultima modifica.

C#

C#

Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for ListGlossaries</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void ListGlossariesRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        ListGlossariesRequest request = new ListGlossariesRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Filter = "",
            OrderBy = "",
        };
        // Make the request
        PagedEnumerable<ListGlossariesResponse, Glossary> response = businessGlossaryServiceClient.ListGlossaries(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (Glossary item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (ListGlossariesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (Glossary item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<Glossary> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (Glossary item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Vai

Go

Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.ListGlossariesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#ListGlossariesRequest.
	}
	it := c.ListGlossaries(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.ListGlossariesResponse)
	}
}

Java

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.Glossary;
import com.google.cloud.dataplex.v1.ListGlossariesRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncListGlossaries {

  public static void main(String[] args) throws Exception {
    syncListGlossaries();
  }

  public static void syncListGlossaries() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      ListGlossariesRequest request =
          ListGlossariesRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .setOrderBy("orderBy-1207110587")
              .build();
      for (Glossary element : businessGlossaryServiceClient.listGlossaries(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

Node.js

Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent, which has this collection of Glossaries.
 *  Format: projects/{project_id_or_number}/locations/{location_id}
 *  where `location_id` refers to a Google Cloud region.
 */
// const parent = 'abc123'
/**
 *  Optional. The maximum number of Glossaries to return. The service may
 *  return fewer than this value. If unspecified, at most 50 Glossaries will be
 *  returned. The maximum value is 1000; values above 1000 will be coerced to
 *  1000.
 */
// const pageSize = 1234
/**
 *  Optional. A page token, received from a previous `ListGlossaries` call.
 *  Provide this to retrieve the subsequent page.
 *  When paginating, all other parameters provided to `ListGlossaries` must
 *  match the call that provided the page token.
 */
// const pageToken = 'abc123'
/**
 *  Optional. Filter expression that filters Glossaries listed in the response.
 *  Filters on proto fields of Glossary are supported.
 *  Examples of using a filter are:
 *    - `display_name="my-glossary"`
 *    - `categoryCount=1`
 *    - `termCount=0`
 */
// const filter = 'abc123'
/**
 *  Optional. Order by expression that orders Glossaries listed in the
 *  response. Order by fields are: `name` or `create_time` for the result. If
 *  not specified, the ordering is undefined.
 */
// const orderBy = 'abc123'

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callListGlossaries() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = dataplexClient.listGlossariesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListGlossaries();

Python

Python

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_list_glossaries():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.ListGlossariesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_glossaries(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Ruby

Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/dataplex/v1"

##
# Snippet for the list_glossaries call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#list_glossaries.
#
def list_glossaries
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::ListGlossariesRequest.new

  # Call the list_glossaries method.
  result = client.list_glossaries request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::Glossary.
    p item
  end
end

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

Modifica un glossario

Puoi modificare il nome e la descrizione di un glossario.

Console

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

   Vai a Glossari

2. Fai clic sul glossario 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?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Elimina un glossario

Prima di poter eliminare un glossario, devi prima eliminare tutte le categorie e i termini nel glossario.

Console

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

   Vai a Glossari

2. Fai clic sul glossario che vuoi eliminare.

3. Fai clic su Elimina e poi conferma quando richiesto.

C#

C#

Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog C#.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedBusinessGlossaryServiceClientSnippets
{
    /// <summary>Snippet for DeleteGlossary</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void DeleteGlossaryRequestObject()
    {
        // Create client
        BusinessGlossaryServiceClient businessGlossaryServiceClient = BusinessGlossaryServiceClient.Create();
        // Initialize request argument(s)
        DeleteGlossaryRequest request = new DeleteGlossaryRequest
        {
            GlossaryName = GlossaryName.FromProjectLocationGlossary("[PROJECT]", "[LOCATION]", "[GLOSSARY]"),
            Etag = "",
        };
        // Make the request
        Operation<Empty, OperationMetadata> response = businessGlossaryServiceClient.DeleteGlossary(request);

        // Poll until the returned long-running operation is complete
        Operation<Empty, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Empty result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Empty, OperationMetadata> retrievedResponse = businessGlossaryServiceClient.PollOnceDeleteGlossary(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Empty retrievedResult = retrievedResponse.Result;
        }
    }
}

Vai

Go

Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Go.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewBusinessGlossaryClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.DeleteGlossaryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#DeleteGlossaryRequest.
	}
	op, err := c.DeleteGlossary(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	err = op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
}

Java

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Java.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.dataplex.v1.BusinessGlossaryServiceClient;
import com.google.cloud.dataplex.v1.DeleteGlossaryRequest;
import com.google.cloud.dataplex.v1.GlossaryName;
import com.google.protobuf.Empty;

public class SyncDeleteGlossary {

  public static void main(String[] args) throws Exception {
    syncDeleteGlossary();
  }

  public static void syncDeleteGlossary() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (BusinessGlossaryServiceClient businessGlossaryServiceClient =
        BusinessGlossaryServiceClient.create()) {
      DeleteGlossaryRequest request =
          DeleteGlossaryRequest.newBuilder()
              .setName(GlossaryName.of("[PROJECT]", "[LOCATION]", "[GLOSSARY]").toString())
              .setEtag("etag3123477")
              .build();
      businessGlossaryServiceClient.deleteGlossaryAsync(request).get();
    }
  }
}

Node.js

Node.js

Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Node.js.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The name of the Glossary to delete.
 *  Format:
 *  projects/{project_id_or_number}/locations/{location_id}/glossaries/{glossary_id}
 */
// const name = 'abc123'
/**
 *  Optional. The etag of the Glossary.
 *  If this is provided, it must match the server's etag.
 *  If the etag is provided and does not match the server-computed etag,
 *  the request must fail with a ABORTED error code.
 */
// const etag = 'abc123'

// Imports the Dataplex library
const {BusinessGlossaryServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new BusinessGlossaryServiceClient();

async function callDeleteGlossary() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const [operation] = await dataplexClient.deleteGlossary(request);
  const [response] = await operation.promise();
  console.log(response);
}

callDeleteGlossary();

Python

Python

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Python.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_delete_glossary():
    # Create a client
    client = dataplex_v1.BusinessGlossaryServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.DeleteGlossaryRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_glossary(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Knowledge Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Knowledge Catalog Ruby.

Per eseguire l'autenticazione in Knowledge Catalog, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/dataplex/v1"

##
# Snippet for the delete_glossary call in the BusinessGlossaryService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client#delete_glossary.
#
def delete_glossary
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::BusinessGlossaryService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::DeleteGlossaryRequest.new

  # Call the delete_glossary method.
  result = client.delete_glossary request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

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

Crea e gestisci 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 console Google Cloud , vai alla pagina Glossari di Knowledge 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, Knowledge 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 della 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 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) Aggiungi 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

Crea una categoria nidificata

Un glossario aziendale può avere un massimo di tre livelli di categorie nidificate, escluso il livello del glossario principale.

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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.

Visualizza le categorie che appartengono a un glossario

Console

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

   Vai a Glossari

2. Per visualizzare le categorie in un glossario, espandi il glossario.

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

Modifica 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 console Google Cloud , vai alla pagina Glossari di Knowledge 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

Elimina una categoria

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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

Crea e gestisci i termini

Le sezioni seguenti descrivono come creare, visualizzare, accedere, modificare ed eliminare i termini.

Crea un termine in un glossario aziendale

Un glossario aziendale può contenere un massimo di 5000 termini.

Console

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

   Vai a Glossari

2. Per creare un termine a livello di glossario, seleziona il glossario in cui vuoi creare un termine, quindi 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 data steward, i proprietari dei dati o i proprietari dei domini di dati. Quindi, fai clic su Salva.

REST

Quando crei un termine, Knowledge 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 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 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 per il 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 console Google Cloud , vai alla pagina Glossari di Knowledge 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 data steward, i proprietari dei dati o i proprietari dei domini di dati. Quindi, fai clic su Salva.

REST

Quando crei un termine, Knowledge 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 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 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 per il 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

Aggiungi un aspetto a un termine

Puoi aggiungere aspetti ai termini per fornire contesto o metadati aggiuntivi.

Console

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

   Vai a Glossari

2. Espandi il glossario e fai clic sul termine a cui vuoi aggiungere un aspetto.

3. Nella sezione Aspetti, fai clic su Aggiungi.

4. Cerca l'aspetto, fornisci i dettagli relativi e poi fai clic su Salva.

REST

I termini del glossario sono voci. Per collegare un aspetto, applica una patch alla risorsa della voce. Il gruppo di voci per i glossari è @dataplex.

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_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=aspects\&aspect_keys=ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID --data @- << EOF
{
 "aspects": {
   "ASPECT_PROJECT_ID.ASPECT_LOCATION_ID.ASPECT_TYPE_ID": {
     "aspect_type": "projects/ASPECT_PROJECT_ID/locations/ASPECT_LOCATION_ID/aspectTypes/ASPECT_TYPE_ID",
     "data": {
       "sensitivity": "HIGH",
       "data_owner": "[e-mail]"
     }
   }
 }
}
EOF

Sostituisci quanto segue:

• PROJECT_NUMBER: il numero del progetto contenente il termine del glossario.
• LOCATION_ID: la località del termine del glossario.
• GLOSSARY_ID: l'ID del glossario contenente il termine.
• TERM_ID: l'ID del termine a cui collegare l'aspetto.
• ASPECT_PROJECT_ID: l'ID del progetto contenente il tipo di aspetto.
• ASPECT_LOCATION_ID: la località del tipo di aspetto.
• ASPECT_TYPE_ID: l'ID del tipo di aspetto.

Visualizza i termini in un glossario o in una categoria

Console

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

   Vai a Glossari

2. Per visualizzare i termini di 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

Visualizza i dettagli di un termine

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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

Modifica un termine

Puoi modificare il nome, la descrizione, la panoramica, i contatti e l'elemento principale di un termine.

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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

Elimina un termine

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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

Gestisci sinonimi e 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, anche earnings diventa un sinonimo di profit.

Crea link di sinonimi tra i termini

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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 da collegare.

   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 sinonimo. Se entrambi i termini si trovano nello stesso progetto, questo valore corrisponde al numero di progetto del primo termine.
• TERM2_LOCATION_ID: l'ID località del glossario che contiene il secondo termine. Se entrambi i termini si trovano nella stessa località, questo valore corrisponde all'ID località 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 corrisponde 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 Knowledge Catalog. Il link della voce è la relazione tra i termini sinonimi.

Crea link correlati tra i termini

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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 da collegare.

   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 per il 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 per il secondo termine che vuoi collegare come termine correlato. Se entrambi i termini si trovano nello stesso progetto, questo valore corrisponde al numero di progetto del primo termine.
• TERM2_LOCATION_ID: l'ID località del glossario che contiene il secondo termine. Se entrambi i termini si trovano nella stessa località, questo valore corrisponde all'ID località 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 corrisponde 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 Knowledge Catalog. Il link della voce è la relazione tra i termini correlati.

Cerca i link dei sinonimi di un termine

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/TERM_PROJECT_ID/locations/SYNONYM_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/synonym&page_size=10

Sostituisci quanto segue:

• TERM_PROJECT_ID: l'ID progetto del termine di cui stai cercando i link dei sinonimi.
• TERM_PROJECT_NUMBER: il numero di progetto del termine di cui stai cercando i link dei sinonimi.
• SYNONYM_LINKS_LOCATION_ID: l'ID località in cui stai cercando i link dei sinonimi.
• TERM_LOCATION_ID: l'ID località del termine.
• TERM_GLOSSARY_ID: l'ID del glossario che contiene il termine.
• TERM_ID: l'ID del termine.

Nota: per recuperare le pagine successive, aggiungi &page_token=PAGE_TOKEN alla richiesta. Sostituisci PAGE_TOKEN con il valore del token di pagina che hai ricevuto dalla risposta lookupEntryLinks precedente.

Cerca i link correlati per un termine

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/TERM_PROJECT_ID/locations/RELATED_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/related&page_size=10

Sostituisci quanto segue:

• TERM_PROJECT_ID: l'ID progetto del termine di cui stai cercando i link correlati.
• TERM_PROJECT_NUMBER: il numero di progetto del termine di cui stai cercando i link correlati.
• RELATED_LINKS_LOCATION_ID: l'ID località in cui stai cercando i link correlati.
• TERM_LOCATION_ID: l'ID località del termine.
• TERM_GLOSSARY_ID: l'ID del glossario che contiene il termine.
• TERM_ID: l'ID del termine.

Nota: per recuperare le pagine successive, aggiungi &page_token=PAGE_TOKEN alla richiesta. Sostituisci PAGE_TOKEN con il valore del token di pagina che hai ricevuto dalla risposta lookupEntryLinks precedente.

Rimuovi i collegamenti tra sinonimi e termini correlati

Console

1. Nella console Google Cloud , vai alla pagina Glossari di Knowledge 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 collegamenti tra termini correlati, fai clic su Modifica accanto a Termini correlati. Elimina i termini correlati e fai clic su Chiudi.

4. Per eliminare i link tra i sinonimi, fai clic su Modifica accanto a Termini sinonimi. Elimina i sinonimi e fai clic su Chiudi.

REST

1. Cerca i link di ingresso per trovare l'ID collegamento del link che vuoi eliminare. Per saperne di più, consulta Cerca i link dei sinonimi di un termine o Cerca i link correlati di un termine.

2. Elimina il link inviando la seguente richiesta DELETE:

   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

Gestisci i link tra i termini e gli asset di dati

Puoi collegare i termini agli asset di dati o alle colonne degli asset di dati. Ad esempio, puoi collegare i termini ai set di dati BigQuery e alle tabelle del catalogo Iceberg REST.

Collega i termini a un asset di dati

Console

1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

   Vai alla Ricerca

2. Cerca l'asset di dati (ad esempio un set di dati, un file o una tabella) a cui vuoi collegare un termine, quindi fai clic sull'asset.

3. Nella pagina dell'asset di dati, esegui una delle seguenti operazioni:

   • Per collegare i termini a un asset, nella scheda Dettagli, nella sezione Termini del glossario, fai clic su Aggiungi. 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, quindi fai clic su Aggiungi termine aziendale. Cerca e seleziona i termini, quindi fai clic su Chiudi.

Python

from google.cloud import dataplex_v1

def attach_term_to_asset(
    project_id: str,
    location: str,
    entry_group_id: str,
    entry_link_id: str,
    source_entry_name: str,
    target_term_name: str,
) -> dataplex_v1.EntryLink:
    """Creates an entry link attaching a glossary term to a data asset."""
    client = dataplex_v1.CatalogServiceClient()
    parent_group = (
        f"projects/{project_id}/locations/{location}/"
        f"entryGroups/{entry_group_id}"
    )

    entry_link = dataplex_v1.EntryLink(
        entry_link_type=(
            "projects/dataplex-types/locations/global/"
            "entryLinkTypes/definition"
        ),
        entry_references=[
            dataplex_v1.EntryLink.EntryReference(
                name=source_entry_name, type_="SOURCE"
            ),
            dataplex_v1.EntryLink.EntryReference(
                name=target_term_name, type_="TARGET"
            ),
        ],
    )

    return client.create_entry_link(
        parent=parent_group,
        entry_link_id=entry_link_id,
        entry_link=entry_link,
    )

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 eseguito il collegamento
• ENTRY_LOCATION_ID: l'ID località dell'asset di dati a cui viene eseguito il collegamento
• ENTRY_GROUP_ID: il gruppo di voci dell'asset di dati a cui viene eseguito il collegamento
• ENTRY_LINK_ID: un ID per il link tra il termine e la voce di Knowledge Catalog che rappresenta l'asset di dati.
• TERM_PROJECT_NUMBER: il numero di progetto per il termine da collegare.

Collega i termini a una colonna in uno schema di voci

Console

1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

   Vai alla Ricerca

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 che vuoi collegare e fai clic sul termine per collegarlo.

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",
     "path": "Schema.COLUMN_NAME",
     "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 eseguito il collegamento
• ENTRY_LOCATION_ID: l'ID località dell'asset di dati a cui viene eseguito il collegamento
• ENTRY_GROUP_ID: il gruppo di voci dell'asset di dati a cui viene eseguito il collegamento
• ENTRY_LINK_ID: un ID per il link tra il termine e la voce del Knowledge Catalog che rappresenta l'asset di dati
• TERM_PROJECT_NUMBER: il numero di progetto per il termine da collegare
• COLUMN_NAME: la colonna a cui vuoi collegare il termine

Associa un termine a più asset di dati o colonne

Puoi collegare un singolo termine del glossario a più asset di dati o colonne contemporaneamente. Puoi selezionare fino a 20 risorse o colonne in una singola operazione.

Console

Per collegare un termine a più risorse, segui questi passaggi:

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

   Vai a Glossari

2. Nell'elenco Glossari, espandi il glossario che contiene il termine che vuoi collegare.

3. Fai clic sul termine.

4. Nella sezione Voci correlate, fai clic su Aggiungi.

5. Nella finestra di dialogo Collega voci correlate, completa i seguenti passaggi:

   1. Trova le risorse o le colonne da collegare. Per restringere i risultati di ricerca, utilizza Filtra per eseguire la ricerca in base al nome della risorsa, al tipo di risorsa o al nome della colonna.

      Ad esempio, per trovare una colonna denominata sample-column in una tabella BigQuery denominata sample-table all'interno di un progetto con l'ID sample-project, utilizza la seguente query:

      project id:sample-project
      Resource Name:sample-table
      Column Name:sample-column
      

      Puoi inserire stringhe parziali per trovare gli asset corrispondenti.

   2. Seleziona gli asset di dati e le colonne da allegare.

   3. Per esaminare le selezioni prima di aggiungerle, fai clic sul pulsante di attivazione/disattivazione Mostra risorse selezionate.

   4. Fai clic su Aggiungi.

6. Per verificare le risorse e le colonne appena collegate, vai alla sezione Voci correlate della pagina dei dettagli del termine.

Cerca gli asset di dati collegati a un termine

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/TERM_PROJECT_ID/locations/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=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&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=TARGET&page_size=10

Sostituisci quanto segue:

• TERM_PROJECT_ID: l'ID progetto del termine di cui stai cercando i link di definizione.
• TERM_PROJECT_NUMBER: il numero di progetto del termine di cui stai cercando i link di definizione.
• DEFINITION_LINKS_LOCATION_ID: l'ID località in cui stai cercando i link di definizione.
• TERM_LOCATION_ID: l'ID località del termine.
• TERM_GLOSSARY_ID: l'ID del glossario che contiene il termine.
• TERM_ID: l'ID del termine.

Nota: le colonne collegate al termine vengono restituite nel campo path.

Per recuperare le pagine successive, aggiungi &page_token=PAGE_TOKEN alla richiesta. Sostituisci PAGE_TOKEN con il valore del token di pagina ricevuto dalla risposta lookupEntryLinks precedente.

Cerca i termini collegati a un asset di dati

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/DEFINITION_LINKS_LOCATION_ID:lookupEntryLinks?entry=projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID&entry_link_types=projects/dataplex-types/locations/global/entryLinkTypes/definition&entry_mode=SOURCE&page_size=10

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto dell'asset di dati di cui stai cercando i link di definizione.
• PROJECT_NUMBER: il numero di progetto dell'asset di dati di cui stai cercando i link di definizione.
• DEFINITION_LINKS_LOCATION_ID: l'ID località in cui stai cercando i link di definizione.
• ENTRY_LOCATION_ID: l'ID località dell'asset di dati.
• ENTRY_GROUP_ID: l'ID del gruppo di voci per l'asset di dati.
• ENTRY_ID: l'ID dell'asset di dati.

Nota: le colonne collegate al termine all'interno di un asset di dati vengono restituite nel campo path.

Per recuperare le pagine successive, aggiungi &page_token=PAGE_TOKEN alla richiesta. Sostituisci PAGE_TOKEN con il valore del token di pagina che hai ricevuto dalla risposta lookupEntryLinks precedente.

Rimuovi i termini da un asset di dati

Console

1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

   Vai alla Ricerca

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 sull'asset.

3. Nella pagina dell'asset di dati, esegui una delle seguenti operazioni:

   • Per rimuovere un termine da un asset, nella scheda Dettagli, nella sezione Termini del glossario, fai clic sul termine. Poi 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

Trova 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 console Google Cloud , vai alla pagina Glossari di Knowledge 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 fornito.
   • Parent: restituisce i termini il cui nome o la cui descrizione del glossario principale corrisponde al testo fornito. Ad esempio, parent:Finance restituisce i termini collegati al glossario principale il cui nome o la cui descrizione contiene la frase Finance.
   • Sinonimo: restituisce l'elenco dei termini con un sinonimo il cui nome o ID contiene il testo fornito. Ad esempio, synonym:Profit restituisce i termini che hanno un sinonimo il cui nome o ID contiene la frase profit.
   • Contatto: restituisce i termini in cui il data steward è elencato come contatto. Ad esempio, contact:[e-mail] restituisce le voci collegate a termini con uno stewardship dei dati corrispondente a [e-mail].

REST

Per trovare glossari, termini e asset di dati collegati utilizzando l'API REST, devi registrarti per l'anteprima.

Cerca asset di dati collegati ai termini

Console

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

   Vai a Glossari

2. Nella pagina Glossari, utilizza la barra dei filtri per inserire una query di ricerca testuale in formato libero. Viene restituito un elenco di corrispondenze nei nomi di glossari, categorie e 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 Knowledge Catalog, fai clic sulla voce.

REST

Per trovare glossari, termini e asset di dati collegati utilizzando l'API REST, devi registrarti per l'anteprima.

Importa glossari e link tra termini e termini o asset di dati

Per importare glossari e link da un altro strumento di catalogazione o per aggiornare i tuoi glossari in Knowledge 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 del 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 i termini e gli 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 Dataplex nel formato dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

3. (Facoltativo) Ottieni 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) Ottieni 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 di dati o le colonne.

   Per creare un link tra i termini del glossario e gli asset di dati, esegui il job di importazione per ogni gruppo di voci a cui appartiene la voce dell'asset di dati. Tutti i link di definizione delle voci vengono creati in questo gruppo di voci.

   Nota: assicurati che il file di importazione nel bucket Cloud Storage contenga un file per i link in un gruppo di voci. Per creare un link tra un termine e una voce per l'asset di dati in un altro gruppo di voci, fornisci un nuovo file nel bucket Cloud Storage.

   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 2025, il glossario aziendale di Knowledge Catalog verrà fatturato allo stesso modo del prezzo dello spazio di archiviazione dei metadati. Consulta i prezzi di archiviazione dei metadati di Knowledge Catalog.

Passaggi successivi

• Scopri come stabilire un contesto dei dati di base.