Faça a gestão de aspetos e enriqueça os metadados

Os metadados são essenciais para organizar e compreender os seus recursos de dados. Por exemplo, as indústrias regulamentadas têm de proteger as informações de identificação pessoal (PII), como nomes, moradas e números de identificação emitidos por entidades governamentais. Estes dados podem ocorrer em várias instâncias em sistemas de dados distribuídos. O catálogo universal do Dataplex pode ajudar a descobrir e catalogar rapidamente os seus recursos de dados distribuídos. Em seguida, pode classificar os dados como PII.

Ao enriquecer as entradas de dados com contexto significativo, pode tornar os seus dados mais descobríveis e úteis. O Dataplex Universal Catalog permite o contexto através do seguinte:

  • Tipo de aspeto: um modelo JSON que define dados relacionados. Por exemplo, para informações de conformidade, pode ter a classificação de PII e a conformidade com o RGPD.
  • Aspeto: uma instância de um tipo de aspeto. Por exemplo, {"pii_classification": "confidential", "gdpr_compliant": true}. Pode aplicar um aspeto a uma tabela inteira ou a uma coluna individual da tabela.

Depois de classificar os dados, pode aplicar políticas de qualidade de dados ou de acesso aos dados.

Para mais informações, consulte o artigo Acerca da gestão de metadados no Dataplex Universal Catalog.

Aspetos

Os aspetos permitem-lhe capturar metadados nas entradas para fornecer um contexto significativo. Pode usar aspetos para armazenar:

  • Metadados da empresa: informações que fornecem contexto empresarial, como a classificação de dados.

  • Metadados técnicos: detalhes técnicos sobre o recurso de dados, por exemplo, o respetivo esquema.

  • Metadados derivados de dados: informações geradas a partir dos próprios dados, como estatísticas de uma tabela do BigQuery.

Os aspetos são considerados partes do recurso de entrada e não recursos separados. Quando modifica um aspeto, está a modificar a entrada que contém o aspeto.

Pode especificar aspetos ao nível da entrada para descrever uma entrada ou ao nível da coluna para descrever uma coluna numa entrada.

Cada aspeto é uma instância de um tipo de aspeto. Um tipo de aspeto define um modelo para os respetivos aspetos. Cada tipo de aspeto contém um conjunto de campos. Quando cria aspetos, tem de fornecer valores para esses campos.

Para uma determinada entrada, pode haver, no máximo, um aspeto associado à entrada, por tipo de aspeto. Pode ter vários aspetos associados a colunas de entrada por tipo de aspeto.

Categorias de aspetos

Os aspetos são categorizados da seguinte forma:

  • Aspetos obrigatórios: aspetos que são obrigatórios na criação de uma entrada. Estes aspetos são definidos pelo tipo de entrada de uma determinada entrada. Todas as entradas pertencentes a um tipo de entrada têm de ter sempre todos os aspetos necessários definidos por esse tipo de entrada.

    O catálogo universal do Dataplex gere os aspetos necessários (por exemplo, o esquema) para as entradas do sistema.

    Tenha em conta o seguinte:

    • Só pode associar aspetos obrigatórios a entradas e não às colunas de uma entrada.

    • Não pode eliminar os aspetos obrigatórios de uma entrada.

    • Pode ler os aspetos necessários das entradas do sistema, mas não os pode modificar.

    • Os aspetos de dados não podem ser aspetos obrigatórios.

  • Aspetos opcionais: pode associar aspetos opcionais a entradas ou a colunas de entradas. Pode preencher aspetos opcionais no momento da criação da entrada ou mais tarde, atualizando a entrada.

    Pode eliminar aspetos opcionais depois de os preencher.

Aspetos dos dados

Os aspetos podem conter informações derivadas de dados, como resultados do perfil de dados ou consultas de exemplo. Estes são denominados aspetos dos dados.

Tipos de aspetos

Os tipos de aspetos são recursos reutilizáveis que fornecem modelos para aspetos.

Categorias de tipos de aspetos

Os tipos de aspetos são categorizados em tipos de aspetos personalizados e do sistema.

Tipos de aspetos personalizados

