Gestire gli aspetti e arricchire i metadati

I metadati sono fondamentali per organizzare e comprendere le risorse di dati. Ad esempio, i settori regolamentati devono proteggere le informazioni che consentono l'identificazione personale (PII) come nomi, indirizzi e numeri di documenti di identità ufficiali. Questi dati possono verificarsi in numerose istanze nei sistemi di dati distribuiti. Dataplex Universal Catalog può aiutarti a scoprire e catalogare rapidamente le tue risorse di dati distribuite. Puoi quindi classificare i dati come PII.

Arricchendo le voci di dati con un contesto significativo, puoi rendere i tuoi dati più facilmente individuabili e utili. Dataplex Universal Catalog consente di fornire il contesto tramite:

• Tipo di aspetto: un modello JSON che definisce i dati correlati. Ad esempio, per le informazioni sulla conformità, potresti avere la classificazione delle PII e la conformità al GDPR.
• Aspetto: un'istanza di un tipo di aspetto. Ad esempio, {"pii_classification": "confidential", "gdpr_compliant": true}. Puoi applicare un aspetto a un'intera tabella o a una singola colonna della tabella.

Una volta classificati i dati, puoi applicare criteri di qualità o accesso ai dati.

Per saperne di più, consulta Informazioni sulla gestione dei metadati in Dataplex Universal Catalog.

Suggerimento: se è la prima volta che utilizzi i metadati di Dataplex Universal Catalog, ti consigliamo di seguire la guida rapida: aggiungi metadati a una tabella BigQuery.

Aspetti

Gli aspetti consentono di acquisire metadati all'interno delle voci per fornire un contesto significativo. Puoi utilizzare gli aspetti per memorizzare:

• Metadati aziendali: informazioni che forniscono il contesto aziendale, ad esempio la classificazione dei dati.

• Metadati tecnici: dettagli tecnici sull'asset di dati, ad esempio il suo schema.

• Metadati derivati dai dati: informazioni generate dai dati stessi, ad esempio statistiche di una tabella BigQuery.

Gli aspetti sono considerati parti della risorsa di voce e non risorse separate. Quando modifichi un aspetto, devi modificare la voce che lo contiene.

Puoi specificare gli aspetti a livello di voce per descrivere una voce o a livello di colonna per descrivere una colonna in una voce.

Ogni aspetto è un'istanza di un tipo di aspetto. Un tipo di aspetto definisce un modello per i relativi aspetti. Ogni tipo di aspetto contiene un insieme di campi. Quando crei gli aspetti, devi fornire i valori per questi campi.

Per una determinata voce, può essere associato al massimo un aspetto per tipo di aspetto. Puoi avere più aspetti associati alle colonne di inserimento per tipo di aspetto.

Nota: la creazione e l'utilizzo di aspetti in voci in cui il tipo di aspetto e la voce si trovano in organizzazioni Google Cloud diverse non sono supportati.

Categorie di aspetti

Gli aspetti sono suddivisi nelle seguenti categorie:

• Aspetti obbligatori: aspetti obbligatori al momento della creazione di una voce. Questi aspetti sono definiti dal tipo di voce di una determinata voce. Tutte le voci appartenenti a un tipo di voce devono sempre avere tutti gli aspetti obbligatori definiti da quel tipo di voce.

  Dataplex Universal Catalog gestisce gli aspetti richiesti (ad esempio lo schema) per le voci di sistema.

  Tieni presente quanto segue:

  • Puoi associare gli aspetti richiesti solo alle voci e non alle colonne di una voce.

  • Non puoi eliminare gli aspetti obbligatori da una voce.

  • Puoi leggere gli aspetti richiesti delle voci di sistema, ma non puoi modificarli.

  • Gli aspetti dei dati non possono essere aspetti obbligatori.

• Aspetti facoltativi: puoi associare aspetti facoltativi alle voci o alle colonne delle voci. Puoi compilare gli aspetti facoltativi al momento della creazione della voce o in un secondo momento aggiornandola.

  Puoi eliminare gli aspetti facoltativi dopo averli compilati.

Aspetti dei dati

Gli aspetti possono contenere informazioni derivate dai dati, ad esempio i risultati del profilo dei dati o query di esempio. Questi sono chiamati aspetti dei dati.

Tipi di aspetto

I tipi di aspetto sono risorse riutilizzabili che forniscono modelli per gli aspetti.

Categorie di tipi di aspetto

I tipi di aspetto sono suddivisi in tipi di aspetto personalizzati e di sistema.

Tipi di aspetto personalizzati

I tipi di aspetto che crei in Dataplex Universal Catalog sono chiamati tipi di aspetto personalizzati.

I tipi di aspetto personalizzati possono essere globali o regionali. Puoi creare tipi di aspetti personalizzati in una posizione regionale specifica (ad esempio us-central1) o come risorsa global. La posizione di un tipo di aspetto influisce sull'ambito della sua applicabilità e determina con quali voci può essere utilizzato:

• Tipi di aspetto globali: possono essere utilizzati per creare aspetti per le voci in qualsiasi regione. Scegli un tipo di aspetto global se devi applicare la stessa struttura alle voci in più regioni, in quanto devi definirla una sola volta. Poiché la definizione di un tipo di aspetto globale viene replicata in tutte le regioni, questa opzione potrebbe non essere adatta se lo schema del tipo di aspetto stesso contiene informazioni sensibili o se è richiesta una residenza dei dati rigorosa per tutti i componenti dei metadati.
• Tipi di aspetto regionali: possono essere utilizzati solo per creare aspetti per le voci che si trovano nella stessa regione del tipo di aspetto. Ad esempio, un tipo di aspetto creato in us-central1 può essere utilizzato solo con le voci in us-central1. Scegli una località regionale se un tipo di aspetto è pertinente solo per le voci in una regione specifica o per garantire che la definizione del tipo di aspetto risieda all'interno della regione selezionata, il che può contribuire a soddisfare i requisiti di sovranità e conformità dei dati. Se utilizzi tipi di aspetti regionali ma hai bisogno della stessa struttura in più regioni, devi creare e gestire definizioni di tipi di aspetti separate in ogni regione.

