Os aspectos e tipos de aspecto no Knowledge Catalog (antigo Dataplex Universal Catalog) permitem adicionar metadados estruturados a entradas, colunas e links de entrada para descrever seus recursos de dados e as relações entre eles. Esse contexto melhora a facilidade de descoberta de dados e ajuda a classificar informações sensíveis, como informações de identificação pessoal (PII), para aplicar políticas de qualidade ou acesso de dados.
Para informações conceituais sobre esquemas de aspecto, tipos de aspecto do sistema versus personalizados, níveis de destino e restrições de residência de dados, consulte Sobre aspectos e tipos de aspecto. Para uma visão geral da arquitetura de todo o metamodelo de metadados, consulte Sobre metadados no Knowledge Catalog. Se esta for sua primeira vez trabalhando com metadados do Knowledge Catalog, consulte os guias de início rápido Adicionar metadados a uma tabela do BigQuery ou Criar e usar um glossário empresarial.
Antes de começar
Antes de criar e gerenciar tipos de aspecto e aspectos, conclua as tarefas descritas nesta seção.
Funções exigidas
Para receber as permissões necessárias para criar e gerenciar tipos de aspecto e aspectos, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto. Você não precisa de todos esses papéis ao mesmo tempo. Escolha o papel ou a combinação que corresponde ao seu fluxo de trabalho específico:
Para receber as permissões necessárias para criar e gerenciar tipos de aspecto e aspectos, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Para gerenciar todos os recursos do catálogo, incluindo tipos de aspecto e entradas, com acesso amplo de administrador:
Administrador de catálogo do Dataplex (
roles/dataplex.catalogAdmin) ou Editor de catálogo do Dataplex (roles/dataplex.catalogEditor) -
Para criar e gerenciar apenas tipos de aspecto personalizados, com acesso de privilégio mínimo para administradores de tipos de aspecto:
Proprietário de tipos de aspecto do Dataplex (
roles/dataplex.aspectTypeOwner) -
Para usar tipos de aspecto ao criar ou modificar entradas, com acesso de privilégio mínimo para curadores de dados:
Usuário de tipos de aspectos do Dataplex (
roles/dataplex.aspectTypeUser) -
Para anexar tipos de aspectos do sistema reutilizáveis, como
schema,contactseoverview, a entradas e links de entrada: Proprietário de entradas e links de entradas do Dataplex (roles/dataplex.entryOwner) -
Para visualizar os tipos de aspecto e as políticas do IAM sem modificá-los:
Leitor do Dataplex Catalog (
roles/dataplex.catalogViewer)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esses papéis predefinidos contêm as permissões necessárias para criar e gerenciar tipos de aspecto e aspectos. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para criar e gerenciar tipos de aspecto e aspectos:
-
Criar, visualizar, listar, atualizar e excluir tipos de aspecto:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
Use tipos de aspecto para enriquecer as entradas:
dataplex.aspectTypes.use -
Criar, visualizar, atualizar e excluir entradas e os aspectos delas:
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
Criar, visualizar, atualizar e excluir links de entrada e os aspectos deles:
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Para mais informações, consulte Papéis do IAM do Knowledge Catalog.
Ativar a API
Ative a API Dataplex no seu projeto do Knowledge Catalog. Se você estiver usando um novo projeto do Google Cloud ou um projeto em que a API BigQuery está ativada, a API Dataplex será ativada por padrão.
Criar um tipo de aspecto personalizado
Console
Para criar um tipo de aspecto personalizado no console do Google Cloud , siga estas subtarefas:
Configure os detalhes básicos:
No Google Cloud console, acesse a página Tipos de metadados do Knowledge Catalog.
Clique na guia Tipos de aspecto > Personalizado e, em seguida, em Criar tipo de aspecto.
Na seção Detalhes, digite o seguinte:
- Opcional: Nome de exibição: um nome fácil de usar para o tipo de aspecto.
- ID do tipo de aspecto: um identificador exclusivo do tipo de aspecto.
- Opcional: Descrição: uma descrição do tipo de aspecto e da finalidade dele.
- Local: selecione um local para o tipo de aspecto. Não é possível modificar o local após a criação. Para orientações sobre as vantagens e desvantagens de locais globais e regionais, consulte Tipos de aspecto personalizados.
Defina o modelo de esquema:
O modelo define o formato e o esquema dos campos de metadados agrupados no tipo de aspecto. É possível definir campos manualmente ou acelerar a criação de esquemas selecionando um modelo inicial na Galeria de modelos, como Sensibilidade de dados, Governança de dados ou Ingestão de dados. Por exemplo, selecionar o modelo Sensibilidade de dados adiciona automaticamente os campos booleanos
Is EncryptedeHas PIIe o campo de tipo enumeradoPII Type.Para definir campos manualmente:
- Na seção Modelo, clique em Adicionar campo.
- No painel Novo campo, especifique o seguinte:
- Nome: um identificador para o campo.
- Opcional: Nome de exibição: um rótulo fácil de usar.
- Opcional: Descrição: uma breve descrição do campo.
- Tipo: selecione o tipo de dados do campo. Os tipos compatíveis incluem Texto, Inteiro, Booleano, Data e hora, Duplo, Enum, Matriz, Mapa e Registro.
- Opcional: É obrigatório: marque essa caixa de seleção para tornar o campo obrigatório quando os usuários anexarem esse aspecto.
- Clique em Concluído. Para adicionar mais campos, clique em Adicionar campo e repita as etapas.
Adicione rótulos de recursos e salve:
Os rótulos de recursos são pares de chave-valor arbitrários que ajudam a organizar e filtrar os recursos do Google Cloud . Por exemplo, é possível organizar recursos por ambiente ou propriedade da equipe usando rótulos como
environment: productionouteam: analytics.- Na seção Marcadores, clique em Adicionar marcador.
- Insira a Chave e o Valor do rótulo.
- Clique em Salvar.
gcloud
Para criar um tipo de aspecto personalizado, use o comando gcloud dataplex aspect-types
create.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para criar um tipo de aspecto personalizado, use o método aspectType.create.
Depois de criar um tipo de aspecto personalizado, é possível adicionar aspectos às entradas.
Exemplo de uso dos campos de ID e referência de registro
É possível usar os campos ID do registro e Referência do registro para referências recursivas. O exemplo a seguir mostra como usar esses campos:
Considere um tipo de aspecto chamado Employee, com os seguintes campos:
- Nome (tipo:
Text) - Data de início (tipo:
Date & time) - Designação (tipo:
Text) - Endereço atual (tipo:
Record) - Endereço permanente (tipo:
Record)
Os dois campos de endereço Endereço atual e Endereço permanente são do mesmo tipo de dados Record. Para evitar duplicação, defina os valores de ID do registro e
Referência do registro ao definir esses campos.
Ao definir o campo Endereço atual, é possível especificar o ID do registro como
address-field. Em Endereço permanente, especifique o mesmo valor
(address-field) para Referência do registro. Exemplo:
- Nome (tipo:
Text) - Data de início (tipo:
Date & time) - Designação (tipo:
Text) - Endereço atual (tipo:
Record, ID do registro:address-field) - Endereço permanente (tipo:
Record, referência do registro:address-field)
Dessa forma, não é necessário duplicar os campos de outro endereço.
Adicionar aspectos a uma entrada
Depois de criar um tipo de aspecto personalizado, é possível criar aspectos desse tipo. Para adicionar aspectos a uma entrada, é necessário atualizá-la, já que os aspectos são armazenados dentro das entradas.
Observe as seguintes limitações:
- É possível adicionar aspectos a uma entrada ou às colunas de uma entrada.
- Só é possível editar os aspectos obrigatórios de entradas personalizadas. Não é possível excluir os aspectos obrigatórios.
- É possível editar e excluir os aspectos opcionais das entradas personalizadas e do sistema.
- Quando você substitui ou recarrega uma tabela do BigQuery usando uma
instrução
CREATE OR REPLACE TABLE, uma instruçãoTRUNCATE TABLEou um jobWRITE_TRUNCATE, o Knowledge Catalog preserva os aspectos anexados pelo usuário da entrada. Os aspectos no nível da coluna também são preservados para as colunas que permanecem no esquema. No entanto, se você descartar e recriar uma tabela usando uma instruçãoDROP TABLEe uma instruçãoCREATE TABLE, o Knowledge Catalog vai criar uma nova entrada sem os aspectos anexados pelo usuário da tabela original. Para manter os aspectos ao recarregar uma tabela, useCREATE OR REPLACE TABLE,TRUNCATE TABLEouWRITE_TRUNCATE. Como alternativa, é possível criar uma visualização do BigQuery e anexar aspectos a ela.
Console
No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.
Pesquise a entrada à qual você quer adicionar aspectos e clique nela. A página de detalhes da entrada é aberta.
Na página de detalhes da entrada, clique na guia Detalhes.
Na seção Aspectos, clique em Adicionar na área Aspectos obrigatórios ou Aspectos opcionais. Só é possível adicionar aspectos obrigatórios se o tipo de entrada definir aspectos obrigatórios.
Pesquise e selecione o aspecto que você quer adicionar.
Na janela Adicionar aspecto, insira os valores dos campos.
Clique em Salvar.
Para adicionar aspectos a uma coluna da entrada:
- Na página de detalhes da entrada, clique na guia Esquema.
- Selecione as colunas em que você quer adicionar aspectos.
- Clique em Adicionar aspecto.
- Pesquise e selecione o aspecto que você quer adicionar.
- Na janela Adicionar aspecto, insira os valores dos campos.
- Clique em Salvar.
gcloud
Para adicionar aspectos a uma entrada ou a uma coluna de uma entrada, use o comando gcloud
dataplex entries update.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Para adicionar aspectos ao objeto de entrada, consulte Aspectos.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Para adicionar aspectos ao objeto de entrada, consulte Entrada.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Para adicionar aspectos ao objeto de entrada, consulte #required_aspects=.
REST
Para adicionar aspectos a uma entrada ou a uma coluna de uma entrada, use o método entry.patch.
Não é possível criar e usar aspectos em uma entrada em que o respectivo tipo de aspecto e a entrada estão em organizações do Google Cloud diferentes.
Anexar aspectos de tipos de aspecto do sistema reutilizáveis
O Knowledge Catalog oferece tipos de aspecto do sistema predefinidos que podem ser anexados a entradas para capturar metadados padronizados. Por exemplo, é possível usar esses tipos de aspecto para registrar contatos de propriedade, definições de esquema, métricas de uso e resultados de qualidade de dados.
Regras gerais de fluxo de trabalho e payload
Ao anexar aspectos de tipos de aspecto do sistema reutilizáveis, siga estas regras:
- Console x CLI/REST: para tipos de aspecto sem campos aninhados, como
generic, use o console do Google Cloud , a CLI dogcloudou a API REST. Para tipos de aspecto com estruturas complexas ou aninhadas, comodata-quality-scorecard,contactsoudata-profile, use a CLIgcloudou a API REST. - Estrutura do payload:
- CLI do
gcloud: transmita o mapa de aspectos diretamente, com a chave do identificador de tipo de aspecto global:{"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}. - API REST: envolva o mapa de aspectos em um objeto de contêiner
"aspects":{"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}.
- CLI do
- Comportamento de substituição: a atualização de um aspecto substitui todos os dados atuais desse tipo específico na entrada ou coluna de destino. Ela não mescla campos.
As seções a seguir mostram exemplos e esquemas para anexar aspectos comuns e reutilizáveis do sistema, começando com o scorecard de qualidade de dados.
Tabela de qualidade de dados
Uma tabela de qualidade de dados é um aspecto que fornece um resumo da qualidade dos dados,
geralmente com base em verificações de qualidade de dados ou outros processos. É possível anexar um quadro de visão geral de qualidade de dados a uma entrada para fornecer informações personalizadas sobre a qualidade dos dados. Para fazer isso, anexe um aspecto do tipo definido pelo sistema data-quality-scorecard.
O campo data no aspecto data-quality-scorecard pode incluir os
seguintes campos:
job: opcional. Um registro com detalhes sobre o job que gerou o scorecard.name: o nome do recurso do job de qualidade de dados.runTime: o tempo de execução do job de qualidade de dados.
score: opcional. O índice de qualidade de dados geral. A pontuação varia entre [0, 100].status: obrigatório. O status da visão geral da qualidade de dados, indicando se ela foi aprovada ou reprovada no limite de qualidade (PASSouFAIL).dimensions: opcional. Uma matriz de resultados de dimensão. Cada resultado inclui:name: o nome da dimensão. Pode serACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITYouVOLUME, ou um nome de dimensão personalizada. Os nomes das dimensões personalizadas precisam usar letras maiúsculas e ter até 30 caracteres.score: a pontuação geral no nível da dimensão, que varia de [0, 100].status: o status da dimensão, indicando se ela foi aprovada ou reprovada no limite de qualidade (PASSouFAIL).
columns: opcional. Uma matriz de resultados de coluna. Cada resultado inclui:name: o nome da coluna.score: a pontuação geral no nível da coluna, que varia de [0, 100].status: o status da coluna, indicando se ela foi aprovada ou reprovada no limite de qualidade (PASSouFAIL).dimensions: uma matriz de pontuações de dimensão para a coluna. Cada pontuação de dimensão inclui:name: o nome da dimensão.score: a pontuação da dimensão, que varia de [0, 100].status: o status da dimensão da coluna, indicando se ela foi aprovada ou reprovada no limite de qualidade (PASS,FAIL,UNKNOWNouNOT_APPLICABLE).
details(mapa opcional): pares de chave-valor que fornecem mais contexto sobre a avaliação.evaluatedAssetCount(número inteiro opcional): o número de recursos avaliados.
Quando você executa o comando para anexar um aspecto, ele substitui todos os dados atuais desse aspecto específico. Por exemplo, se você atualizar uma ficha de avaliação com uma pontuação de
80 com um novo arquivo mostrando uma pontuação de 90, o 80 será substituído. Ele não mescla os dados.
Para anexar uma visão geral da qualidade de dados, siga estas etapas:
gcloud
Para atualizar os aspectos de uma entrada, use o comando
gcloud dataplex entries
update-aspects.
Crie um arquivo JSON (
dq-aspect.json) com o conteúdo a seguir.{ "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } }Execute este comando:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=dq-aspect.json
Substitua as seguintes variáveis:
ENTRY_ID: o ID da entrada, por exemplo,example-entryLOCATION: o local da entrada, por exemplo,us-central1ENTRY_GROUP_ID: o ID do grupo de entradas. Por exemplo,example-entry-group.PROJECT_ID: o ID do projeto, por exemplo,example-project
REST
Para atualizar os aspectos de uma entrada, use o método entry.patch.
Crie um arquivo chamado
payload.jsone cole o conteúdo JSON da sua solicitação nele.{ "aspects": { "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } } }Execute este comando no terminal:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d @payload.json \ "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"Substitua:
PROJECT_ID: o ID do projeto, por exemplo,example-project.LOCATION: o local da entrada, por exemplo,us-central1.ENTRY_GROUP_ID: o ID do grupo de entrada, por exemplo,example-entry-group.ENTRY_ID: o ID da entrada, por exemplo,example-entry.
Outros tipos de aspecto reutilizáveis
Os seguintes tipos de aspecto do sistema também estão disponíveis para enriquecimento de entrada. Os resumos iniciais estão listados nas seções a seguir. Clique em cada seção expansível para ver os esquemas de campo e exemplos de payloads JSON.
Contatos (dataplex-types.global.contacts)
Use o tipo de aspecto contacts para atribuir papéis de propriedade, administração ou operacionais às entradas.
identities(matriz): uma lista de contatos. Cada contato incluirole(por exemplo,owner,steward,producerouadmin),nameeid(endereço de e-mail).
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
Perfil de dados (dataplex-types.global.data-profile)
Use o tipo de aspecto data-profile para capturar resultados de criação de perfil estatístico gerados por verificações de dados de origem. Para mais informações, consulte Sobre a criação de perfil de dados.
sourceDataInfo(registro): metadados sobre a verificação, incluindoscope(PREVIEW,SAMPLEDouALL),scannedRowsesamplingPercentage.fields(mapa): estatísticas no nível da coluna, incluindonullness,uniquenesse métricas específicas de tipo para colunas numéricas, de string, de data e hora e de matriz.
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.data-profile": { "data": { "sourceDataInfo": { "scope": "ALL", "scannedRows": 100 }, "fields": { "col1": { "nullness": 0.0, "uniqueness": 0.1, "string": { "length": { "min": 1, "max": 20, "avg": 12.54 } } } } } } } }
Genérico (dataplex-types.global.generic)
Use o tipo de aspecto generic para capturar informações de entrada de formato livre e metadados do sistema de origem sem definir um esquema de aspecto personalizado.
type(string): uma string de categorização de entrada especificada pelo usuário.system(string): o identificador do sistema de origem da entrada personalizada.
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
Visão geral (dataplex-types.global.overview)
Use o tipo de aspecto overview para fornecer documentação de rich text legível por humanos e links externos úteis.
content(string): descrição em rich text que aceita formatação HTML.links(matriz): recursos externos e links de documentação, cada um contendourletitle.
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
Esquema (dataplex-types.global.schema)
Use o tipo de aspecto schema para descrever o esquema tabular, os nomes das colunas, os modos e os tipos de dados dos recursos de dados.
fields(matriz): lista de colunas, cada uma contendoname,dataType,metadataType(comoSTRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED) edescriptionopcional.
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
Uso (dataplex-types.global.usage)
Use o tipo de aspecto usage para acompanhar métricas de consumo, contagens de visualizações e padrões de consulta de série temporal.
metrics(matriz): métricas de consumo, cada uma contendoname(comoviewsoureads) e pontos de dadostimeSeriescom intervalos e valores de agregação.refreshTime(datetime): carimbo de data/hora de quando as métricas de uso foram calculadas pela última vez.
Exemplo de payload (API REST):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
Criar um link de entrada
É possível estabelecer uma relação entre duas entradas criando um link de entrada.
Um link de entrada pode ser simétrico, como um synonym, ou assimétrico, como um
definition.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para criar um link de entrada com o aspecto necessário, use o método entryLinks.create, incluindo os dados do aspecto no corpo da solicitação.
Adicionar aspectos a um link de entrada
Para enriquecer os metadados com informações sobre as relações entre as entradas, adicione aspectos aos links de entrada.
É possível configurar tipos de link de entrada para exigir um aspecto específico. Ao criar um link de entrada desse tipo, é necessário fornecer o aspecto obrigatório.
É possível adicionar esses aspectos ao criar um link de entrada ou atualizar um link de entrada atual, da seguinte maneira:
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para atualizar um link de entrada, use o método entryLinks.patch, incluindo os dados de aspecto no corpo entryLink.
Observe as seguintes limitações para usar aspectos com links de entrada:
- Não há suporte para aspectos opcionais.
- Os aspectos de dados não são compatíveis.
- Não há suporte para aspectos de tipos personalizados.
- Só é possível gerenciar aspectos obrigatórios definidos por tipos de aspecto do sistema, por exemplo,
schema-join. - Não é possível pesquisar links de entrada com base no conteúdo dos aspectos.
- Não é possível importar ou exportar aspectos de link de entrada.
Gerenciar aspectos de uma entrada
Nesta seção, descrevemos como atualizar e excluir os aspectos de uma entrada.
Atualizar um aspecto
É possível editar os aspectos opcionais das entradas personalizadas e do sistema. Só é possível editar os aspectos obrigatórios de entradas personalizadas.
Para entradas de sistema próprias (1P), como tabelas do BigQuery, é possível atualizar aspectos usando a API modifyEntry. Isso permite que você use as permissões de atualização de metadados do sistema de origem (por exemplo, Editor de dados do BigQuery (roles/bigquery.dataEditor)).
Console
No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.
Pesquise a entrada com os aspectos que você quer atualizar e clique nela.
A página de detalhes da entrada é aberta.
- Clique na guia Detalhes.
- Na seção Aspectos, expanda o aspecto que você quer atualizar e clique em Editar.
- Na janela Editar aspecto, atualize os campos obrigatórios.
- Clique em Salvar.
gcloud
Para atualizar aspectos de uma entrada ou de uma coluna de uma entrada, use o comando
gcloud
dataplex entries update ou gcloud dataplex entries update-aspects.
Para atualizar aspectos usando um arquivo JSON:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
Substitua:
ENTRY_ID: o ID da entrada.LOCATION: o local da entrada.ENTRY_GROUP_ID: o ID do grupo de entrada.PROJECT_ID: o ID do projeto.ASPECTS_JSON_FILE: o caminho para o arquivo JSON que contém o mapa de aspectos.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para atualizar aspectos de uma entrada ou de uma coluna de uma entrada, use o método entry.patch.
Excluir um aspecto
Console
No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.
Pesquise a entrada com os aspectos que você quer excluir e clique nela.
A página de detalhes da entrada é aberta.
- Clique na guia Detalhes.
- Na seção Aspectos, expanda o aspecto que você quer excluir e clique em Excluir.
- Clique em Confirmar.
gcloud
Para excluir um aspecto de uma entrada, use o comando gcloud dataplex entries update com a flag --remove-aspects.
Para excluir um aspecto de nível de entrada:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
Para excluir um aspecto no nível da coluna:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
Substitua:
ENTRY_ID: o ID da entrada.LOCATION: o local da entrada.ENTRY_GROUP_ID: o ID do grupo de entrada.PROJECT_ID: o ID do projeto.ASPECT_TYPE: o identificador completo do tipo de aspecto, por exemplo,dataplex-types.global.genericou<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>.COLUMN_NAME: o nome da coluna.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para excluir um aspecto de uma entrada, use o método entry.patch.
Gerenciar aspectos de um link de entrada
Nesta seção, descrevemos como atualizar os aspectos de um link de entrada.
Atualizar um aspecto
Para links de entrada, só é possível atualizar os aspectos obrigatórios que usam tipos de aspecto do sistema reutilizáveis.
Para mais informações, consulte Permissões do IAM para operações de links de entrada.
REST
Para atualizar um link de entrada com o aspecto necessário, use o método entryLinks.patch, incluindo os dados do aspecto no corpo da solicitação.
Excluir um aspecto
Não é possível excluir o aspecto obrigatório de um link de entrada.
Gerenciar tipos de aspecto
Nesta seção, descrevemos como visualizar tipos de aspecto e atualizar e excluir tipos de aspecto personalizados.
Confira a lista de tipos de aspecto disponíveis
Console
No console Google Cloud , acesse a página Tipos de metadados do Knowledge Catalog.
Clique na guia Tipos de aspecto.
Nesta página, listamos todos os tipos de aspecto disponíveis do Knowledge Catalog.
- Para ver os tipos de aspecto personalizados, clique na guia Personalizado. Na guia Personalizado, a coluna Origem do catálogo mostra onde o recurso está no Knowledge Catalog.
Para ver os tipos de aspecto do sistema, clique na guia Sistema.
Para mais informações sobre tipos de aspecto personalizados e do sistema, consulte a seção categorias de tipos de aspecto deste documento.
- Opcional: para ver a lista de tipos de aspecto no projeto selecionado, clique na guia Personalizado e, em seguida, clique no botão de alternância Mostrar de todos os projetos para a posição desativada.
A opção Mostrar de todos os projetos fica ativada por padrão, e a lista inclui recursos do Knowledge Catalog da organização selecionada.
gcloud
Para listar todos os tipos de aspecto disponíveis, use o comando
gcloud dataplex
aspect-types list.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para listar todos os tipos de aspecto disponíveis, use o método aspectTypes.list.
Ver detalhes de um tipo de aspecto
Console
No console Google Cloud , acesse a página Tipos de metadados do Knowledge Catalog.
Clique na guia Tipos de aspecto.
Para ver os detalhes de um tipo de aspecto do Knowledge Catalog, clique nele. A página de detalhes do tipo de aspecto é aberta, onde é possível acessar detalhes, como nome de exibição, ID do tipo de aspecto, descrição, ID do projeto, local, rótulos, data de criação e data da última modificação.
- Para conferir a estrutura do tipo de aspecto selecionado, clique na guia Modelo.
- Para ver a lista de 10 entradas relacionadas criadas recentemente, clique na guia Entradas de amostra.
- Para pesquisar todas as entradas relacionadas, clique em Mostrar todas as entradas relacionadas na pesquisa. Esse botão só aparece se houver pelo menos uma entrada relacionada.
gcloud
Para ver os detalhes de um tipo de aspecto, use o comando gcloud dataplex aspect-types
describe.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para ver os detalhes de um tipo de aspecto, use o método aspectTypes.get.
Atualizar um tipo de aspecto personalizado
É possível atualizar o nome de exibição, a descrição, os campos de modelo e os rótulos de um tipo de aspecto personalizado. Não é possível excluir um campo em um modelo.
Não é possível atualizar o ID e o local do tipo de aspecto depois de criá-lo.
Console
No console Google Cloud , acesse a página Tipos de metadados do Knowledge Catalog.
Clique na guia Tipos de aspecto.
Clique no tipo de aspecto que você quer atualizar.
Na página Detalhes do tipo de aspecto, clique em Editar.
Edite o nome de exibição, a descrição, os campos de modelo e os rótulos, conforme necessário.
Opcional: para marcar um campo no tipo de aspecto como descontinuado, siga estas etapas:
- Na seção Modelo, expanda o campo.
- Selecione Está descontinuado.
- No campo Motivo da descontinuação, insira um motivo para descontinuar o campo selecionado.
Clique em Concluído.
Clique em Salvar.
gcloud
Para atualizar um tipo de aspecto personalizado, use o comando gcloud dataplex aspect-types
update.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para atualizar um tipo de aspecto personalizado, use o método aspectTypes.patch.
Excluir um tipo de aspecto personalizado
Console
No console Google Cloud , acesse a página Tipos de metadados do Knowledge Catalog.
Clique na guia Tipos de aspecto.
Clique no tipo de aspecto que você quer excluir.
Na página Detalhes do tipo de aspecto, clique em Excluir. Confirme quando solicitado.
gcloud
Para excluir um tipo de aspecto personalizado, use o comando gcloud dataplex aspect-types
delete.
C#
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog C#.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Go.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Java.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
Antes de testar este exemplo, siga as instruções de configuração do Node.js no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Node.js.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Python.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Ruby
Antes de testar este exemplo, siga as instruções de configuração do Ruby no Guia de início rápido do Knowledge Catalog: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Knowledge Catalog Ruby.
Para autenticar no Knowledge Catalog, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
REST
Para excluir um tipo de aspecto personalizado, use o método aspectTypes.delete.
A seguir
- Saiba como pesquisar recursos no Knowledge Catalog.
- Saiba como gerenciar entradas e ingerir fontes personalizadas.
- Saiba como importar metadados para o Knowledge Catalog.
- Saiba mais sobre metadados no Knowledge Catalog.
- Saiba como estabelecer um contexto de dados fundamental.
- Confira os casos de uso do Knowledge Catalog.