Criar e gerenciar glossários de negócios do Dataplex (original) (raw)

Este documento descreve como criar e usar o conteúdo do glossário de negócios no Dataplex.

O glossário de negócios oferece um único local para manter e gerenciar a terminologia e as definições relacionadas a negócios em toda a organização. Ele permite anexar termos às colunas de entradas de dados catalogadas.

Você pode usar o glossário de negócios do Dataplex para:

• Crie e mantenha glossários, categorias e termos de negócios.
• Use categorias para representar estruturas hierárquicas de categorias e termos.
• Estabeleça relações entre termos como sinônimos ou termos relacionados.
• Anexe termos às colunas de entrada de dados.
• Procurar e filtrar termos no glossário de negócios.
• Mostrar termos e entradas de dados relacionados a um determinado termo.
• Pesquise entradas de dados marcadas com um termo específico.
• Mostrar termos relacionados a uma determinada entrada de dados.

Terminologia

Esta seção descreve a terminologia usada neste documento.

Glossário de negócios

O glossário de negócios é um repositório que fornece vocabulários adequados e governa os termos de negócios de uma empresa, junto com as definições de termos associadas e as relações entre os termos. Ele oferece um único lugar para manter e gerenciar termos de negócios e as definições deles. Um glossário de negócios tem a seguinte propriedade exibida no console:

• Visão geral: uma descrição em rich text de formato livre do propósito e do conteúdo do glossário de negócios.

Categoria

Uma categoria é definida em um glossário de negócios. Ele permite organizar e estruturar várias categorias e termos. É possível aninhar categorias em até três níveis. Confira a seguir as propriedades de uma categoria:

• Categoria: uma relação usada para estabelecer o contêiner da categoria atual, se houver.
• Descrição: uma definição da empresa em formato livre de texto enriquecido da categoria.
• Administrador de dados: especifica a pessoa responsável por manter a categoria. Essa é uma propriedade descritiva e não afeta as permissões na categoria.

Termo

Um termo é definido em um glossário de negócios diretamente ou em qualquer categoria encontrada nele. Ele descreve um conceito usado em uma área específica de negócios em uma empresa. Um termo tem as seguintes propriedades exibidas no console:

• Categoria: uma relação usada para estabelecer o contêiner do termo atual, se houver.
• Descrição: uma definição de negócio de rich text livre do termo.
• Administrador de dados: especifica a pessoa responsável por manter o termo. Essa é uma propriedade descritiva e não afeta as permissões do termo.

É possível anexar termos às colunas de uma entrada de dados para indicar que as colunas são descritas por esses termos.

Sinônimo

Um sinônimo é uma relação usada para indicar semelhança semântica ou equivalência entre dois termos diferentes. Ele é usado quando dois termos semelhantes são definidos por equipes diferentes em glossários diferentes. Por exemplo, earnings e income.

Um termo relacionado é uma relação usada para indicar que dois termos são semanticamente relacionados, mas diferentes. Por exemplo, profit e income.

Antes de começar

Limitações

• A importação em massa de termos para um glossário de negócios não é aceita.
• O recurso de glossário de negócios só é compatível com o console do Google Cloud.
• Quando você pesquisa entradas de dados na página Pesquisar do Dataplex, o resultado da pesquisa inclui entradas de dados em que um dos termos anexados corresponde ao termo usado para a pesquisa. No entanto, a referência ao termo correspondente não é exibida no resultado da pesquisa.
• Não há suporte para regiões do BigQuery Omni. Não é possível criar conteúdo de glossário de negócios ou anexar termos a entradas de dados nessas regiões.

Papéis e permissões necessárias

Para receber as permissões necessárias para criar e gerenciar glossários, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Acesso total a glossários, categorias e termos:Proprietário do glossário do DataCatalog (roles/datacatalog.glossaryOwner)
• Leia glossários, categorias e termos, crie anexos entre termos e crie anexos entre termos e entradas de dados:Usuário do glossário do DataCatalog (roles/datacatalog.glossaryUser)
• Acesso de leitura a glossários, categorias e termos:Visualizador de entradas do DataCatalog (roles/datacatalog.entryViewer)

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 glossários. Para conferir 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 glossários:

• Acesso total a glossários, categorias e termos:
  • `datacatalog.entries.*`
  • `datacatalog.relationships.*`
• Leia glossários, categorias e termos, crie anexos entre termos e crie anexos entre termos e entradas de dados:
  • `datacatalog.entries.get`
  • `datacatalog.entries.list`
  • `datacatalog.relationships.*`
• Acesso somente leitura a glossários, categorias e termos:
  • `datacatalog.entries.get`
  • `datacatalog.entries.list`
  • `datacatalog.entryGroups.get`
  • `datacatalog.relationships.list`
  • `resourcemanager.projects.list`
  • `resourcemanager.projects.get`