Per saperne di più, consulta Vincoli di progetto e località.

Tipi di aspetto del sistema

I tipi di aspetto forniti, utilizzati e gestiti da Dataplex Universal Catalog sono chiamati tipi di aspetto di sistema. I tipi di aspetto di sistema sono sempre globali, pertanto possono essere utilizzati in qualsiasi regione. I tipi di aspetti di sistema vengono archiviati in un progetto gestito da Google con il numero di progetto 655216118709. Ad esempio, projects/655216118709/locations/global/aspectTypes/schema.

Ogni tipo di aspetto definito dal sistema e ogni tipo di voce definito dal sistema ha le proprie autorizzazioni IAM. Per saperne di più, consulta Autorizzazioni IAM per i tipi di aspetto e di voce di sistema.

I tipi di aspetto di sistema sono ulteriormente suddivisi in riutilizzabili e limitati. La tabella seguente descrive le categorie di tipi di aspetti di sistema e l'elenco dei tipi di aspetti forniti da Dataplex Universal Catalog per ciascuna categoria:

Categoria del tipo di aspetto di sistema	Descrizione	Tipi di aspetto forniti da Dataplex Universal Catalog
Tipo di aspetto di sistema riutilizzabile	Puoi utilizzare questi tipi di aspetto per creare o modificare gli aspetti.	contacts data-profile data-quality-scorecard generic overview schema usage
Tipo di aspetto di sistema con limitazioni	Dataplex Universal Catalog gestisce questi tipi di aspetto. Puoi leggere gli aspetti in questi tipi di aspetti, ma non puoi crearli o modificarli.	Inclusi a titolo esemplificativo: analytics-hub aspecttype-aspect bigquery-dataset bigquery-table cloudsql-database cloudsql-instance cloudsql-table entrygroup-aspect entrytype-aspect sensitive-data-protection-profile storage storage-bucket storage-folder

Prima di iniziare

Prima di creare e gestire tipi e aspetti, completa le attività descritte in questa sezione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire tipi di aspetto e aspetti, chiedi all'amministratore di concederti i seguenti ruoli IAM sulla risorsa:

• Set completo di autorizzazioni per le risorse di metadati nel Catalogo universale Dataplex, inclusi tipi di aspetto e aspetti dei dati: Amministratore catalogo Dataplex (roles/dataplex.catalogAdmin)
• Crea e gestisci risorse di metadati nel Catalogo universale Dataplex, inclusi tipi di aspetto e aspetti dei dati: Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• Set completo di autorizzazioni sui tipi di aspetto personalizzati (ad eccezione delle autorizzazioni per utilizzare i tipi di aspetto per creare o modificare le voci): Dataplex Aspect Type Owner (roles/dataplex.aspectTypeOwner)
• Visualizza i tipi di aspetto e le norme IAM associati: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• Utilizza i tipi di aspetto per creare e modificare le voci con gli aspetti corrispondenti: Dataplex Aspect Type User (roles/dataplex.aspectTypeUser)
• Aggiungi aspetti di alcuni tipi di aspetti di sistema, come schema, overview, contacts: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, consulta Ruoli IAM di Dataplex Universal Catalog.

Abilita l'API

Abilita l'API Dataplex nel tuo progetto Dataplex Universal Catalog.

Abilita l'API

Creare un tipo di aspetto personalizzato

Console

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

Vai al Catalog (catalogo)

1. Fai clic sulla scheda Tipi di aspetti e modelli di tag > Personalizzato.

2. Fai clic su Crea tipo di aspetto.

3. Nella finestra Crea tipo di aspetto, inserisci quanto segue:

4. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome per il tipo di aspetto.

   1. Nel campo ID tipo di aspetto, inserisci un ID univoco per il tipo di aspetto.
   2. (Facoltativo) Nel campo Descrizione, inserisci una descrizione del tipo di aspetto.
   3. Nel campo Località, seleziona una località per il tipo di aspetto. Non puoi modificare la posizione di un tipo di aspetto dopo averlo creato. Per comprendere l'impatto della scelta di una posizione globale rispetto a una regionale, consulta la sezione Tipi di asset personalizzati.

5. (Facoltativo) Definisci un modello per il tipo di aspetto.

Nella sezione Template, fai clic su Aggiungi campo. Nella sezione Nuovo campo, inserisci quanto segue:

1. Nel campo Nome, inserisci un nome.

   1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato.
   2. (Facoltativo) Nel campo Descrizione, inserisci una descrizione.

   3. Nel campo Tipo, seleziona un tipo di dati per il campo. In base alla tua selezione, vengono visualizzati il successivo insieme di campi e opzioni:

              *   If you selected **Text** as the data type, follow
                  these steps:
      

2. Nel campo Tipo di testo, seleziona il tipo di testo. 1. Nel campo Valori di testo, fornisci un suggerimento per il campo di testo. Per farlo, fai clic su Aggiungi valore e inserisci il suggerimento. Puoi aggiungere più suggerimenti per un campo di testo. 1. Fai clic su Fine.

               *   If you selected **Enum** as the data type, add an
                   enum value:
   

3. Fai clic su Aggiungi un valore enum. 1. Nel campo Valore, inserisci un valore enum. Puoi aggiungere più valori enum. 1. Fai clic su Fine.

               *   If you selected **Array** as the data type, in the
                   **Array item** section, define the types of items to
                   be present in the array:
   

4. Fai clic su Aggiungi elemento array. 1. Nel campo Nome, inserisci un nome per gli elementi dell'array. 1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per gli elementi dell'array. 1. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per gli elementi dell'array. 1. Nel campo Tipo, seleziona un tipo di dati per gli elementi dell'array.

In base alla selezione, vengono visualizzati il successivo insieme di campi e opzioni. Sono simili alle opzioni descritte per i tipi di dati Testo, Enumerazione, Mappa, Array e Record in un'altra parte di questa sezione.

1. Fai clic su Fine.

               *   If you selected **Map** as the data type, in the
                   **Map value** section, define the types of values to
                   be present in the map:
   