Os tipos de aspetos que cria no catálogo universal do Dataplex são denominados tipos de aspetos personalizados.

Os tipos de aspeto personalizados podem ser globais ou regionais. Pode criar tipos de aspetos personalizados numa localização regional específica (por exemplo, us-central1) ou como um recurso global. A localização de um tipo de aspeto afeta o âmbito da sua aplicabilidade e determina com que entradas pode ser usado:

  • Tipos de aspetos globais: podem ser usados para criar aspetos para entradas em qualquer região. Escolha um globaltipo de aspeto se precisar de aplicar a mesma estrutura a entradas em várias regiões, uma vez que só precisa de a definir uma vez. Uma vez que a definição de um tipo de aspeto global é replicada em todas as regiões, esta opção pode não ser adequada se o esquema do tipo de aspeto contiver informações confidenciais ou se for necessária uma residência de dados rigorosa para todos os componentes de metadados.
  • Tipos de aspetos regionais: só podem ser usados para criar aspetos para entradas que residam na mesma região que o tipo de aspeto. Por exemplo, um tipo de aspeto criado em us-central1 só pode ser usado com entradas em us-central1. Escolha uma localização regional se um tipo de aspeto for apenas relevante para entradas numa região específica ou para garantir que a definição do tipo de aspeto reside na região selecionada, o que pode ajudar a cumprir os requisitos de soberania e conformidade dos dados. Se usar tipos de aspetos regionais, mas precisar da mesma estrutura em várias regiões, tem de criar e gerir definições de tipos de aspetos separadas em cada região.

Para mais informações, consulte o artigo Restrições de projetos e localizações.

Tipos de aspetos do sistema

Os tipos de aspetos que o Dataplex Universal Catalog fornece, usa e gere são denominados tipos de aspetos do sistema. Os tipos de aspetos do sistema são sempre globais e, por isso, podem ser usados em qualquer região. Os tipos de aspetos do sistema são armazenados num projeto gerido pela Google com o número do projeto 655216118709. Por exemplo, projects/655216118709/locations/global/aspectTypes/schema.

Os tipos de aspeto do sistema são ainda categorizados como reutilizáveis e restritos. A tabela seguinte descreve as categorias de tipos de aspetos do sistema e a lista de tipos de aspetos que o catálogo universal do Dataplex fornece para cada uma das categorias:

Categoria do tipo de aspeto do sistema Descrição Tipos de aspetos que o Dataplex Universal Catalog oferece
Tipo de aspeto do sistema reutilizável Pode usar estes tipos de aspetos para criar ou modificar aspetos.
  • contacts
  • data-quality-scorecard
  • generic
  • overview
  • schema
  • usage
Tipo de aspeto do sistema restrito O Dataplex Universal Catalog gere estes tipos de aspetos.
Pode ler aspetos nestes tipos de aspetos, mas não pode criar nem editar aspetos nestes tipos de aspetos.
Incluindo, entre outros:
  • 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

Antes de começar

Antes de criar e gerir tipos de aspetos e aspetos, conclua as tarefas descritas nesta secção.

Funções necessárias

Para receber as autorizações de que precisa para criar e gerir tipos de aspetos e aspetos, peça ao seu administrador que lhe conceda as seguintes funções de IAM no recurso:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para mais informações, consulte o artigo Funções de IAM do catálogo universal do Dataplex.

Ative a API

Ative a API Dataplex no seu projeto do Dataplex Universal Catalog.

Ative a API

Crie um tipo de formato personalizado