• Crie ou exclua glossários: `datacatalog.entryGroups.create`

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações, consulte Papéis predefinidos para o Data Catalog.

Criar e gerenciar glossários de negócios

Criar um glossário de negócios

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Clique em Criar glossário de negócios.
3. Na página Criar glossário de negócios, especifique um nome, local e descrição para o glossário.
   Os campos de nome e local são obrigatórios. Não é possível mudar o local depois de criar o glossário.
4. Clique em Criar.
   O glossário é criado no projeto atual, e a página do glossário é exibida.

Conferir a lista de glossários disponíveis

• No console do Google Cloud, acesse a página Glossários do Dataplex.
  Acessar "Glossários"
  O painel Meus glossários mostra todos os glossários da organização que você tem permissão para acessar, junto com as descrições e os carimbos de data/hora da última modificação.

Modificar um glossário

É possível modificar o nome e a descrição de um glossário.

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Clique no glossário que você quer modificar.
   • Para editar o nome, clique em Editar, digite um novo nome e clique em Salvar.
   • Para editar a descrição, clique em Editar descrição, insira uma nova descrição e clique em Salvar.

Excluir um glossário

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Clique no glossário que você quer excluir.
3. Clique em Excluir.
   Para confirmar sua ação, insira o nome do glossário e clique em Confirmar.

Criar e gerenciar categorias

Criar uma categoria em um glossário

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Selecione um glossário em que você quer criar uma categoria e clique emCriar categoria.
3. Na página Criar categoria, insira um nome e uma descrição para a categoria.
4. Clique em Criar.
   A página de detalhes da categoria é aberta.

Criar uma categoria em outra

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário em que você quer criar uma categoria.
3. Selecione a categoria mãe em que você quer criar outra categoria e clique em Criar categoria. É possível aninhar uma categoria em até três níveis.
4. Na página Criar categoria, insira um nome e uma descrição para a categoria.
5. Clique em Criar.
   A página de detalhes da categoria é aberta.

Conferir a lista de categorias disponíveis

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Para conferir a lista de categorias disponíveis em um glossário, abra o glossário.
3. Para conferir a lista de categorias aninhadas disponíveis, abra a categoria.

Atualizar uma categoria

É possível modificar o nome, a descrição, o administrador de dados e a categoria pai da categoria atual.

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário e clique na categoria que você quer modificar.
   1. Para editar o nome, clique em Editare digite um novo nome.
   2. Para editar a descrição, clique em Editar descrição e insira uma nova descrição.
   3. Para editar a lista de administradores de dados, clique em Editar ao lado de Administrador de dados, forneça uma lista de e-mails de administradores de dados e clique em Salvar.
   4. Para editar a categoria, clique em Editar ao lado de Categoria.
      • Para mudar a categoria mãe, no campo Selecionar uma categoria, digite o nome de uma nova categoria mãe do glossário atual e selecione-a.
      • Para remover a categoria atual, selecione ---Nenhuma--- no campo Selecionar uma categoria.
        Clique em Salvar.

Excluir uma categoria

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário e clique na categoria que você quer excluir permanentemente.
   Um aviso é exibido informando que a exclusão é irreversível e que todos os termos e categorias abaixo da categoria atual serão movidos para o próximo nível.
   Para confirmar a exclusão, insira o nome da categoria e clique em Confirmar.

Criar e gerenciar termos

Criar um termo

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Selecione um glossário em que você quer criar um termo e clique emCriar termo.
3. Na página Criar termo, insira um nome e uma descrição para o termo.
4. Clique em Criar.
   A página de detalhes do termo é aberta.

Conferir a lista de termos disponíveis

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Para conferir a lista de termos disponíveis em um glossário, abra o glossário.

Acessar os detalhes de um termo

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Para conferir a lista de termos disponíveis em um glossário, abra o glossário.
3. Clique em um termo.
   A página de detalhes do termo mostra o nome, a descrição, os termos relacionados, os sinônimos e as entradas relacionadas.

Atualizar um termo

Você pode modificar o nome, a descrição e o administrador de dados de um termo.

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário e clique no termo que você quer modificar.
   1. Para editar o nome, clique em Editare digite um novo nome.
   2. Para editar a descrição, clique em Editar descrição e insira uma nova descrição.
   3. Para editar a lista de administradores de dados, clique em Editar ao lado de Administrador de dados, forneça uma lista de e-mails de administradores de dados e clique em Salvar.
   4. Para editar a categoria, clique em Editar ao lado de Categoria.
      • Para mudar a categoria mãe, no campo Selecionar uma categoria, digite o nome de uma nova categoria mãe do glossário atual e selecione-a.
      • Para remover a categoria atual, selecione ---Nenhuma--- no campo Selecionar uma categoria.
        Clique em Salvar.

Excluir um termo

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário e clique no termo que você quer excluir permanentemente.
   Um aviso é exibido informando que a exclusão é irreversível e que todas as relações associadas ao termo serão removidas.
   Para confirmar a exclusão, insira o nome do termo e clique em Confirmar.

