Gerenciar glossários de negócios no Data Catalog

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

O glossário de negócios oferece um único lugar para manter e gerenciar terminologias e definições relacionadas aos negócios em toda a organização. Com ele, é possível anexar termos às colunas de entradas de dados catalogadas.

É possível usar o glossário de negócios do Dataplex Universal Catalog 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.
  • Estabeleça relações entre termos como sinônimos ou termos relacionados.
  • Anexe termos às colunas de entrada de dados.
  • Navegar e filtrar termos no glossário de negócios.
  • Mostra termos e entradas de dados relacionados a um determinado termo.
  • Pesquisar entradas de dados marcadas por um termo específico.
  • Mostra termos relacionados para uma determinada entrada de dados.

Terminologia

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

O glossário de negócios

O glossário de negócios é um repositório que fornece vocabulários adequados e governa os termos comerciais de uma empresa, além das definições de termos associados e das relações entre eles. Ele oferece um único lugar para manter e gerenciar termos comerciais 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 da finalidade 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. 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 comercial de texto livre e formatado 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 da 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 ramificação 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 comercial de rich text de 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.

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

Sinônimo

Um sinônimo é uma relação usada para indicar similaridade ou equivalência semântica 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 estão semanticamente relacionados, mas são diferentes. Por exemplo, profit e income.

Limitações

  • Não é possível importar termos em massa para um glossário empresarial.
  • O recurso de glossário empresarial só está disponível no console Google Cloud .
  • Quando você pesquisa entradas de dados na página Pesquisar do Dataplex Universal Catalog, o resultado inclui entradas em que um dos termos anexados corresponde ao termo usado na pesquisa. No entanto, a referência ao termo correspondente não é mostrada no resultado da pesquisa.
  • Não há suporte para regiões do BigQuery Omni. Não é possível criar conteúdo do glossário de negócios nem anexar termos a entradas de dados nessas regiões.
  • Ao usar o glossário de negócios no Data Catalog, não é possível anexar termos do glossário de negócios às colunas das entradas do catálogo universal.

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 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
  • Criar ou excluir 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

As seções a seguir descrevem como criar, visualizar, modificar e excluir um glossário de negócios.

Criar um glossário de negócios

  1. No console Google Cloud , acesse a página Glossários do Universal Catalog 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, um local e uma 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 dele é exibida.

Confira a lista de glossários disponíveis

  • No console Google Cloud , acesse a página Glossários do Universal Catalog 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, além das descrições e dos 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 Google Cloud , acesse a página Glossários do Universal Catalog 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 Google Cloud , acesse a página Glossários do Universal Catalog 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

As seções a seguir descrevem como criar, visualizar, atualizar e excluir categorias.

Criar uma categoria em um glossário

  1. No console Google Cloud , acesse a página Glossários do Universal Catalog 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 dentro de outra

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

    Acessar "Glossários"

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

  3. Selecione a categoria principal 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 Google Cloud , acesse a página Glossários do Universal Catalog do Dataplex.

    Acessar "Glossários"

  2. Para conferir a lista de categorias disponíveis em um glossário, expanda o glossário.

  3. Para conferir a lista de categorias aninhadas disponíveis, expanda a categoria.

Atualizar uma categoria

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

  1. No console Google Cloud , acesse a página Glossários do Universal Catalog 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 Editar e 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, 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 principal, no campo Selecionar uma categoria, insira o nome de uma nova categoria principal do glossário atual e selecione-a.

      • Para remover a categoria atual, no campo Selecione uma categoria, escolha ---Nenhuma---.

      Clique em Salvar.

Excluir uma categoria

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

    Acessar "Glossários"

  2. Abra o glossário e clique na categoria que você quer excluir permanentemente.

    Um aviso vai aparecer 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

As seções a seguir descrevem como criar, visualizar, acessar, atualizar e excluir um termo.

Criar um termo

  1. No console Google Cloud , acesse a página Glossários do Universal Catalog 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 Google Cloud , acesse a página Glossários do Universal Catalog do Dataplex.

    Acessar "Glossários"

  2. Para ver a lista de termos disponíveis em um glossário, expanda o glossário.

Acessar os detalhes de um termo

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

    Acessar "Glossários"

  2. Para ver a lista de termos disponíveis em um glossário, expanda 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

É possível modificar o nome, a descrição e o administrador de dados de um termo.

  1. No console Google Cloud , acesse a página Glossários do Universal Catalog 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 Editar e 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, 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 principal, no campo Selecionar uma categoria, insira o nome de uma nova categoria principal do glossário atual e selecione-a.

      • Para remover a categoria atual, no campo Selecionar uma categoria, selecione ---Nenhuma---.

      Clique em Salvar.

Excluir um termo

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

    Acessar "Glossários"

  2. Expanda o glossário e clique no termo que você quer excluir permanentemente.

    Um aviso vai aparecer 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.

Você pode adicionar relações entre termos marcando-os como relacionados ou sinônimos. As listas de termos relacionados e sinônimos são mostradas na página de detalhes do termo.

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

    Acessar "Glossários"

  2. Expanda 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 relacionados ou Sinônimos.

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

    O termo é anexado imediatamente quando você o seleciona.

  5. Clique em Concluído.

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

    Acessar "Glossários"

  2. Expanda 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 Editar ao lado de Termos relacionados.

    2. No termo relacionado que você quer excluir, clique em Excluir . O anexo é excluído imediatamente.

    3. Clique em Concluído.

  4. 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 em 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 (descontinuado) 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 Termos comerciais, clique em Adicionar no campo a que você quer anexar termos .

  4. No campo Pesquisa de termo, 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 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 navegar até a página de detalhes dele usando as opções nesta janela.

Remover termos anexados a colunas

  1. Navegue até uma entrada do Data Catalog que tenha um esquema.

  2. Clique na guia Esquema.

  3. Na coluna Termos comerciais, clique em Excluir no termo que você quer remover.

    Você também pode remover o termo anexado clicando nele e em Remover 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ários do Dataplex Universal Catalog.

Use a barra de filtro na página Glossários do Catálogo universal 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. Você também pode usar os seguintes qualificadores:

  • parent:VALUE: destaca os termos cujo nome ou descrição do glossário principal corresponde a VALUE. Por exemplo, parent:Finance destaca os termos conectados ao nome ou à descrição do glossário principal 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 a termos com correspondência de administrador de dados 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 que têm 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 que têm termos relacionados com nome ou descrição que contêm a frase discounting.

Pesquisar entradas de dados usando termos

Você pode usar o conteúdo do glossário de negócios do Dataplex Universal Catalog ao pesquisar entradas na página Pesquisa do Dataplex Universal Catalog.

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

  • Pesquisa simples: a consulta de pesquisa é especificada como texto 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 corresponda à consulta de pesquisa. Esses resultados são mostrados ao lado dos resultados extraídos de outras formas de correspondência que não estão relacionadas ao conteúdo do glossário de negócios.

  • Pesquisar 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