Consola

  1. Na Google Cloud consola, aceda à página Catálogo do Dataplex Universal Catalog.

    Aceder ao catálogo

  2. Clique no separador Tipos de aspetos e modelos de etiquetas > Personalizado.

  3. Clique em Criar tipo de aspeto.

  4. Na janela Criar tipo de aspeto, introduza o seguinte:

    1. Opcional: no campo Nome a apresentar, introduza um nome para o tipo de aspeto.
    2. No campo ID do tipo de aspeto, introduza um ID exclusivo para o tipo de aspeto.
    3. Opcional: no campo Descrição, introduza uma descrição para o tipo de aspeto.
    4. No campo Localização, selecione uma localização para o tipo de aspeto. Não pode modificar a localização de um tipo de aspeto depois de o criar. Para compreender o impacto da escolha de uma localização global em comparação com uma localização regional, consulte a secção Tipos de aspetos personalizados.
  5. Opcional: defina um modelo para o seu tipo de aspeto.

    Na secção Modelo, clique em Adicionar campo. Na secção Novo campo, introduza o seguinte:

    1. No campo Nome, introduza um nome.
    2. Opcional: no campo Nome a apresentar, introduza um nome a apresentar.
    3. Opcional: no campo Descrição, introduza uma descrição.
    4. No campo Tipo, selecione um tipo de dados para o campo. Com base na sua seleção, é apresentado o conjunto seguinte de campos e opções:

      • Se selecionou Texto como o tipo de dados, siga estes passos:

        1. No campo Tipo de texto, selecione o tipo de texto.
        2. No campo Valores de texto, indique uma sugestão para o campo de texto. Para tal, clique em Adicionar valor e introduza a sugestão. Pode adicionar várias sugestões para um campo de texto.
        3. Clique em Concluído.
      • Se selecionou Enum como o tipo de dados, adicione um valor enum:

        1. Clique em Adicionar um valor de enumeração.
        2. No campo Valor, introduza um valor de enumeração. Pode adicionar vários valores de enumeração.
        3. Clique em Concluído.
      • Se selecionou Matriz como tipo de dados, na secção Item da matriz, defina os tipos de itens a apresentar na matriz:

        1. Clique em Adicionar item de matriz.
        2. No campo Nome, introduza um nome para os itens da matriz.
        3. Opcional: no campo Nome a apresentar, introduza um nome a apresentar para os itens da matriz.
        4. Opcional: no campo Descrição, introduza uma descrição dos itens da matriz.
        5. No campo Tipo, selecione um tipo de dados para os itens da matriz.

          Com base na sua seleção, é apresentado o conjunto seguinte de campos e opções. São semelhantes às opções descritas para os tipos de dados Text, Enum, Map, Array e Record noutras partes desta secção.

        6. Clique em Concluído.

      • Se selecionou Mapa como o tipo de dados, na secção Valor do mapa, defina os tipos de valores a apresentar no mapa:

        1. Clique em Adicionar valor de mapeamento.
        2. No campo Nome, introduza um nome para o mapa.
        3. Opcional: no campo Nome a apresentar, introduza um nome a apresentar para o mapa.
        4. Opcional: no campo Descrição, introduza uma descrição do mapa.
        5. No campo Tipo, selecione um tipo de dados para o mapa.

          Com base na sua seleção, é apresentado o conjunto seguinte de campos e opções. São semelhantes às opções descritas para os tipos de dados Text, Enum, Map, Array e Record noutras partes desta secção.

        6. Clique em Concluído.

      • Se selecionou Registo como tipo de dados, introduza o seguinte:

        1. No campo ID do registo, introduza um ID exclusivo que outros campos de registo possam usar para se referirem a este registo. Consulte a secção Exemplo de utilização dos campos ID do registo e Referência do registo deste documento.
        2. Opcional: se quiser adicionar uma referência a outro registo a partir deste modelo, use o campo Referência do registo. Não pode modificar esta opção depois de criar o tipo de aspeto. Consulte a secção Exemplo de utilização dos campos ID do registo e Referência do registo deste documento.
        3. Na secção Campos de registo, pode definir um objeto complexo com vários campos aninhados. Para o fazer, clique em Adicionar item de campo de registo e especifique o seguinte:

        4. No campo Nome, introduza um nome para o campo de registo.

        5. Opcional: no campo Nome a apresentar, introduza um nome a apresentar para o campo de registo.

        6. Opcional: no campo Descrição, introduza uma descrição para o campo de registo.

        7. No campo Tipo, selecione um tipo de dados.

          Com base na sua seleção, é apresentado o conjunto seguinte de campos e opções. São semelhantes às opções descritas para os tipos de dados Texto, Enumeração, Mapa, Matriz e Registo anteriormente nesta secção.

        8. Clique em Concluído.

    5. Para tornar o campo obrigatório para um aspeto deste tipo, selecione É obrigatório. Para mais informações sobre os aspetos obrigatórios e opcionais, consulte a secção Categorias de aspetos deste documento.

    6. Clique em Concluído.

    7. Para adicionar vários campos, clique em Adicionar campo e repita os passos anteriores.

  6. Opcional: na secção Etiquetas, adicione etiquetas arbitrárias como pares chave-valor aos seus recursos:

    1. Clique em Adicionar etiqueta.
    2. No campo Chave, introduza uma chave.
    3. No campo Valor, introduza um valor para a chave.
    4. Para adicionar mais etiquetas, clique em Adicionar etiqueta e repita os passos.
  7. Clique em Guardar.

