Criar e gerenciar glossários de negócios do Dataplex

Este documento mostra 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 os termos às colunas de entradas de dados catalogadas.

É possível usar o glossário de negócios do Dataplex para fazer o seguinte:

  • Crie e mantenha glossários, categorias e termos de negócios.
  • Use categorias para representar estruturas hierárquicas de categorias e termos.
  • Estabelecer relações entre termos como sinônimos ou termos relacionados.
  • Anexar termos a colunas de entrada de dados.
  • Procure e filtre termos no glossário de negócios.
  • Mostra termos e entradas de dados relacionados a um determinado termo.
  • Pesquisa entradas de dados marcadas por um termo específico.
  • Mostra termos relacionados a uma determinada entrada de dados.

Terminologia

A terminologia a seguir é usada neste documento:

Glossário de negócios

O glossário de negócios é um repositório que fornece vocabulários apropriados e rege os termos comerciais de uma empresa, junto com as definições de termos associados e as relações entre os termos. Ela fornece um único local para manter e gerenciar os termos de negócios e suas definições. 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 dentro de um glossário de negócios. Ele permite que você organize e estruturar várias categorias e termos. Você pode aninhar categorias até três níveis. Estas são 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 de texto enriquecido da categoria em formato livre.
  • 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. Ela descreve um conceito usado ramo específico de negócios dentro de uma empresa. Um termo tem o seguinte propriedades exibidas no console:

  • Categoria: uma relação usada para estabelecer o contêiner do termo atual, se houver.
  • Descrição: uma definição comercial em rich text em formato 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.

Você pode anexar termos com colunas de entrada de dados para indicar que as colunas são descritos nos respectivos 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ó tem suporte no console do Google Cloud.
  • Quando você pesquisa entradas de dados no a página Pesquisa do Dataplex, a o resultado da pesquisa inclui entradas de dados em que um dos termos associados a ele corresponde o termo usado para pesquisa. No entanto, a referência ao termo correspondente não é exibida no resultado da pesquisa.
  • Não é possível usar 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:

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 sobre os papéis e as permissões do Data Catalog, 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 alterar 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 é exibidos.

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 em que você tem permissão view. Os glossários são exibidos com os respectivos descrições e o horário 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 deseja modificar.

    • Para editar o nome, clique em . 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 a 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 em Criar 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 uma categoria

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar glossários

  2. Expanda o glossário em que você quer criar uma categoria.

  3. Selecione a categoria principal em que você quer criar outra. 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.

Acessar a lista de categorias disponíveis

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar "Glossários"

  2. Expanda um glossário para visualizar a lista de categorias disponíveis nele.

  3. Abra a categoria para conferir a lista de categorias aninhadas disponíveis.

Atualizar uma categoria

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

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar "Glossários"

  2. Expanda o glossário e clique na categoria que deseja modificar.

    1. Para editar o nome, clique em e insira 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 ao lado de Administrador, forneça uma lista de e-mails do administrador de dados e clique em Salvar.

    4. Para editar a categoria, clique em 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, no campo Selecionar uma categoria, selecione ---Nenhuma---.

      Clique em Salvar.

Excluir uma categoria

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar glossários

  2. Expanda 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, digite 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 em Criar 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.

Confira a lista de termos disponíveis

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar "Glossários"

  2. Abra um glossário para conferir a lista de termos disponíveis.

Acessar os detalhes de um termo

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar "Glossários"

  2. Abra um glossário para conferir a lista de termos disponíveis.

  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 e insira 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 ao lado de Administrador, forneça uma lista de e-mails do administrador de dados e clique em Salvar.

    4. Para editar a categoria, clique em 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, no campo Selecionar uma categoria, faça o seguinte: selecione ---None---.

      Clique em Salvar.

Excluir um termo

  1. No console do Google Cloud, acesse a página Glossários do Dataplex.

    Acessar "Glossários"

  2. Expanda o glossário e clique no termo que deseja 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, digite o nome do termo e clique em Confirmar.

Você pode adicionar relações entre termos marcando-os como termos relacionados ou sinônimos. As listas de termos e sinônimos relacionados 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. Expanda o glossário e clique no termo ao qual você deseja anexar um sinônimo ou um termo relacionado.

  3. Clique em para conferir os Termos relacionados. ou sinônimos.

  4. No campo Pesquisar termos do glossário, insira o termo que você quer anexar e selecionar o termo no resultado da pesquisa.

    O termo é anexado imediatamente quando você o seleciona.

  5. Clique em Concluído.

  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 para o qual você quer remover um sinônimo ou um termo relacionado.

  3. Para remover um termo relacionado, siga estas etapas:

    1. Clique em ao lado de Termos relacionados.

    2. Clique em para o termo relacionado que você quer excluir. O anexo é excluído imediatamente.

    3. Clique em Concluído.

  4. Para remover um sinônimo, siga estas etapas:

    1. Clique no ao lado de Sinônimos.

    2. Clique em no sinônimo que você quer excluir. 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 dar mais contexto sobre os dados da coluna.

Anexar termos às 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 no campo que você quer anexar as condições.

  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.

Veja os detalhes dos termos anexados à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 ver a descrição dele. Você também pode remover o termo ou acessar a página de detalhes dele usando o nessa janela.

Remover termos associados a colunas

  1. Acesse uma entrada do Data Catalog que tenha um esquema.

  2. Clique na guia Esquema.

  3. Na coluna Termos comerciais, clique em . para o termo que você quer remover.

    Você também pode remover o termo anexado clicando nele Remover termo de negócios > Confirmar.

Localizar glossários e termos

Para navegar pelo conteúdo do glossário da sua empresa, use o glossário e os termos árvore nos glossários do Dataplex página.

Use 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 qualquer atributo que corresponda à 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 VALUE:

    Por exemplo, parent:Finance destaca os termos conectados ao nome ou à descrição do glossário pai que contém a frase Finance.

  • contact:VALUE

    Destaca os termos em que o administrador de dados é VALUE.

    Por exemplo, contact:johndoe@company.org destaca as entradas conectadas aos termos com o administrador de dados correspondente a johndoe@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 termos 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 procurar entradas no Página Pesquisa do Dataplex.

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

  • Pesquisa simples: a consulta de pesquisa é especificada como um 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. Estes resultados são exibidos ao lado dos resultados obtidos de outras formas de correspondência que não estão relacionados 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