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 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 dei sinonimi.
• Termini correlati. Specifica i link tra termini concettualmente correlati tra loro, ma con significati diversi. Consulta la sezione 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 un rendimento ottimale 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 progetto:
  • dataplex.glossaries.list su sconosciuto

  • 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 su sconosciuto
    • Creare, cercare ed eliminare i link tra termini sinonimi nel progetto

  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 eliminare tutte le categorie e i termini al suo interno.

  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 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, se 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 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 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 di 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 link tra i 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 per un termine o Cerca i link correlati per 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 Iceberg REST Catalog.

  Collega i termini a un asset di dati

  Console

  1. Nella console Google Cloud , vai alla pagina 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 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 di 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 un'unica 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 cercare per nome della risorsa, tipo di risorsa o 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 alle definizioni.
  • 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 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 dei glossari 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.
     • Synonym: restituisce l'elenco di 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 un data steward corrispondente a [e-mail].

  REST

  Per trovare glossari, termini e asset di dati collegati utilizzando l'API REST, consulta projects.locations.searchEntries.

  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, consulta projects.locations.searchEntries.

  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 dei prezzi dello spazio di archiviazione dei metadati. Consulta i prezzi per l'archiviazione dei metadati di Knowledge Catalog.

  Passaggi successivi

  • Scopri come stabilire un contesto dei dati di base.