gcloud

Para criar um tipo de aspeto personalizado, use o comando gcloud dataplex aspect-types create.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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;
        }
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para criar um tipo de aspeto personalizado, use o método aspectType.create.

Depois de criar um tipo de aspeto personalizado, pode adicionar aspetos às entradas.

Exemplo de utilização dos campos ID do registo e Referência do registo

Pode usar os campos ID do registo e Referência do registo para referências recursivas. O exemplo seguinte mostra como usar estes campos:

Considere um tipo de aspeto denominado Employee, com os seguintes campos:

  • Nome (tipo:Text)
  • Data de início (tipo:Date & time)
  • Designação (tipo:Text)
  • Morada atual (tipo:Record)
  • Morada permanente (tipo:Record)

Os dois campos de morada Morada atual e Morada permanente são do mesmo tipo de dados Record. Para evitar a duplicação, pode definir os valores de ID do registo e Referência do registo quando definir estes campos.

Quando define o campo Morada atual, pode especificar ID do registo como address-field. Para Morada permanente, pode especificar o mesmo valor (address-field) para Referência do registo. Por exemplo:

  • Nome (tipo:Text)
  • Data de início (tipo:Date & time)
  • Designação (tipo:Text)
  • Morada atual (tipo:Record, ID do registo:address-field)
  • Morada permanente (tipo:Record, referência do registo:address-field)

Desta forma, não tem de duplicar os campos de outro endereço.

Adicione aspetos a uma entrada

Depois de criar um tipo de aspeto, pode criar aspetos desse tipo. Para adicionar aspetos a uma entrada, tem de atualizar a entrada, uma vez que os aspetos são armazenados nas entradas.

Tenha em conta o seguinte:

  • Pode adicionar aspetos a uma entrada ou às colunas de uma entrada.
  • Só pode editar os aspetos obrigatórios para entradas personalizadas. Não pode eliminar os aspetos obrigatórios.
  • Pode editar e eliminar os aspetos opcionais das entradas personalizadas e das entradas do sistema.

Consola

  1. Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.

    Aceda à Pesquisa

  2. Em Escolher plataforma de pesquisa, selecione Catálogo universal do Dataplex como o modo de pesquisa.

  3. Pesquise a entrada à qual quer adicionar aspetos e clique na entrada. É apresentada a página de detalhes da entrada.

  4. Para adicionar aspetos à entrada, siga estes passos:

    1. Clique no separador Detalhes.
    2. Para adicionar aspetos obrigatórios ou opcionais à entrada, na secção Etiquetas e aspetos, clique em Adicionar para a respetiva categoria.
      Não pode adicionar aspetos obrigatórios se o tipo de entrada da entrada selecionada não tiver aspetos obrigatórios definidos.
    3. Pesquise e selecione o aspeto que quer adicionar.
    4. Na janela Adicionar aspeto, introduza os valores dos campos.
    5. Clique em Guardar.
  5. Para adicionar aspetos a uma coluna da entrada, siga estes passos:

    1. Na página de detalhes da entrada, clique no separador Esquema.
    2. Selecione as colunas às quais quer adicionar aspetos.
    3. Clique em Adicionar aspeto.
    4. Pesquise e selecione o aspeto que quer adicionar.
    5. Na janela Adicionar aspeto, introduza os valores dos campos.
    6. Clique em Guardar.

