Faça a gestão de um glossário empresarial

O glossário empresarial do Dataplex Universal Catalog oferece um único local para gerir a terminologia e as definições relacionadas com a empresa em toda a sua empresa.

Quando diferentes equipas trabalham num projeto partilhado ou uma grande empresa tem muitos departamentos, é comum cada parte da empresa criar a sua própria terminologia para descrever os vários recursos de dados com os quais trabalha. Isto pode resultar em falhas de comunicação e numa compreensão inconsistente desses recursos. Além disso, por vezes, um conceito pode exigir conhecimentos técnicos ou especializados. Isto pode dificultar a compreensão do conceito por parte dos utilizadores empresariais noutros domínios.

O glossário empresarial do catálogo universal do Dataplex permite-lhe criar um vocabulário central e padronizado para os seus recursos de dados. Pode usar um glossário empresarial para fazer o seguinte:

  • Definir uma estrutura hierárquica de categorias empresariais e conceitos, denominada termos.
  • Crie associações entre conceitos definindo sinónimos e termos relacionados.
  • Associe os seus recursos de dados a termos no glossário, o que lhe permite pesquisar recursos de dados com base em conceitos empresariais.

Um glossário empresarial ajuda a simplificar a descoberta de dados e a reduzir a ambiguidade, o que pode levar a uma análise mais precisa, uma melhor governação e estatísticas mais rápidas.

Elementos de um glossário empresarial

Esta secção descreve os principais elementos que pode usar para estruturar um glossário empresarial.

Glossário

Um glossário tem as seguintes propriedades:

  • Vista Geral. Descreve a finalidade e o conteúdo do glossário empresarial. Pode adicionar imagens, links, tabelas ou texto formatado ao glossário. O tamanho máximo suportado é de 120 KB.
  • Descrição. Descreve o glossário. O texto neste campo é indexado para a pesquisa. O tamanho máximo suportado é de 1 KB.
  • Região. Especifica a região onde o glossário está localizado.

Categoria

Uma categoria permite-lhe organizar e estruturar várias categorias e termos. As categorias são definidas num glossário empresarial. Pode aninhar categorias até três níveis.

Uma categoria tem as propriedades de um glossário, bem como as seguintes propriedades:

  • Contactos. Especifica a pessoa responsável pela manutenção da categoria. Esta propriedade é descritiva e não afeta as autorizações da categoria.
  • Anunciante. Especifica uma relação que é usada para estabelecer o elemento principal da categoria atual. Pode aninhar até três categorias.

A região de uma categoria é a mesma que a região do glossário que a contém.

Vigência

Um termo (abreviatura de "termo do glossário") descreve um conceito usado num ramo específico da empresa. Por exemplo, o departamento de marketing de uma empresa pode criar um termo que descreva o custo por clique. Os termos são definidos num glossário empresarial, diretamente no glossário ou em qualquer categoria encontrada no glossário.

Um termo tem as propriedades de uma categoria, bem como as seguintes propriedades:

  • Sinónimos. Especifica associações entre termos que têm o mesmo significado. Consulte os termos sinónimos.
  • Termos relacionados. Especifica links entre termos que estão conceptualmente relacionados entre si, mas que têm significados diferentes. Consulte os termos relacionados.
  • Entradas relacionadas. Especifica associações entre termos e recursos de dados ou entre termos e colunas em recursos de dados.
  • Contactos. Especifica a pessoa responsável pela manutenção do termo. Os termos não herdam os contactos definidos nas categorias.

A região de um termo é a mesma que a região do glossário que o contém.

Termos sinónimos

Um sinónimo é uma relação que indica equivalência entre dois termos diferentes. Use sinónimos quando dois termos com o mesmo significado são definidos por equipas diferentes em glossários diferentes. Por exemplo, pode criar um sinónimo para associar os termos "lucro" e "ganhos".

Um termo relacionado é uma relação que indica que dois termos estão associados, mas têm significados diferentes. Por exemplo, pode criar um termo relacionado para associar os termos "receita" e "lucro".

Limitações

Funções necessárias