É possível adicionar relações entre termos marcando-os como termos relacionados ou sinônimos. As listas de termos relacionados e sinônimos são exibidas na página de detalhes do termo.

1. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
2. Abra o glossário e clique no termo a que você quer anexar um sinônimo ou um termo relacionado.
3. Clique em Editar para Termos relacionadosou Sinônimos.
4. No campo Search glossary terms, insira o termo que você quer anexar e selecione o termo no resultado da pesquisa.
   O termo é anexado imediatamente quando você o seleciona.
5. Clique em Concluído.
6. No console do Google Cloud, acesse a página Glossários do Dataplex.
   Acessar "Glossários"
7. Abra o glossário e clique no termo para o qual você quer remover um sinônimo ou um termo relacionado.
8. Para remover um termo relacionado, siga estas etapas:
   1. Clique em Editar ao lado deTermos relacionados.
   2. No termo relacionado que você quer excluir, clique emExcluir . O anexo é excluído imediatamente.
   3. Clique em Concluído.
9. Para remover um sinônimo, siga estas etapas:
   1. Clique em Editar ao lado de Sinônimos.
   2. No sinônimo que você quer excluir, clique emExcluir. O anexo é excluído imediatamente.
   3. Clique em Concluído.

Gerenciar termos no nível da coluna

É possível anexar termos às colunas de entradas do Data Catalog que têm esquemas (por exemplo, tabelas e conjuntos de arquivos) para fornecer mais contexto sobre os dados da coluna.

Anexar termos a colunas

1. Navegue até uma entrada do Data Catalog que tenha um esquema.
2. Clique na guia Esquema.
3. Na coluna Condições comerciais, clique em Adicionar no campo em que você quer anexar os termos .
4. No campo Pesquisa de termos, insira o nome do termo e selecione-o no resultado da pesquisa. É possível selecionar vários termos.
5. Clique em Anexar termos.

Conferir os detalhes dos termos associados às colunas

1. Navegue até uma entrada do Data Catalog que tenha um esquema.
2. Clique na guia Esquema.
3. Na coluna Termos comerciais, clique no termo para conferir a descrição. Você também pode remover o termo ou navegar até a página de detalhes do termo usando as opções nessa janela.

Remover termos associados a colunas

1. Navegue até uma entrada do Data Catalog que tenha um esquema.
2. Clique na guia Esquema.
3. Na coluna Condições comerciais, clique em Excluir para o termo que você quer remover.
   Também é possível remover o termo anexado clicando nele e emRemover termo comercial > Confirmar.

Localizar glossários e termos

Para navegar pelo conteúdo do glossário de negócios, use a árvore de glossário e termos na página Glossáriosdo Dataplex.

Você pode usar a barra de filtro na página Glossários do Dataplex para localizar categorias por nome de exibição ou termos com base em um critério. O filtro retorna itens com atributos que correspondem à consulta de filtro. Também é possível usar os seguintes qualificadores:

• parent:VALUE: destaca os termos cujo nome ou descrição do glossário pai corresponde a VALUE. Por exemplo,parent:Finance destaca os termos conectados com o nome ou a descrição do glossário pai que contém a frase Finance.
• contact:VALUE: destaca os termos em que o responsável pelos dados é VALUE. Por exemplo, contact:johndoe@company.orgdestaca as entradas conectadas a termos com correspondência de administrador de dadosjohndoe@company.org.
• synonym:VALUE: destaca os termos que têm pelo menos um sinônimo com nome ou descrição correspondente a VALUE. Por exemplo, synonym:interest destaca os termos relacionados com nome ou descrição que contêm a frase interest.
• related_to:VALUE: destaca os termos que têm pelo menos um termo relacionado com nome ou descrição correspondente a VALUE. Por exemplo, related_to:discounting destaca os termos relacionados com nome ou descrição que contêm a frase discounting.

Pesquisar entradas de dados usando termos

É possível usar o conteúdo do glossário de negócios do Dataplex ao pesquisar entradas na página Pesquisa do Dataplex.

Os seguintes cenários de pesquisa são compatíveis:

• Pesquisa simples: a consulta de pesquisa é especificada como texto de formato livre que captura o nome ou a descrição do termo. Os resultados da pesquisa incluem entradas conectadas a um termo com nome ou descrição que corresponde à consulta de pesquisa. Esses resultados são mostrados com os resultados buscados das outras formas de correspondência que não estão relacionadas ao conteúdo do glossário de negócios.
• Pesquisa usando qualificadores: a consulta de pesquisa é especificada como term:VALUE. O resultado da pesquisa inclui entradas conectadas a um termo em que uma substring de nome, descrição ou administrador de dados corresponde a VALUE.

A seguir

• Crie conteúdo para o glossário de negócios.
• Descubra entradas de dados usando os termos do glossário anexados.