gcloud

Para adicionar aspetos a uma entrada ou a uma coluna de uma entrada, use o comando gcloud dataplex entries update.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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);
    }
}

Para adicionar aspetos ao objeto de entrada, consulte a secção Aspetos.

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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
}

Para adicionar aspetos ao objeto de entrada, consulte Entrada.

Java

Java

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para adicionar aspetos ao objeto de entrada, consulte #required_aspects=.

REST

Para adicionar aspetos a uma entrada ou a uma coluna de uma entrada, use o método entry.patch.

A criação e a utilização de aspetos numa entrada em que o tipo de aspeto respetivo e a entrada estão em organizações Google Cloud diferentes não são suportadas.

Faça a gestão dos aspetos existentes de uma entrada

Esta secção descreve como atualizar e eliminar os aspetos existentes de uma entrada.

Atualize um aspeto

Pode editar os aspetos opcionais das entradas personalizadas e do sistema. Só pode editar os aspetos obrigatórios para entradas personalizadas.

Consola

  1. Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.

    Aceda à Pesquisa

  2. Em Escolher plataforma de pesquisa, selecione Catálogo universal do Dataplex como o modo de pesquisa.

  3. Pesquise a entrada cujos aspetos quer atualizar e clique na entrada.

    É apresentada a página de detalhes da entrada.

  4. Clique no separador Detalhes.

  5. Na secção Etiquetas e aspetos, expanda o aspeto ou a etiqueta que quer atualizar e clique em Editar.

  6. Na janela Editar aspeto, atualize os campos obrigatórios.

  7. Clique em Guardar.

gcloud

Para atualizar aspetos de uma entrada ou de uma coluna de uma entrada, use o comando gcloud dataplex entries update.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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);
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para atualizar aspetos de uma entrada ou de uma coluna de uma entrada, use o método entry.patch.

Elimine um aspeto

Consola

  1. Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.

    Aceda à Pesquisa

  2. Em Escolher plataforma de pesquisa, selecione Catálogo universal do Dataplex como o modo de pesquisa.

  3. Pesquise a entrada cujos aspetos quer eliminar e clique na entrada.

    É apresentada a página de detalhes da entrada.

  4. Clique no separador Detalhes.

  5. Na secção Etiquetas e aspetos, expanda o aspeto ou a etiqueta que quer eliminar e clique em Eliminar.

  6. Clique em Confirm.

gcloud

Para eliminar um aspeto de uma entrada, use o comando gcloud dataplex entries update.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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);
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para eliminar um aspeto de uma entrada, use o método entry.patch.

Faça a gestão dos tipos de aspetos

Esta secção descreve como ver, atualizar e eliminar tipos de aspetos.

Veja a lista de tipos de aspetos e modelos de etiquetas disponíveis

Consola

  1. Na Google Cloud consola, aceda à página Catálogo do Dataplex Universal Catalog.

    Aceder ao catálogo

  2. Clique no separador Tipos de aspetos e modelos de etiquetas.

    Esta página apresenta uma lista de todos os tipos de aspetos do Dataplex Universal Catalog disponíveis e modelos de etiquetas do Data Catalog.

  3. Para ver tipos de aspetos personalizados e modelos de etiquetas, clique no separador Personalizado. No separador Personalizado, a coluna Origem do catálogo mostra onde o recurso reside: no catálogo universal do Dataplex ou no Data Catalog.

    Para ver os tipos de aspetos do sistema, clique no separador Sistema.

    Para mais informações sobre os tipos de aspeto personalizados e do sistema, consulte a secção Categorias de tipos de aspeto deste documento.

  4. Opcional: para ver a lista de tipos de aspetos e modelos de etiquetas no projeto selecionado, clique no separador Personalizado e, de seguida, clique no botão Mostrar de todos os projetos para o desativar.

    O botão Mostrar de todos os projetos está ativado por predefinição e a lista inclui recursos do Dataplex Universal Catalog da sua organização selecionada e recursos do Data Catalog de todas as organizações às quais pode aceder.

gcloud

Para listar todos os tipos de aspetos disponíveis, use o comando gcloud dataplex aspect-types list.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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;
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para listar todos os tipos de aspetos disponíveis, use o método aspectTypes.list.