2. Fai clic su Aggiungi valore mappa. 1. Nel campo Nome, inserisci un nome per la mappa. 1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per la mappa. 1. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per la mappa. 1. Nel campo Tipo, seleziona un tipo di dati per la mappa.

In base alla selezione, vengono visualizzati il successivo insieme di campi e opzioni. Sono simili alle opzioni descritte per i tipi di dati Testo, Enum, Mappa, Array e Record in un'altra parte di questa sezione.

1. Fai clic su Fine.

               *   If you selected **Record** as the data type, enter
                   the following:
   

2. Nel campo ID record, inserisci un ID univoco che altri campi del record possono utilizzare per fare riferimento a questo record. Consulta la sezione Esempio di utilizzo dei campi ID record e Riferimento record di questo documento. 1. (Facoltativo) Se vuoi aggiungere un riferimento a un altro record di questo modello, utilizza il campo Riferimento al record. Non puoi modificare questa impostazione dopo aver creato il tipo di aspetto. Consulta la sezione Esempio di utilizzo dei campi ID record e Riferimento record di questo documento. 1. Nella sezione Campi record, puoi definire un oggetto complesso con più campi nidificati. Per farlo, fai clic su Aggiungi elemento campo record e specifica quanto segue:

3. Nel campo Nome, inserisci un nome per il campo del record. 1. (Facoltativo) Nel campo Nome visualizzato, inserisci un nome visualizzato per il campo del record. 1. (Facoltativo) Nel campo Descrizione, inserisci una descrizione per il campo del record. 1. Nel campo Tipo, seleziona un tipo di dati.

In base alla selezione, vengono visualizzati il successivo insieme di campi e opzioni. Sono simili alle opzioni descritte in precedenza in questa sezione per i tipi di dati Testo, Enumerazione, Mappa, Array e Record.

1. Fai clic su Fine.

2. Per rendere obbligatorio il campo per un aspetto di questo tipo, seleziona È obbligatorio. Per saperne di più sugli aspetti obbligatori e facoltativi, consulta la sezione Categorie di aspetti di questo documento.

   1. Fai clic su Fine.
   2. Per aggiungere più campi, fai clic su Aggiungi campo e ripeti i passaggi precedenti.

3. (Facoltativo) Nella sezione Etichette, aggiungi etichette arbitrarie alle risorse sotto forma di coppie chiave-valore:

4. Fai clic su Aggiungi etichetta.

   1. Nel campo Chiave, inserisci una chiave.
   2. Nel campo Valore, inserisci un valore per la chiave.
   3. Per aggiungere altre etichette, fai clic su Aggiungi etichetta e ripeti i passaggi.

5. Fai clic su Salva.

gcloud