Para receber as autorizações de que precisa para criar e gerir glossários, peça ao seu administrador para lhe conceder as seguintes funções de IAM no seu projeto:

  • Para os administradores de dados, obtenha acesso total a glossários, categorias, termos, sinónimos e termos relacionados, e defina políticas de IAM: Administrador do catálogo do Dataplex (roles/dataplex.catalogAdmin)
  • Para os administradores de dados ou os proprietários de dados, aceda à criação, edição ou eliminação de glossários, categorias, termos, associações entre termos, associações entre termos e recursos de dados, e à pesquisa: Editor do catálogo do Dataplex (roles/dataplex.catalogEditor)
  • Para analistas de dados ou consumidores de dados, obtenha acesso só de leitura a glossários, categorias, termos, associações entre termos e entre termos e recursos de dados, e pesquise: Visualizador do catálogo do Dataplex (roles/dataplex.catalogViewer)

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

Estas funções predefinidas contêm as autorizações necessárias para criar e gerir glossários. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para criar e gerir glossários:

  • Criar, ler, atualizar e eliminar um glossário empresarial, uma categoria e termos no seu projeto:
    • dataplex.glossaries.list
    • dataplex.glossaries.create
    • dataplex.glossaries.get
    • dataplex.glossaries.update
    • dataplex.glossaries.delete
    • dataplex.glossaryCategories.create
    • dataplex.glossaryCategories.list
    • dataplex.glossaryCategories.get
    • dataplex.glossaryCategories.update
    • dataplex.glossaryCategories.delete
    • dataplex.glossaryTerms.create
    • dataplex.glossaryTerms.list
    • dataplex.glossaryTerms.get
    • dataplex.glossaryTerms.update
    • dataplex.glossaryTerms.delete
  • Criar e eliminar associações de termos sinónimos no seu projeto:
    • dataplex.entryLinks.create no grupo de entradas do Dataplex Universal Catalog no projeto em que qualquer um dos termos do glossário está presente. O link é criado no grupo de entradas para o qual a autorização é concedida.
    • dataplex.entryGroups.useSynonymEntryLink no grupo de entradas do Dataplex Universal Catalog no projeto em que qualquer um dos termos do glossário está presente. O link é criado no grupo de entradas para o qual a autorização é concedida.
    • dataplex.glossaryTerms.use nos glossários cujos termos têm de ser associados.
    • dataplex.entryLinks.delete no grupo de entradas do Dataplex Universal Catalog no projeto em que o link está presente.
  • Crie e elimine associações de termos relacionadas no seu projeto:
    • dataplex.entryLinks.create no grupo de entradas do Dataplex Universal Catalog no projeto em que qualquer um dos termos do glossário está presente. O link é criado no grupo de entradas para o qual a autorização é concedida.
    • dataplex.entryGroups.useRelatedEntryLink no grupo de entradas do Dataplex Universal Catalog no projeto em que qualquer um dos termos do glossário está presente. O link é criado no grupo de entradas para o qual a autorização é concedida.
    • dataplex.entries.link no grupo de entradas do Dataplex Universal Catalog em projetos nos quais estão presentes entradas correspondentes a termos do glossário.
    • dataplex.entryLinks.delete no grupo de entradas do Dataplex Universal Catalog no projeto em que o link está presente.
  • Crie associações entre termos e recursos de dados ou colunas no seu projeto:
    • dataplex.entryLinks.create no grupo de entradas do sistema correspondente aos recursos de dados ou às colunas no projeto. A associação é criada no projeto para o qual a autorização é concedida.
    • dataplex.entryGroups.useDefinitionEntryLink no grupo de entradas do sistema correspondente aos recursos de dados ou às colunas no projeto. A associação é criada no projeto para o qual é concedida autorização.
    • dataplex.entries.link no grupo de entradas do sistema correspondente aos recursos de dados ou às colunas no projeto. A associação é criada no projeto para o qual a autorização é concedida.
    • dataplex.glossaryTerms.use no glossário cujo termo tem de ser associado.
    • dataplex.entryLinks.delete no grupo de entradas do sistema em que o link está presente.

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Para mais informações, consulte o artigo Funções de IAM do Dataplex Universal Catalog.

Crie e faça a gestão de glossários empresariais

As secções seguintes descrevem como criar, ver, editar e eliminar um glossário empresarial.

Crie um glossário empresarial

