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".
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 à 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
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_NUMBER
pelo 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
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.
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
OVERVIEW
por 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" } 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
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": [] }, } } } EOF
Substitua
OVERVIEW
por 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" } 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
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": [] }, } } } EOF
Substitua
OVERVIEW
por 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 links relacionados 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:Finance
devolve 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:Profit
devolve 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.com
devolve 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_API
pelo 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_ID
Substitua
OPERATION_ID
pelo 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_API
pordataplex.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_API
pordataplex.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.