Per creare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types create.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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 GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for CreateAspectType</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 CreateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        CreateAspectTypeRequest request = new CreateAspectTypeRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            AspectTypeId = "",
            AspectType = new AspectType(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.CreateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType 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<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceCreateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateAspectTypeRequest.
	}
	op, err := c.CreateAspectType(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.CreateAspectTypeRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncCreateAspectType {

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

  public static void syncCreateAspectType() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      CreateAspectTypeRequest request =
          CreateAspectTypeRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setAspectTypeId("aspectTypeId-423030675")
              .setAspectType(AspectType.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.createAspectTypeAsync(request).get();
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.CreateAspectTypeRequest(
        parent="parent_value",
        aspect_type_id="aspect_type_id_value",
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.create_aspect_type(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Ruby.

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_type call in the CatalogService 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::CatalogService::Client#create_aspect_type.
#
def create_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

  # Call the create_aspect_type method.
  result = client.create_aspect_type 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

Per creare un tipo di aspetto personalizzato, utilizza il metodo aspectType.create.

Dopo aver creato un tipo di aspetto personalizzato, puoi aggiungere aspetti alle voci.

Esempio di utilizzo dei campi ID record e Riferimento record

Puoi utilizzare i campi ID record e Riferimento record per i riferimenti ricorsivi. L'esempio seguente mostra come utilizzare questi campi:

Considera un tipo di aspetto denominato Employee, con i seguenti campi:

• Nome (tipo:Text)
• Data di inizio (tipo:Date & time)
• Designazione (tipo:Text)
• Indirizzo attuale (tipo:Record)
• Indirizzo permanente (tipo:Record)

I due campi indirizzo Indirizzo attuale e Indirizzo permanente sono dello stesso tipo di dati Record. Per evitare duplicazioni, puoi impostare i valori di ID record e Riferimento record quando definisci questi campi.

Quando definisci il campo Indirizzo attuale, puoi specificare ID record come address-field. Per Indirizzo permanente, puoi specificare lo stesso valore (address-field) per Riferimento record. Ad esempio:

• Nome (tipo:Text)
• Data di inizio (tipo:Date & time)
• Designazione (tipo:Text)
• Indirizzo attuale (tipo:Record, ID record:address-field)
• Indirizzo permanente (tipo:Record, riferimento record:address-field)

In questo modo, non è necessario duplicare i campi di un altro indirizzo.

Aggiungere aspetti a una voce

Dopo aver creato un tipo di aspetto personalizzato, puoi creare aspetti di quel tipo. Per aggiungere aspetti a una voce, devi aggiornarla, in quanto gli aspetti vengono memorizzati all'interno delle voci.

Tieni presente quanto segue:

• Puoi aggiungere aspetti a una voce o alle colonne di una voce.
• Puoi modificare gli aspetti obbligatori solo per le voci personalizzate. Non puoi eliminare gli aspetti obbligatori.
• Puoi modificare ed eliminare gli aspetti facoltativi sia per le voci personalizzate sia per quelle di sistema.

Nota: quando utilizzi un'CREATE OR REPLACE TABLE istruzione per sostituire una tabella BigQuery, i metadati (inclusi gli aspetti) associati alla tabella originale non vengono applicati alla nuova tabella. Se vuoi che i metadati vengano mantenuti, puoi creare una vista BigQuery per la tabella e aggiungere i metadati alla vista.

Console

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

Vai a Cerca

1. Per Scegli piattaforma di ricerca, seleziona Dataplex Universal Catalog come modalità di ricerca.
2. Cerca la voce a cui vuoi aggiungere aspetti e fai clic sulla voce. Viene visualizzata la pagina dei dettagli della voce.

3. Per aggiungere aspetti alla voce:

   1. Fai clic sulla scheda Dettagli.
   2. Per aggiungere aspetti obbligatori o facoltativi alla voce, nella sezione Tag e aspetti, fai clic su Aggiungi per la rispettiva categoria.
      Non puoi aggiungere aspetti obbligatori se il tipo di voce della voce selezionata non ha aspetti obbligatori definiti.
      
   3. Cerca e seleziona l'aspetto che vuoi aggiungere.
   4. Nella finestra Aggiungi aspetto, inserisci i valori per i campi.

   5. Fai clic su Salva.

   6. Per aggiungere aspetti a una colonna della voce:

   7. Nella pagina dei dettagli della voce, fai clic sulla scheda Schema.

   8. Seleziona le colonne a cui vuoi aggiungere gli aspetti.

   9. Fai clic su Aggiungi aspetto.

   10. Cerca e seleziona l'aspetto che vuoi aggiungere.

   11. Nella finestra Aggiungi aspetto, inserisci i valori per i campi.

   12. Fai clic su Salva.

gcloud

Per aggiungere aspetti a una voce o a una colonna di una voce, utilizza il comando gcloud dataplex entries update.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</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 UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Per aggiungere aspetti all'oggetto della voce, vedi Aspetti.

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

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

Per aggiungere aspetti all'oggetto della voce, vedi Entry.

Java

Java

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

Per eseguire l'autenticazione in Dataplex Universal 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.Aspect;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.EntryName;
import com.google.cloud.dataplex.v1.EntrySource;
import com.google.protobuf.FieldMask;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.util.Map;

public class UpdateEntry {

  public static void main(String[] args) throws Exception {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "MY_PROJECT_ID";
    // Available locations: https://cloud.google.com/dataplex/docs/locations
    String location = "MY_LOCATION";
    String entryGroupId = "MY_ENTRY_GROUP_ID";
    String entryId = "MY_ENTRY_ID";

    Entry createdEntry = updateEntry(projectId, location, entryGroupId, entryId);
    System.out.println("Successfully updated entry: " + createdEntry.getName());
  }

  // Method to update Entry located in projectId, location, entryGroupId and with entryId
  public static Entry updateEntry(
      String projectId, String location, String entryGroupId, String entryId) throws Exception {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (CatalogServiceClient client = CatalogServiceClient.create()) {
      Entry entry =
          Entry.newBuilder()
              .setName(EntryName.of(projectId, location, entryGroupId, entryId).toString())
              .setEntrySource(
                  EntrySource.newBuilder()
                      .setDescription("updated description of the entry")
                      .build())
              .putAllAspects(
                  Map.of(
                      "dataplex-types.global.generic",
                      Aspect.newBuilder()
                          .setAspectType(
                              "projects/dataplex-types/locations/global/aspectTypes/generic")
                          .setData(
                              Struct.newBuilder()
                                  // "Generic" Aspect Type have fields called "type" and "system.
                                  // The values below are a sample of possible options.
                                  .putFields(
                                      "type",
                                      Value.newBuilder()
                                          .setStringValue("updated example value")
                                          .build())
                                  .putFields(
                                      "system",
                                      Value.newBuilder()
                                          .setStringValue("updated example system")
                                          .build())
                                  .build())
                          .build()))
              .build();

      // Update mask specifies which fields will be updated.
      // For more information on update masks, see: https://google.aip.dev/161
      FieldMask updateMask =
          FieldMask.newBuilder().addPaths("aspects").addPaths("entry_source.description").build();
      return client.updateEntry(entry, updateMask);
    }
  }
}

Python

Python

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

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

from google.cloud import dataplex_v1
from google.protobuf import struct_pb2


def update_entry(
    project_id: str, location: str, entry_group_id: str, entry_id: str
) -> dataplex_v1.Entry:
    """Method to update Entry located in project_id, location, entry_group_id and with entry_id"""

    # Initialize client that will be used to send requests across threads. This
    # client only needs to be created once, and can be reused for multiple requests.
    # After completing all of your requests, call the "__exit__()" method to safely
    # clean up any remaining background resources. Alternatively, use the client as
    # a context manager.
    with dataplex_v1.CatalogServiceClient() as client:
        # The resource name of the Entry
        name = f"projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}"
        entry = dataplex_v1.Entry(
            name=name,
            entry_source=dataplex_v1.EntrySource(
                description="updated description of the entry"
            ),
            aspects={
                "dataplex-types.global.generic": dataplex_v1.Aspect(
                    aspect_type="projects/dataplex-types/locations/global/aspectTypes/generic",
                    data=struct_pb2.Struct(
                        fields={
                            # "Generic" Aspect Type have fields called "type" and "system.
                            # The values below are a sample of possible options.
                            "type": struct_pb2.Value(
                                string_value="updated example value"
                            ),
                            "system": struct_pb2.Value(
                                string_value="updated example system"
                            ),
                        }
                    ),
                )
            },
        )

        # Update mask specifies which fields will be updated.
        # For more information on update masks, see: https://google.aip.dev/161
        update_mask = {"paths": ["aspects", "entry_source.description"]}
        return client.update_entry(entry=entry, update_mask=update_mask)


if __name__ == "__main__":
    # TODO(developer): Replace these variables before running the sample.
    project_id = "MY_PROJECT_ID"
    # Available locations: https://cloud.google.com/dataplex/docs/locations
    location = "MY_LOCATION"
    entry_group_id = "MY_ENTRY_GROUP_ID"
    entry_id = "MY_ENTRY_ID"

    updated_entry = update_entry(project_id, location, entry_group_id, entry_id)
    print(f"Successfully updated entry: {updated_entry.name}")

Ruby

Ruby

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

Per eseguire l'autenticazione in Dataplex Universal 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 update_entry call in the CatalogService 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::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

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

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

Per aggiungere aspetti all'oggetto entry, vedi #required_aspects=.

REST

Per aggiungere aspetti a una voce o a una colonna di una voce, utilizza il metodo entry.patch.

La creazione e l'utilizzo di aspetti in una voce in cui il tipo di aspetto e la voce si trovano in organizzazioni Google Cloud diverse non sono supportati.

Allegare aspetti di tipi di aspetto di sistema riutilizzabili

Puoi allegare aspetti di tipi di aspetto di sistema riutilizzabili alle voci.

Puoi modificare un aspetto di un tipo di aspetto riutilizzabile nella console Google Cloud a seconda della sua struttura. I tipi di aspetto che contengono campi nidificati non sono supportati per la modifica nella console Google Cloud . Devi utilizzare lo strumento a riga di comando gcloud o l'API REST per allegare o aggiornare gli aspetti di questo tipo.

Prospetto sulla qualità dei dati

Un prospetto della qualità dei dati è un aspetto che fornisce un riepilogo della qualità dei dati, spesso basato su scansioni della qualità dei dati o altri processi. Puoi allegare una scheda di valutazione della qualità dei dati a una voce per fornire informazioni personalizzate sulla qualità dei dati. Per farlo, allega un aspetto del tipo definito dal sistema data-quality-scorecard.

Il campo data all'interno dell'aspetto data-quality-scorecard può includere i seguenti campi:

• job: (Facoltativo) Un record contenente i dettagli del job che ha generato il prospetto.

  • name: il nome della risorsa del job di qualità dei dati.

  • runTime: il tempo di esecuzione del job di qualità dei dati.

• score: (Facoltativo) Il punteggio di qualità complessivo dei dati. Il punteggio è compreso tra [0, 100].

• status: obbligatorio. Lo stato della scheda di valutazione della qualità dei dati, che indica se ha superato o meno la soglia di qualità (PASS o FAIL).

• dimensions: (Facoltativo) Un array di risultati delle dimensioni. Ogni risultato include:

  • name: il nome della dimensione. Può essere uno dei seguenti valori: ACCURACY, COMPLETENESS, CONSISTENCY, FRESHNESS, UNIQUENESS, VALIDITY, o VOLUME oppure un nome di dimensione personalizzata. I nomi delle dimensioni personalizzate devono utilizzare lettere maiuscole e non superare i 30 caratteri.

  • score: il punteggio complessivo a livello di dimensione, compreso tra 0 e 100.

  • status: lo stato della dimensione, che indica se ha superato o meno la soglia di qualità (PASS o FAIL).

• columns: (Facoltativo) Un array di risultati delle colonne. Ogni risultato include:

  • name: il nome della colonna.

  • score: il punteggio complessivo a livello di colonna, compreso tra 0 e 100.

  • status: lo stato della colonna, che indica se ha superato o meno la soglia di qualità (PASS o FAIL).

  • dimensions: un array di punteggi delle dimensioni per la colonna. Ogni punteggio della dimensione include:

    • name: il nome della dimensione.

    • score: il punteggio per la dimensione, compreso tra 0 e 100.

    • status: lo stato della dimensione per la colonna, che indica se ha superato o meno la soglia di qualità (PASS o FAIL).

Quando esegui il comando per collegare un aspetto, vengono sostituiti tutti i dati esistenti per quell'aspetto specifico. Ad esempio, se aggiorni un prospetto che ha un punteggio di 80 con un nuovo file che mostra un punteggio di 90, il valore 80 viene sovrascritto. Non unisce i dati.

Per allegare un prospetto della qualità dei dati:

gcloud

Per aggiornare gli aspetti di una voce, utilizza il comando gcloud dataplex entries update-aspects.

1. Crea un file JSON (dq-aspect.json) con i seguenti contenuti.

   Nota: la chiave per la mappa degli aspetti segue il formato dataplex-types.global.<ASPECT-TYPE>.

     {
       "dataplex-types.global.data-quality-scorecard": {
         "data": {
           "score": 0.8,
           "status": "PASS",
           "dimensions": [
             {
               "name": "completeness",
               "score": 0.9,
               "status": "PASS"
             },
             {
               "name": "uniqueness",
               "score": 0.7,
               "status": "FAIL"
             }
           ],
           "columns": [
             {
               "name": "col1",
               "score": 0.85,
               "status": "PASS"
             }
           ]
         }
       }
     }
   }
   

2. Esegui questo comando:

     gcloud dataplex entries update-aspects ENTRY_ID
     --location=LOCATION
     --entry-group=ENTRY_GROUP_ID
     --project=PROJECT_ID
     --aspects=dq-aspect.json
   

   Sostituisci le seguenti variabili:

   • ENTRY_ID: l'ID della voce, ad esempio example-entry
   • LOCATION: la posizione della voce, ad esempio us-central1
   • ENTRY_GROUP_ID: l'ID del gruppo di voci, ad esempio example-entry-group
   • PROJECT_ID: l'ID del progetto, ad esempio example-project

REST

Per aggiornare gli aspetti di una voce, utilizza il metodo entry.patch.

1. Crea un file denominato payload.json e incolla al suo interno i contenuti JSON della richiesta.

   
     {
       "aspects": {
         "dataplex-types.global.data-quality-scorecard": {
           "aspectType": "projects/<var>PROJECT_ID</var>/locations/global/aspectTypes/data-quality-scorecard",
           "data": {
             "score": 80,
             "status": "PASS",
             "dimensions": [
               {
                 "name": "completeness",
                 "score": 90,
                 "status": "PASS"
               },
               {
                 "name": "uniqueness",
                 "score": 70,
                 "status": "FAIL"
               }
             ],
             "columns": [
               {
                 "name": "col1",
                 "score": 85,
                 "status": "PASS"
               }
             ]
           }
         }
       }
     }
   

2. Esegui questo comando nel terminale:

    curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d @payload.json \
    "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto, ad esempio example-project
   • LOCATION: la posizione della voce, ad esempio us-central1
   • ENTRY_GROUP_ID: l'ID del gruppo di voci, ad esempio example-entry-group
   • ENTRY_ID: l'ID della voce, ad esempio example-entry

Altri tipi di aspetto riutilizzabili

Sono disponibili anche i seguenti tipi di aspetti del sistema. Puoi allegarli utilizzando gli stessi metodi gcloud o API REST mostrati per la scheda del punteggio di qualità dei dati. Per i tipi di aspetti senza campi nidificati, ad esempio generic, puoi utilizzare la console.

• Contatti. Utilizza il tipo di aspetto contacts per assegnare la proprietà o la gestione. I campi includono:

  • identities (array): un elenco di contatti. Ogni contatto include:
    • role (stringa): il ruolo del contatto (ad esempio owner, steward, producer o admin).
    • name (stringa): il nome del contatto.
    • id (stringa): l'indirizzo email o l'ID del contatto.

  Crea il file payload.json nel seguente modo:

   {
     "aspects": {
       "dataplex-types.global.contacts": {
         "data": {
           "identities": [
             {
               "role": "steward",
               "name": "Jane Doe",
               "id": "[e-mail]"
             }
           ]
         }
       }
     }
   }
  

• Profilo di dati. Utilizza il tipo di aspetto data-profile per acquisire i risultati della profilazione dei dati. Per saperne di più, consulta la sezione Informazioni sulla profilazione dei dati. I campi includono quanto segue:

  • sourceDataInfo (record): informazioni sui dati di origine scansionati per generare il profilo.
    • scope (enum): l'ambito del profilo (PREVIEW, SAMPLED o ALL).
    • scannedRows (int): il numero di righe scansionate.
    • samplingPercentage (double): la percentuale di campionamento utilizzata.
  • fields (mappa): una mappa dei nomi delle colonne e dei relativi profili dei dati, incluse metriche come valori uniqueness, nullness, topN e statistiche specifiche per tipo per le colonne numeric, string, datetime e array.

  Crea il file payload.json nel seguente modo:

   {
     "aspects": {
       "dataplex-types.global.data-profile": {
         "data": {
           "sourceDataInfo": {
           "scope": "ALL",
           "scannedRows": 100
         },
         "fields": {
           "col1": {
             "nullness": 0.0,
             "uniqueness": 0.1,
        "string": {
          "length": {
            "min": 1,
            "max": 20,
            "avg": 12.54
          }
        }
           }
         }
       }
     }
   }}
  

• Generico. Utilizza il tipo di aspetto generic per le informazioni generiche sulla voce. I campi includono:

  • type (stringa): un campo a formato libero per memorizzare un tipo specificato dall'utente.
  • system (stringa): il sistema della voce personalizzata.

  Crea il file payload.json nel seguente modo:

  {
    "aspects": {
      "dataplex-types.global.generic": {
        "data": {
          "type": "custom-type",
          "system": "custom-system"
        }
      }
    }
  }
  

• Panoramica. Utilizza il tipo di aspetto overview per fornire una descrizione in formato RTF. I campi includono:

  • content (stringa): la panoramica della voce, che supporta il formato HTML.
  • links (array): un elenco di link al sistema di origine. Ogni link include:
    • url (stringa): l'URL del link.
    • title (stringa): il titolo del link.

  Crea il file payload.json nel seguente modo:

  {
    "aspects": {
      "dataplex-types.global.overview": {
        "data": {
          "content": "This is a <b>rich text</b> description.",
        "links": [
          {
            "url": "https://example.com",
            "title": "Example Link"
          }
        ]
      }
    }
  }}
  

• Schema. Utilizza il tipo di aspetto schema per descrivere la struttura dei dati.

  • fields (array): un elenco di campi schema. I campi includono:
    • name (stringa): il nome del campo.
    • dataType (stringa): il tipo di dati del campo.
    • metadataType (enum): il tipo di metadati (ad esempio, STRING, BOOLEAN).
    • mode (enum): la modalità del campo (NULLABLE, REQUIRED, REPEATED).
    • description (stringa): una descrizione del campo.

  Crea il file payload.json nel seguente modo:

  {
    "aspects": {
      "dataplex-types.global.schema": {
        "data": {
          "fields": [
          {
            "name": "id",
            "dataType": "string",
            "metadataType": "STRING",
            "mode": "REQUIRED"
          }
        ]
      }
    }
  }}
  

• Utilizzo. Utilizza il tipo di aspetto usage per monitorare le metriche di utilizzo. I campi includono i seguenti:

  • metrics (array): un elenco di metriche di utilizzo. Ogni metrica include:
    • name (stringa): il nome della metrica (ad esempio views, reads).
    • timeSeries (array): un elenco di dati di serie temporali. Ogni elemento include:
      • interval (stringa): l'intervallo di aggregazione (ad esempio, 30d).
      • value (integer): il valore aggregato.
  • refreshTime (datetime): l'ora dell'ultimo aggiornamento delle metriche.

  Crea il file payload.json nel seguente modo:

  {
    "aspects": {
      "dataplex-types.global.usage": {
        "data": {
          "metrics": [
          {
            "name": "views",
            "timeSeries": [
              {
                "interval": "30d",
                "value": 100
              }
            ]
          }
        ],
        "refreshTime": "2025-01-01T12:00:00Z"
      }
    }
  }}
  

Gestire gli aspetti esistenti per una voce

Questa sezione descrive come aggiornare ed eliminare gli aspetti esistenti di una voce.

Aggiorna un aspetto

Puoi modificare gli aspetti facoltativi sia per le voci personalizzate sia per quelle di sistema. Puoi modificare gli aspetti obbligatori solo per le voci personalizzate.

Console

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

Vai a Cerca

1. Per Scegli piattaforma di ricerca, seleziona Dataplex Universal Catalog come modalità di ricerca.
2. Cerca la voce di cui vuoi aggiornare gli aspetti e fai clic sulla voce.

Viene visualizzata la pagina dei dettagli della voce.

1.  Click the **Details** tab.

1. Nella sezione Tag e aspetti, espandi l'aspetto o il tag che vuoi aggiornare e fai clic su Modifica.
2. Nella finestra Modifica aspetto, aggiorna i campi obbligatori.
3. Fai clic su Salva.

gcloud

Per aggiornare gli aspetti di una voce o di una colonna di una voce, utilizza il comando gcloud dataplex entries update.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</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 UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

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

  public static void syncUpdateEntry() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

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

Per eseguire l'autenticazione in Dataplex Universal 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 update_entry call in the CatalogService 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::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

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

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

Per aggiornare gli aspetti di una voce o di una colonna di una voce, utilizza il metodo entry.patch.

Eliminare un aspetto

Nota: puoi eliminare gli aspetti facoltativi di una voce, ma non quelli obbligatori.

Console

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

Vai a Cerca

1. Per Scegli piattaforma di ricerca, seleziona Dataplex Universal Catalog come modalità di ricerca.
2. Cerca la voce di cui vuoi eliminare gli aspetti e fai clic sulla voce.

Viene visualizzata la pagina dei dettagli della voce.

1.  Click the **Details** tab.

1. Nella sezione Tag e aspetti, espandi l'aspetto o il tag che vuoi eliminare, fai clic su Elimina.
2. Fai clic su Conferma.

gcloud

Per eliminare un aspetto per una voce, utilizza il comando gcloud dataplex entries update.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</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 UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

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

  public static void syncUpdateEntry() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

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

Per eseguire l'autenticazione in Dataplex Universal 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 update_entry call in the CatalogService 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::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

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

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

Per eliminare un aspetto per una voce, utilizza il metodo entry.patch.

Gestire i tipi di aspetto

Questa sezione descrive come visualizzare i tipi di aspetto e come aggiornare ed eliminare i tipi di aspetto personalizzati.

Nota: non puoi modificare, eliminare o modificare le autorizzazioni per i tipi di aspetti di sistema.

Visualizza l'elenco dei tipi di aspetti e dei modelli di tag disponibili

Console

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

Vai al Catalog (catalogo)

1. Fai clic sulla scheda Tipi di aspetti e modelli di tag.

Questa pagina elenca tutti i tipi di aspetti di Dataplex Universal Catalog e i modelli di tag di Data Catalog disponibili.

1. Per visualizzare i tipi di aspetti e i modelli di tag personalizzati, fai clic sulla scheda Personalizzato. Nella scheda Personalizzato, la colonna Origine catalogo mostra dove si trova la risorsa: Dataplex Universal Catalog o Data Catalog.

Per visualizzare i tipi di aspetti di sistema, fai clic sulla scheda Sistema.

Per saperne di più sui tipi di aspetti personalizzati e di sistema, consulta la sezione Categorie di tipi di aspetti di questo documento.

1. (Facoltativo) Per visualizzare l'elenco dei tipi di aspetto e dei modelli di tag nel progetto selezionato, fai clic sulla scheda Personalizzato, quindi fai clic sul pulsante di attivazione/disattivazione Mostra da tutti i progetti per disattivarlo.

L'opzione di attivazione/disattivazione Mostra da tutti i progetti è attiva per impostazione predefinita e l'elenco include le risorse Dataplex Universal Catalog dell'organizzazione selezionata e le risorse Data Catalog di tutte le organizzazioni a cui puoi accedere.

Nota :se l'opzione Mostra in tutti i progetti è attiva, non puoi modificare o eliminare direttamente un tipo di aspetto. Fai invece clic sul tipo di aspetto per aprire la pagina Dettagli tipo di aspetto, quindi modificalo o eliminalo.

gcloud

Per elencare tutti i tipi di aspetto disponibili, utilizza il comando gcloud dataplex aspect-types list.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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 GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for ListAspectTypes</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 ListAspectTypesRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        ListAspectTypesRequest request = new ListAspectTypesRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Filter = "",
            OrderBy = "",
        };
        // Make the request
        PagedEnumerable<ListAspectTypesResponse, AspectType> response = catalogServiceClient.ListAspectTypes(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (AspectType 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 (ListAspectTypesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (AspectType 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<AspectType> 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 (AspectType 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;
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.ListAspectTypesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#ListAspectTypesRequest.
	}
	it := c.ListAspectTypes(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.ListAspectTypesResponse)
	}
}

Java

Java

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

Per eseguire l'autenticazione in Dataplex Universal 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.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.ListAspectTypesRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncListAspectTypes {

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

  public static void syncListAspectTypes() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      ListAspectTypesRequest request =
          ListAspectTypesRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .setOrderBy("orderBy-1207110587")
              .build();
      for (AspectType element : catalogServiceClient.listAspectTypes(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_types():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

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

    # Make the request
    page_result = client.list_aspect_types(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Ruby.

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_types call in the CatalogService 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::CatalogService::Client#list_aspect_types.
#
def list_aspect_types
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

  # Call the list_aspect_types method.
  result = client.list_aspect_types 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::AspectType.
    p item
  end
end

REST

Per elencare tutti i tipi di aspetto disponibili, utilizza il metodo aspectTypes.list.

Visualizzare i dettagli di un tipo di aspetto o di un modello di tag

Console

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

Vai al Catalog (catalogo)

1. Fai clic sulla scheda Tipi di aspetti e modelli di tag.

2. Per visualizzare i dettagli di un tipo di aspetto di Dataplex Universal Catalog, fai clic sul tipo di aspetto. Si apre la pagina dei dettagli del tipo di aspetto, in cui puoi accedere a dettagli quali nome visualizzato, ID tipo di aspetto, descrizione, ID progetto, località, etichette, data di creazione e data dell'ultima modifica.

   • Per visualizzare la struttura del tipo di aspetto selezionato, fai clic sulla scheda Modello.
   • Per visualizzare l'elenco delle 10 voci correlate create di recente, fai clic sulla scheda Voci di esempio.
   • Per cercare tutte le voci correlate, fai clic su Mostra tutte le voci correlate nella ricerca. Questo pulsante viene visualizzato solo se è presente almeno una voce correlata.

3. Per visualizzare i dettagli di un modello di tag Data Catalog, fai clic sul modello di tag. La pagina dei dettagli del modello di tag si apre in Data Catalog, dove puoi accedere a dettagli quali nome visualizzato, ID modello, ID progetto, posizione, visibilità ed etichette.

gcloud

Per ottenere i dettagli di un tipo di aspetto, utilizza il comando gcloud dataplex aspect-types describe.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for GetAspectType</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 GetAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        GetAspectTypeRequest request = new GetAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
        };
        // Make the request
        AspectType response = catalogServiceClient.GetAspectType(request);
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.GetAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#GetAspectTypeRequest.
	}
	resp, err := c.GetAspectType(ctx, req)
	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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.AspectType;
import com.google.cloud.dataplex.v1.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.GetAspectTypeRequest;

public class SyncGetAspectType {

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

  public static void syncGetAspectType() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      GetAspectTypeRequest request =
          GetAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .build();
      AspectType response = catalogServiceClient.getAspectType(request);
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_get_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

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

    # Make the request
    response = client.get_aspect_type(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

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

Per eseguire l'autenticazione in Dataplex Universal 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 get_aspect_type call in the CatalogService 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::CatalogService::Client#get_aspect_type.
#
def get_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

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

  # The returned object is of type Google::Cloud::Dataplex::V1::AspectType.
  p result
end

REST

Per ottenere i dettagli di un tipo di aspetto, utilizza il metodo aspectTypes.get.

Aggiornare un tipo di aspetto personalizzato

Puoi aggiornare il nome visualizzato, la descrizione, i campi del modello e le etichette di un tipo di aspetto personalizzato. Non puoi eliminare un campo esistente in un modello.

Non puoi aggiornare l'ID e la posizione del tipo di aspetto dopo averlo creato.

Console

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

Vai al Catalog (catalogo)

1. Fai clic sulla scheda Tipi di aspetti e modelli di tag.
2. Fai clic sul tipo di aspetto che vuoi aggiornare.
3. Nella pagina Dettagli tipo di aspetto, fai clic su Modifica.
4. Modifica il nome visualizzato, la descrizione, i campi del modello e le etichette in base alle tue esigenze.

5. (Facoltativo) Per contrassegnare un campo nel tipo di aspetto come ritirato, segui questi passaggi:

   1. Nella sezione Modello, espandi il campo.
   2. Seleziona Is Deprecated (È obsoleta).
   3. Nel campo Motivo della deprecazione, inserisci un motivo per la deprecazione del campo selezionato.

   4. Fai clic su Fine.

   5. Fai clic su Salva.

gcloud

Per aggiornare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types update.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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 GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateAspectType</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 UpdateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateAspectTypeRequest request = new UpdateAspectTypeRequest
        {
            AspectType = new AspectType(),
            UpdateMask = new FieldMask(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.UpdateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType 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<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceUpdateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateAspectTypeRequest.
	}
	op, err := c.UpdateAspectType(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.UpdateAspectTypeRequest;
import com.google.protobuf.FieldMask;

public class SyncUpdateAspectType {

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

  public static void syncUpdateAspectType() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateAspectTypeRequest request =
          UpdateAspectTypeRequest.newBuilder()
              .setAspectType(AspectType.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.updateAspectTypeAsync(request).get();
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_update_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.UpdateAspectTypeRequest(
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.update_aspect_type(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Ruby.

Per eseguire l'autenticazione in Dataplex Universal 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 update_aspect_type call in the CatalogService 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::CatalogService::Client#update_aspect_type.
#
def update_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

  # Call the update_aspect_type method.
  result = client.update_aspect_type 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

Per aggiornare un tipo di aspetto personalizzato, utilizza il metodo aspectTypes.patch.

Eliminare un tipo di aspetto personalizzato

Attenzione: se elimini un tipo di aspetto personalizzato, vengono eliminati tutti gli aspetti correlati a quel tipo di aspetto.

Console

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

Vai al Catalog (catalogo)

1. Fai clic sulla scheda Tipi di aspetti e modelli di tag.
2. Fai clic sul tipo di aspetto che vuoi eliminare.
3. Nella pagina Dettagli tipo di aspetto, fai clic su Elimina. Conferma quando richiesto.

gcloud

Per eliminare un tipo di aspetto personalizzato, utilizza il comando gcloud dataplex aspect-types delete.

C#

C#

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

Per eseguire l'autenticazione in Dataplex Universal 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 GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for DeleteAspectType</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 DeleteAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        DeleteAspectTypeRequest request = new DeleteAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
            Etag = "",
        };
        // Make the request
        Operation<Empty, OperationMetadata> response = catalogServiceClient.DeleteAspectType(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 = catalogServiceClient.PollOnceDeleteAspectType(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;
        }
    }
}

Go

Go

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

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

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.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.DeleteAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#DeleteAspectTypeRequest.
	}
	op, err := c.DeleteAspectType(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Java.

Per eseguire l'autenticazione in Dataplex Universal 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.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.DeleteAspectTypeRequest;
import com.google.protobuf.Empty;

public class SyncDeleteAspectType {

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

  public static void syncDeleteAspectType() 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      DeleteAspectTypeRequest request =
          DeleteAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .setEtag("etag3123477")
              .build();
      catalogServiceClient.deleteAspectTypeAsync(request).get();
    }
  }
}

Python

Python

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

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

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

    # Make the request
    operation = client.delete_aspect_type(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 Dataplex Universal Catalog per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Dataplex Universal Catalog Ruby.

Per eseguire l'autenticazione in Dataplex Universal 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_aspect_type call in the CatalogService 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::CatalogService::Client#delete_aspect_type.
#
def delete_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

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

  # Call the delete_aspect_type method.
  result = client.delete_aspect_type 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

Per eliminare un tipo di aspetto personalizzato esistente, utilizza il metodo aspectTypes.delete.

Passaggi successivi

• Scopri come cercare asset di dati in Dataplex Universal Catalog.
• Scopri come gestire le voci e importare fonti personalizzate.
• Scopri come importare i metadati in Dataplex Universal Catalog.
• Scopri di più sulla gestione dei metadati in Dataplex Universal Catalog.
• Scopri di più sulla transizione da Data Catalog a Dataplex Universal Catalog.
• Segui un codelab: governance di base con Dataplex Universal Catalog.