Consola

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

    Aceda aos glossários

  2. Clique em Criar glossário empresarial.

  3. Na página Criar glossário empresarial, especifique um nome e uma localização para o glossário empresarial. Depois de criar o glossário, não pode alterar a localização.

  4. Clique em Criar. O glossário é criado no projeto atual.

  5. Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).

REST

Quando cria um glossário, o catálogo universal do Dataplex cria uma entrada para representar o glossário.

  1. Crie o glossário.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto no qual quer criar o glossário
    • LOCATION_ID: o ID da localização onde quer criar o glossário
    • GLOSSARY_ID: o ID do glossário
    • DISPLAY_NAME: o nome a apresentar do glossário
    • DESCRIPTION: a descrição do glossário, até um máximo de 1024 carateres

  2. Opcional: adicione uma vista geral ao glossário.

    1. Procure a entrada do seu glossário:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
\
\&view=ALL

      Substitua PROJECT_NUMBER pelo número do projeto onde o glossário é criado.

    2. Adicione uma vista geral ao glossário:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
--data @- << EOF
{
"aspects": {
   "dataplex-types.global.overview": {
      "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
      "data": {
      "content": "OVERVIEW",
      "links": []
      },
   }
}
}
EOF

      Substitua OVERVIEW por texto simples ou HTML para descrever a categoria ou o termo do glossário.

Veja os glossários disponíveis

Consola

  • Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.

    Aceda aos glossários

    O painel Os meus glossários apresenta todos os glossários da organização que tem autorização para ver, juntamente com as respetivas descrições e indicações de data/hora da última modificação.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

Edite um glossário

Pode editar o nome e a descrição de um glossário.

Consola

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

    Aceda aos glossários

  2. Clique no glossário que quer editar.

  3. Clique em Editar junto ao nome, à descrição ou à vista geral e, de seguida, faça a alteração.

  4. Clique em Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Elimine um glossário

Antes de poder eliminar um glossário, tem de eliminar todas as categorias e termos no glossário.

Consola

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

    Aceda aos glossários

  2. Clique no glossário que quer eliminar.

  3. Clique em Eliminar e, de seguida, confirme quando lhe for pedido.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

Crie e faça a gestão de categorias

As secções seguintes descrevem como criar, ver, atualizar e eliminar categorias.

Crie uma categoria num glossário

Um glossário empresarial pode ter um máximo de 200 categorias.

Consola

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

    Aceda aos glossários

  2. Selecione o glossário no qual quer criar uma categoria e, de seguida, clique em Criar categoria.

  3. Introduza um nome para a categoria.

  4. Clique em Criar.

  5. Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).

REST

Quando cria uma categoria, o Dataplex Universal Catalog cria uma entrada para representar a categoria.

  1. Crie a categoria.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "CATEGORY_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Substitua o seguinte:

    • CATEGORY_ID: o ID da categoria
    • CATEGORY_DISPLAY_NAME: o nome a apresentar da categoria
    • CATEGORY_DESCRIPTION: a descrição da categoria

  2. Opcional: adicione uma vista geral à categoria.

    1. Procure a entrada da sua categoria:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Adicione uma vista geral à sua categoria:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Substitua OVERVIEW por texto simples ou HTML para descrever a categoria ou o termo do glossário.

  3. Opcional: adicione contactos

    1. Procure a entrada da sua categoria:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
\
\&view=ALL

    2. Atualize a entrada da sua categoria com contactos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Crie uma categoria aninhada

Um glossário empresarial pode ter um máximo de três níveis de categorias aninhados, excluindo o nível de glossário raiz.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário no qual quer criar uma categoria.

  3. Selecione a categoria principal na qual quer criar outra categoria e clique em Criar categoria.

  4. Introduza um nome para a categoria.

  5. Clique em Criar.

  6. Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

Substitua PARENT_CATEGORY_ID pelo ID da categoria principal.

Veja as categorias que pertencem a um glossário

Consola

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

    Aceda aos glossários

  2. Para ver as categorias num glossário, expanda o glossário.

  3. Para ver as categorias aninhadas numa categoria, expanda a categoria.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

Edite uma categoria