Veja os detalhes de um tipo de aspeto ou de um modelo de etiqueta

Consola

  1. Na Google Cloud consola, aceda à página Catálogo do Dataplex Universal Catalog.

    Aceder ao catálogo

  2. Clique no separador Tipos de aspetos e modelos de etiquetas.

  3. Para ver os detalhes de um tipo de aspeto do catálogo universal do Dataplex, clique no tipo de aspeto. É apresentada a página de detalhes do tipo de aspeto, onde pode aceder a detalhes, como o nome a apresentar, o ID do tipo de aspeto, a descrição, o ID do projeto, a localização, as etiquetas, a data de criação e a data da última modificação.

    • Para ver a estrutura do tipo de aspeto selecionado, clique no separador Modelo.
    • Para ver a lista de 10 entradas relacionadas criadas recentemente, clique no separador Entradas de exemplo.
    • Para pesquisar todas as entradas relacionadas, clique em Mostrar todas as entradas relacionadas na Pesquisa. Este botão só aparece se existir, pelo menos, uma entrada relacionada.
  4. Para ver os detalhes de um modelo de etiqueta do catálogo de dados, clique no modelo de etiqueta. A página de detalhes do modelo de etiqueta é aberta no catálogo de dados, onde pode aceder a detalhes como o nome a apresentar, o ID do modelo, o ID do projeto, a localização, a visibilidade e as etiquetas.

gcloud

Para obter os detalhes de um tipo de aspeto, use o comando gcloud dataplex aspect-types describe.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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);
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para obter os detalhes de um tipo de aspeto, use o método aspectTypes.get.

Atualize um tipo de formato personalizado

Pode atualizar o nome a apresentar, a descrição, os campos do modelo e as etiquetas de um tipo de aspeto personalizado. Não pode eliminar um campo existente num modelo.

Não pode atualizar o ID e a localização do tipo de aspeto depois de criar o tipo de aspeto.

Consola

  1. Na Google Cloud consola, aceda à página Catálogo do Dataplex Universal Catalog.

    Aceder ao catálogo

  2. Clique no separador Tipos de aspetos e modelos de etiquetas.

  3. Clique no tipo de aspeto que quer atualizar.

  4. Na página Detalhes do tipo de aspeto, clique em Editar.

  5. Edite o nome a apresentar, a descrição, os campos do modelo e as etiquetas, conforme necessário.

  6. Opcional: para marcar um campo no tipo de aspeto como descontinuado, siga estes passos:

    1. Na secção Modelo, expanda o campo.
    2. Selecione Está descontinuado.
    3. No campo Motivo da descontinuação, introduza um motivo para descontinuar o campo selecionado.
    4. Clique em Concluído.
  7. Clique em Guardar.

gcloud

Para atualizar um tipo de aspeto personalizado, use o comando gcloud dataplex aspect-types update.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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;
        }
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para atualizar um tipo de aspeto personalizado, use o método aspectTypes.patch.

Elimine um tipo de aspeto personalizado

Consola

  1. Na Google Cloud consola, aceda à página Catálogo do Dataplex Universal Catalog.

    Aceder ao catálogo

  2. Clique no separador Tipos de aspetos e modelos de etiquetas.

  3. Clique no tipo de aspeto que quer eliminar.

  4. Na página Detalhes do tipo de aspeto, clique em Eliminar. Confirme quando lhe for pedido.

gcloud

Para eliminar um tipo de aspeto personalizado, use o comando gcloud dataplex aspect-types delete.

C#

C#

Antes de experimentar este exemplo, siga as C#instruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C#Dataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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;
        }
    }
}

Ir

Go

Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API GoDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.


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

Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API JavaDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PythonDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

# 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

Antes de experimentar este exemplo, siga as Rubyinstruções de configuração no início rápido do Dataplex Universal Catalog com bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API RubyDataplex Universal Catalog.

Para se autenticar no Dataplex Universal Catalog, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.

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

Para eliminar um tipo de aspeto personalizado existente, use o método aspectTypes.delete.

O que se segue?