glossário empresarial para definir e organizar termos empresariais para os seus recursos de dados."
Este documento descreve como criar e gerir um glossário empresarial do Dataplex Universal Catalog no Dataplex Universal Catalog. Use um glossário empresarial para estabelecer um vocabulário padronizado para os seus recursos de dados, o que reduz a ambiguidade e melhora a deteção e a gestão de dados em toda a sua organização.
Exemplos de utilização do glossário empresarial do Dataplex Universal Catalog
Ao criar uma linguagem comum para os dados através do glossário empresarial do catálogo universal do Dataplex, pode alcançar o seguinte:
- Definir uma hierarquia clara de categorias empresariais e termos.
- Associar conceitos através de sinónimos e mostrar relações entre termos.
- Pesquise recursos de dados com base em conceitos empresariais e não apenas em nomes técnicos.
O glossário empresarial do catálogo universal do Dataplex ajuda a simplificar a deteção de dados e a reduzir a ambiguidade, o que resulta numa melhor governação, numa análise mais precisa e em 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 e tabelas. Embora a formatação HTML não seja suportada, pode incluir código HTML formatado como código ou adicionar um link para uma página HTML. Também pode usar opções de formatação de texto formatado, como negrito, itálico, sublinhado, listas com marcas, parágrafos, cabeçalhos e blocos de código. O tamanho máximo suportado é de 120 KB.
Descrição. Descreve o glossário. O texto neste campo é indexado para pesquisa. O tamanho máximo suportado é de 1 KB.
Região. Especifica a região onde o glossário se encontra.
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 nos 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".
Termos relacionados
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
- O glossário empresarial do Dataplex Universal Catalog não é suportado para projetos do Assured Workload.
- Os glossários empresariais estão alojados em projetos e localizações. As limitações para projetos e localizações aplicam-se aos glossários.
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 pesquise:
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
As seguintes autorizações são necessárias 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.createno 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.useSynonymEntryLinkno 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.usenos glossários cujos termos têm de ser associados. -
dataplex.entryLinks.deleteno grupo de entradas do Dataplex Universal Catalog no projeto em que a associação está presente.
-
-
Crie e elimine associações de termos relacionadas no seu projeto:
-
dataplex.entryLinks.createno 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.useRelatedEntryLinkno 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.linkno grupo de entradas do Dataplex Universal Catalog em projetos nos quais estão presentes entradas correspondentes a termos do glossário. -
dataplex.entryLinks.deleteno grupo de entradas do Dataplex Universal Catalog no projeto em que a associação está presente.
-
-
Crie associações entre termos e recursos de dados ou colunas no seu projeto:
-
dataplex.entryLinks.createno 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.useDefinitionEntryLinkno 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.linkno 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.useno glossário cujo termo tem de ser associado. -
dataplex.entryLinks.deleteno 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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Clique em Criar glossário empresarial.
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.
Clique em Criar. O glossário é criado no projeto atual.
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.
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árioLOCATION_ID: o ID da localização onde quer criar o glossárioGLOSSARY_ID: o ID do glossárioDISPLAY_NAME: o nome a apresentar do glossárioDESCRIPTION: a descrição do glossário, até um máximo de 1024 carateres
Opcional: adicione uma vista geral ao glossário.
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_NUMBERpelo número do projeto onde o glossário é criado.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
OVERVIEWpor 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.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Clique no glossário que quer editar.
Clique em Editar junto ao nome, à descrição ou à vista geral e, de seguida, faça a alteração.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Clique no glossário que quer eliminar.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Selecione o glossário no qual quer criar uma categoria e, de seguida, clique em Criar categoria.
Introduza um nome para a categoria.
Clique em Criar.
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.
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 categoriaCATEGORY_DISPLAY_NAME: o nome a apresentar da categoriaCATEGORY_DESCRIPTION: a descrição da categoria
Opcional: adicione uma vista geral à categoria.
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
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
OVERVIEWpor texto simples ou HTML para descrever a categoria ou o termo do glossário.
Opcional: adicione contactos
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
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário no qual quer criar uma categoria.
Selecione a categoria principal na qual quer criar outra categoria e clique em Criar categoria.
Introduza um nome para a categoria.
Clique em Criar.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Para ver as categorias num glossário, expanda o glossário.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique na categoria que quer editar.
Clique em Editar junto ao nome, à descrição ou à vista geral e, de seguida, faça a alteração.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique na categoria que quer eliminar.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
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.
Introduza um nome para o termo.
Clique em Criar.
Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).
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.
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" } EOFSubstitua 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
Opcional: adicione uma vista geral ao termo.
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
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": [] }, } } } EOFSubstitua
OVERVIEWpor texto simples ou HTML para descrever a categoria ou o termo do glossário.
Opcional: adicione contactos.
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
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Para criar um termo numa categoria, selecione a categoria onde quer criar um termo e, de seguida, clique em Adicionar termo.
Introduza um nome para o termo.
Clique em Criar.
Opcional: adicione uma breve descrição em Descrição (até 1024 carateres) ou uma descrição detalhada em Vista geral (até 120 KB).
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.
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" } EOFSubstitua 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
Opcional: adicione uma vista geral ao termo.
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
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": [] }, } } } EOFSubstitua
OVERVIEWpor texto simples ou HTML para descrever a categoria ou o termo do glossário.
Opcional: adicione contactos.
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
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Para ver a lista de termos num glossário, expanda o glossário.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique no termo que quer editar.
Clique em Edit.
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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique no termo que quer eliminar.
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
Faça a gestão de sinónimos e termos relacionados
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.
Crie associações de sinónimos entre termos
Consola
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique no termo com o qual quer criar associações.
Clique em Editar junto a Termos sinónimos.
Pesquise e, em seguida, selecione os termos aos quais quer criar um link.
O termo é associado imediatamente quando o seleciona.
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.
Crie associações relacionadas entre termos
Consola
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique no termo com o qual quer criar associações.
Clique em Editar junto a Termos relacionados.
Pesquise e, em seguida, selecione os termos aos quais quer criar um link.
O termo é associado imediatamente quando o seleciona.
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.
Remova associações entre sinónimos e termos relacionados
Consola
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
Expanda o glossário e clique no termo cujos sinónimos ou termos relacionados quer remover.
Para eliminar associações entre termos relacionados, clique em Editar junto a Termos relacionados. Elimine os termos relacionados e, de seguida, clique em Fechar.
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
Faça a gestão das associações entre termos e recursos de dados
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.
Anexe termos a um recurso de dados
Consola
Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.
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.
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 associadoENTRY_LOCATION_ID: o ID da localização do recurso de dados que está a ser associadoENTRY_GROUP_ID: o grupo de entrada do recurso de dados que está a ser associadoENTRY_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
Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.
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.
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 associadoENTRY_LOCATION_ID: o ID da localização do recurso de dados que está a ser associadoENTRY_GROUP_ID: o grupo de entrada do recurso de dados que está a ser associadoENTRY_LINK_ID: um ID para a associação entre o termo e a entrada do Dataplex Universal Catalog que representa o recurso de dadosTERM_PROJECT_NUMBER: o número do projeto do termo que está a ser associadoCOLUMN_NAME: a coluna à qual quer anexar o termo
Remova termos de um recurso de dados
Consola
Na Google Cloud consola, aceda à página Pesquisa do Dataplex Universal Catalog.
Pesquise o recurso de dados (como um conjunto de dados, um ficheiro ou uma tabela) do qual quer remover os termos e clique nele.
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.
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
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:Financedevolve os termos associados ao glossário principal cujo nome ou descrição contém a expressãoFinance. - Sinónimo: devolve a lista de termos com um sinónimo cujo nome ou ID
contém o texto que indicar. Por exemplo,
synonym:Profitdevolve os termos que têm um termo sinónimo cujo nome ou ID contém a expressãoprofit. - Contacto: devolve os termos em que o responsável pelos dados está listado como um contacto. Por exemplo,
contact:alex@example.comdevolve as entradas que estão ligadas a termos com um administrador de dados correspondente aalex@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
Na Google Cloud consola, aceda à página Glossários do Dataplex Universal Catalog.
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.
Clique num termo correspondente.
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.
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.
Importe glossários e associações entre termos e termos ou recursos de dados
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.
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árioLOCATION_ID: a localização na qual queremos criar o glossárioGLOSSARY_ID: o ID do glossárioDISPLAY_NAME: o nome a apresentar do glossárioDESCRIPTION: a descrição do glossário
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_APIpelo ponto final da API Dataplex Universal Catalog no formatodataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.Opcional: obtenha o estado da operação.
gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_IDSubstitua
OPERATION_IDpelo ID da operação.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
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_APIpordataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.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_APIpordataplex.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?
- Se estiver a usar a versão de pré-visualização do glossário empresarial para o Data Catalog, consulte o artigo Transição para o glossário empresarial no Dataplex Universal Catalog.