Pode editar o nome, a descrição e os contactos de uma categoria. Para categorias aninhadas, também pode editar a categoria principal.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique na categoria que quer editar.

  3. Clique em Editar junto ao nome, à descrição ou à vista geral e, de seguida, faça a alteração.

  4. Clique em Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Elimine uma categoria

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique na categoria que quer eliminar.

  3. Clique em Eliminar e, de seguida, confirme quando lhe for pedido.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

Crie e faça a gestão de termos

As secções seguintes descrevem como criar, ver, aceder, editar e eliminar termos.

Crie um termo num glossário empresarial

Um glossário empresarial pode ter um máximo de 5000 termos.

Consola

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

    Aceda aos glossários

  2. Para criar um termo ao nível do glossário, selecione o glossário no qual quer criar um termo e, de seguida, clique em Criar termo.

  3. Introduza um nome para o termo.

  4. Clique em Criar.

  5. Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).

  6. Opcional: para adicionar contactos, clique em Editar e, em seguida, faculte uma lista de endereços de email para os responsáveis pela gestão de dados, os proprietários dos dados ou os proprietários do domínio de dados. Em seguida, clique em Guardar.

REST

Quando cria um termo, o Dataplex Universal Catalog cria uma entrada para representar o termo.

  1. Crie o termo.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
}
EOF

    Substitua o seguinte:

    • TERM_ID: o ID do termo que está a criar
    • TERM_DISPLAY_NAME: o nome a apresentar do termo que está a criar
    • TERM_DESCRIPTION: a descrição do termo que está a criar

  2. Opcional: adicione uma vista geral ao termo.

    1. Procure a entrada do seu termo:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Adicione uma vista geral ao seu termo:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Substitua OVERVIEW por texto simples ou HTML para descrever a categoria ou o termo do glossário.

  3. Opcional: adicione contactos.

    1. Procure a entrada do seu termo:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Atualize a entrada do seu termo com contactos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Crie um termo numa categoria

Consola

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

    Aceda aos glossários

  2. Para criar um termo numa categoria, selecione a categoria onde quer criar um termo e, de seguida, clique em Adicionar termo.

  3. Introduza um nome para o termo.

  4. Clique em Criar.

  5. Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).

  6. Opcional: para adicionar contactos, clique em Editar e, em seguida, faculte uma lista de endereços de email para os responsáveis pela gestão de dados, os proprietários dos dados ou os proprietários do domínio de dados. Em seguida, clique em Guardar.

REST

Quando cria um termo, o Dataplex Universal Catalog cria uma entrada para representar o termo.

  1. Crie um termo.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
{
"displayName": "TERM_DISPLAY_NAME",
"description": "TERM_DESCRIPTION",
"parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

    Substitua o seguinte:

    • TERM_ID: o ID do termo que está a criar
    • TERM_DISPLAY_NAME: o nome a apresentar do termo que está a criar
    • TERM_DESCRIPTION: a descrição do termo que está a criar

  2. Opcional: adicione uma vista geral ao termo.

    1. Procure a entrada do seu termo:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Adicione uma vista geral ao seu termo:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
\
--data @- << EOF
{
"aspects": {
"dataplex-types.global.overview": {
   "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
",
   "data": {
   "content": "OVERVIEW",
   "links": []
   },
}
}
}
EOF

      Substitua OVERVIEW por texto simples ou HTML para descrever a categoria ou o termo do glossário.

  3. Opcional: adicione contactos.

    1. Procure a entrada do seu termo:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
:lookupEntry\
?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
\
\&view=ALL

    2. Atualize a entrada do seu termo com contactos:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
?update_mask=aspects\
\&deleteMissingAspects=false\
\&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
--data @- << EOF
{
"aspects": {
"dataplex-types.global.contacts": {
   "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
   "data": {
   "identities": [
      {
         "role": "steward",
         "name": "CONTACT_NAME",
         "id": "CONTACT_EMAIL"
      }
   ]
   },
}
}
}
EOF

Veja os termos num glossário ou numa categoria

Consola

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

    Aceda aos glossários

  2. Para ver os termos num glossário, expanda o glossário. Para ver os termos numa categoria deste glossário, expanda a categoria. Para ver os termos numa categoria aninhada, expanda a categoria aninhada.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

Veja os detalhes de um termo

Consola

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

    Aceda aos glossários

  2. Para ver a lista de termos num glossário, expanda o glossário.

  3. Clique num termo. A página Detalhes do termo apresenta o nome do termo, a descrição, os termos relacionados, os sinónimos e as entradas relacionadas.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Edite um termo

Pode editar o nome, a descrição, a vista geral, os contactos e o termo principal.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique no termo que quer editar.

  3. Clique em Edit.

  4. Edite qualquer um dos campos e clique em Guardar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

Elimine um termo

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique no termo que quer eliminar.

  3. Clique em Eliminar e, de seguida, confirme quando lhe for pedido.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Pode adicionar relações entre termos associando-os como sinónimos ou termos relacionados.

As relações entre termos são bidirecionais. Por exemplo, quando associa profit como sinónimo de earnings, earnings também se torna um sinónimo de profit.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique no termo com o qual quer criar associações.

  3. Clique em Editar junto a Termos sinónimos.

  4. Pesquise e, em seguida, selecione os termos aos quais quer criar um link.

    O termo é associado imediatamente quando o seleciona.

  5. Clique em Fechar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Substitua o seguinte:

  • TERM1_PROJECT_NUMBER: o número do projeto do primeiro mandato a ser associado.
  • TERM1_LOCATION_ID: o ID da localização do glossário que contém o primeiro termo.
  • TERM1_GLOSSARY_ID: o ID do glossário que contém o primeiro termo.
  • TERM1_ID: o ID do primeiro termo.
  • TERM2_PROJECT_NUMBER: o número do projeto do segundo termo que quer associar como um termo sinónimo. Se ambos os termos estiverem no mesmo projeto, este valor é igual ao número do projeto do primeiro termo.
  • TERM2_LOCATION_ID: o ID da localização do glossário que contém o segundo termo. Se ambos os termos estiverem na mesma localização, este valor é igual ao ID de localização do primeiro termo.
  • TERM2_GLOSSARY_ID: o ID do glossário que contém o segundo termo. Se ambos os termos estiverem no mesmo glossário, este valor é igual ao ID do glossário do primeiro termo.
  • TERM2_ID: o ID do segundo termo.
  • ENTRY_LINK_ID: um ID para a associação entre os dois termos. Cada termo é representado como uma entrada do Dataplex Universal Catalog. O link de entrada é a relação entre termos sinónimos.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique no termo com o qual quer criar associações.

  3. Clique em Editar junto a Termos relacionados.

  4. Pesquise e, em seguida, selecione os termos aos quais quer criar um link.

    O termo é associado imediatamente quando o seleciona.

  5. Clique em Fechar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Substitua o seguinte:

  • TERM1_PROJECT_NUMBER: o número do projeto do primeiro prazo a ser associado.
  • TERM1_LOCATION_ID: o ID da localização do glossário que contém o primeiro termo.
  • TERM1_GLOSSARY_ID: o ID do glossário que contém o primeiro termo.
  • TERM1_ID: o ID do primeiro termo.
  • TERM2_PROJECT_NUMBER: o número do projeto do segundo termo que quer associar como termo relacionado. Se ambos os termos estiverem no mesmo projeto, este valor é igual ao número do projeto do primeiro termo.
  • TERM2_LOCATION_ID: o ID da localização do glossário que contém o segundo termo. Se ambos os termos estiverem na mesma localização, este valor é igual ao ID de localização do primeiro termo.
  • TERM2_GLOSSARY_ID: o ID do glossário que contém o segundo termo. Se ambos os termos estiverem no mesmo glossário, este valor é igual ao ID do glossário do primeiro termo.
  • TERM2_ID: o ID do segundo termo.
  • ENTRY_LINK_ID: um ID para a associação entre os dois termos. Cada termo é representado como uma entrada do Dataplex Universal Catalog. O link de entrada é a relação entre termos relacionados.

Consola

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

    Aceda aos glossários

  2. Expanda o glossário e clique no termo cujos sinónimos ou termos relacionados quer remover.

  3. Para eliminar associações entre termos relacionados, clique em Editar junto a Termos relacionados. Elimine os termos relacionados e, de seguida, clique em Fechar.

  4. Para eliminar associações entre sinónimos, clique em Editar junto a Termos sinónimos. Elimine os sinónimos e, de seguida, clique em Fechar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Pode anexar termos a recursos de dados ou colunas de recursos de dados. Por exemplo, pode anexar termos a um conjunto de dados do BigQuery.

Consola

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

    Aceda à pesquisa

  2. Pesquise o recurso de dados (como um conjunto de dados, um ficheiro ou uma tabela) ao qual quer associar um termo e, de seguida, clique nele.

  3. Na página do recurso de dados, faça uma das seguintes ações:

    • Para associar termos a um recurso, no separador Detalhes, na secção Termos do glossário, clique em Adicionar. Pesquise e, de seguida, selecione os termos e clique em Fechar.
    • Se o recurso tiver um esquema, pode associar termos a uma coluna. No separador Esquema, selecione uma coluna para associar termos e, de seguida, clique em Adicionar termo empresarial. Pesquise e, de seguida, selecione os termos e clique em Fechar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

Substitua o seguinte:

  • PROJECT_NUMBER: o número do projeto do recurso de dados que está a ser associado
  • ENTRY_LOCATION_ID: o ID da localização do recurso de dados que está a ser associado
  • ENTRY_GROUP_ID: o grupo de entrada do recurso de dados que está a ser associado
  • ENTRY_LINK_ID: um ID para a associação entre o termo e a entrada do Dataplex Universal Catalog que representa o recurso de dados.
  • TERM_PROJECT_NUMBER: o número do projeto do termo que está a ser associado.

Anexe termos a uma coluna num esquema de entrada

Consola

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

    Aceda à pesquisa

  2. Pesquise o recurso de dados (como um conjunto de dados, um ficheiro ou uma tabela) que tenha um esquema com uma coluna à qual quer associar um termo. Clique no recurso de dados.

  3. Na página do recurso de dados, faça uma das seguintes ações:

    • Para associar termos a uma coluna no recurso de dados, no separador Esquema, selecione as colunas às quais quer anexar o termo.
    • Clique em Adicionar termo empresarial. Pesquise o termo que quer anexar e clique no termo para o anexar.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
"entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
"entry_references": [{
  "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE",
  "path": "Schema.COLUMN_NAME",
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

Substitua o seguinte:

  • PROJECT_NUMBER: o número do projeto do recurso de dados que está a ser associado
  • ENTRY_LOCATION_ID: o ID da localização do recurso de dados que está a ser associado
  • ENTRY_GROUP_ID: o grupo de entrada do recurso de dados que está a ser associado
  • ENTRY_LINK_ID: um ID para a associação entre o termo e a entrada do Dataplex Universal Catalog que representa o recurso de dados
  • TERM_PROJECT_NUMBER: o número do projeto do termo que está a ser associado
  • COLUMN_NAME: a coluna à qual quer anexar o termo

Consola

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

    Aceda à pesquisa

  2. Pesquise o recurso de dados (como um conjunto de dados, um ficheiro ou uma tabela) do qual quer remover os termos e clique nele.

  3. Na página do recurso de dados, faça uma das seguintes ações:

    • Para remover um termo de um recurso, no separador Detalhes, na secção Termos do glossário, clique no termo. Em seguida, clique em .
    • Para remover um termo de uma coluna, no separador Esquema, clique em junto ao termo.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Encontre glossários, termos e recursos de dados associados

Consola

Para navegar no conteúdo do glossário empresarial, use a árvore de glossários e termos na página Glossários.

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

    Aceda aos glossários

  2. Na página Glossários, use a barra de filtros para encontrar categorias. Estão disponíveis os seguintes filtros:

    • Nome: devolve os glossários, as categorias e os termos cujo nome contém o texto que fornece.
    • Parent: devolve os termos cujo nome ou descrição do glossário principal corresponde ao texto que fornece. Por exemplo, parent:Finance devolve os termos associados ao glossário principal cujo nome ou descrição contém a expressão Finance.
    • Sinónimo: devolve a lista de termos com um sinónimo cujo nome ou ID contém o texto que indicar. Por exemplo, synonym:Profit devolve os termos que têm um termo sinónimo cujo nome ou ID contém a expressão profit.
    • Contacto: devolve os termos em que o responsável pelos dados está listado como um contacto. Por exemplo, contact:alex@example.com devolve as entradas que estão ligadas a termos com um administrador de dados correspondente a alex@example.com.

REST

Para encontrar glossários, termos e recursos de dados associados através da API REST, tem de inscrever-se na pré-visualização.

Pesquise recursos de dados associados a termos

Consola

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

    Aceda aos glossários

  2. Na página Glossários, use a barra de filtros para introduzir uma consulta de pesquisa de texto de forma livre. Isto devolve uma lista de correspondências correspondentes nos nomes do glossário, da categoria e do termo.

  3. Clique num termo correspondente.

  4. Na página Detalhes do termo, veja os termos associados (sinónimos e termos relacionados) e as entradas associadas (recursos de dados) a este termo.

  5. Se quiser ver os detalhes de uma entrada no Dataplex Universal Catalog, clique na entrada.

REST

Para encontrar glossários, termos e recursos de dados associados através da API REST, tem de inscrever-se na pré-visualização.

Para importar glossários e associações de outra ferramenta de catalogação ou para atualizar os seus glossários no Dataplex Universal Catalog, pode importar em massa glossários, categorias, termos, associações entre termos, associações entre termos e recursos de dados ou colunas através da API REST.

  1. Crie o glossário de destino.

    REST

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF

{
 "displayName": "DISPLAY_NAME",
 "description": "DESCRIPTION"
}
EOF
)"

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto no qual está a criar o glossário
    • LOCATION_ID: a localização na qual queremos criar o glossário
    • GLOSSARY_ID: o ID do glossário
    • DISPLAY_NAME: o nome a apresentar do glossário
    • DESCRIPTION: a descrição do glossário

  2. Para importar categorias, termos e associações entre termos e recursos de dados no glossário de destino criado, carregue ficheiros para cada um destes elementos num contentor do Cloud Storage. Estes ficheiros têm o seguinte formato:

    • Formato de exemplo para termos e categorias de um glossário

       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
 {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}

    • Formato de amostra para links entre termos

       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}

    • Formato de exemplo para associações entre termos e recursos de dados

       projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
 {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
 
    # Set GCURL alias
alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "glossaries": "GLOSSARY_NAME"
     }
  }
}
EOF
)"

    Substitua DATAPLEX_API pelo ponto final da API Dataplex Universal Catalog no formato dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  3. Opcional: obtenha o estado da operação.

    gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

    Substitua OPERATION_ID pelo ID da operação.

  4. Opcional: obtenha o estado da tarefa de metadados.

    gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID

  5. Importe associações entre termos como sinónimos ou termos relacionados.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
  "type":"IMPORT",
  "import_spec":{
     "log_level":"DEBUG",
     "source_storage_uri":"gs://STORAGE_BUCKET/",
     "entry_sync_mode":"FULL",
     "aspect_sync_mode":"INCREMENTAL",
     "scope":{
        "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
        ],
        "entry_link_types":[
           "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
           "projects/dataplex-types/locations/global/entryLinkTypes/related"
        ],
        "referenced_entry_scopes":[
           "PROJECT_IDS"
        ]
     }
  }
}
EOF
)"

    Substituir DATAPLEX_API por dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  6. Importe associações entre termos e recursos de dados ou colunas.

    Para criar uma associação entre termos do glossário e recursos de dados, execute a tarefa de importação para cada grupo de entradas ao qual a entrada do recurso de dados pertence. Todos os links de entrada de definições são criados neste grupo de entradas.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
{
"type":"IMPORT",
"import_spec":{
  "log_level":"DEBUG",
  "source_storage_uri":"gs://STORAGE_BUCKET/",
  "entry_sync_mode":"FULL",
  "aspect_sync_mode":"INCREMENTAL",
  "scope":{
     "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
     ],
     "entry_link_types":[
        "projects/dataplex-types/locations/global/entryLinkTypes/definition"
     ],
     "referenced_entry_scopes":[
        "PROJECT_IDS"
     ]
  }
}
}
EOF
)"

    Substituir DATAPLEX_API por dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

Preços

A partir de julho de 2026, o glossário empresarial do catálogo universal do Dataplex vai ser faturado da mesma forma que os preços de armazenamento de metadados. Consulte os preços de armazenamento de metadados do Dataplex Universal Catalog.

O que se segue?