# Glossários de negócios para AWS Glue Data Catalog
**nota**
O contexto de negócios e a pesquisa semântica estão em demonstração para o AWS Glue e estão sujeitos a alterações.
Um glossário de negócios é um contêiner para termos de vocabulário controlados que definem os conceitos de negócios em sua organização. Associe os termos do glossário aos ativos do Data Catalog para enriquecê-los com significado comercial e melhorar a capacidade de descoberta por meio da pesquisa semântica.
## Criação de um glossário
Use `CreateGlossary` para criar um glossário de negócios.
```
aws glue create-glossary \
--name "Finance Data Definitions" \
--description "Standardized financial terms used across reporting and analytics"
```
Resultado do exemplo:
```
{
"Id": "gl-c9vq7sh2fk4t2h",
"Name": "Finance Data Definitions"
}
```
## Criar termos do glossário
Use `CreateGlossaryTerm` para adicionar termos a um glossário.
```
aws glue create-glossary-term \
--glossary-identifier {{glossary-id}} \
--name "Active User" \
--short-description "A user with at least one login in the last 30 days" \
--long-description "An account that has logged in at least once within the trailing 30-day window. Used as the standard engagement metric across all product teams."
```
Resultado do exemplo:
```
{
"Id": "gt-d7xm3np5rk2w9j",
"GlossaryId": "gl-c9vq7sh2fk4t2h",
"Name": "Active User"
}
```
## Associação de termos do glossário aos ativos
Use `AssociateGlossaryTerms` para associar os termos aos ativos do Data Catalog.
**nota**
Durante a demonstração, você pode associar no máximo 10 termos de glossário por ativo.
```
aws glue associate-glossary-terms \
--asset-identifier {{asset-id}} \
--glossary-term-identifiers '["{{term-id-1}}", "{{term-id-2}}"]'
```
Resultado do exemplo:
```
{
"AssetIdentifier": "{{asset-id}}",
"GlossaryTerms": ["{{term-id-1}}", "{{term-id-2}}"]
}
```
## Remoção de associações de termos do glossário
Use `DisassociateGlossaryTerms` para remover associações de termos de um ativo.
```
aws glue disassociate-glossary-terms \
--asset-identifier {{asset-id}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
## Associar termos do glossário a uma única coluna
O escopo de uma associação de termos do glossário pode ser definido como um único item de um formulário iterável, por exemplo, uma coluna de uma tabela, em vez de todo o ativo. Para isso, passe `--iterable-form-name` e `--item-identifier` junto com o identificador do ativo. Cada coluna é um único item do formulário iterável `columns` e o nome da coluna é o identificador do item.
**nota**
É possível associar até 5 termos do glossário por coluna.
```
aws glue associate-glossary-terms \
--asset-identifier {{asset-id}} \
--iterable-form-name columns \
--item-identifier {{column-name}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
A resposta retorna o nome do formulário iterável e o identificador do item junto com a lista atual de termos da coluna:
```
{
"AssetIdentifier": "{{asset-id}}",
"IterableFormName": "columns",
"ItemIdentifier": "{{column-name}}",
"GlossaryTerms": ["{{term-id}}"]
}
```
Para remover um termo de uma coluna, use o comando `disassociate-glossary-terms` com os mesmos parâmetros `--iterable-form-name` e `--item-identifier`. Os termos associados no nível do ativo e os termos associados em colunas individuais são independentes.
```
aws glue disassociate-glossary-terms \
--asset-identifier {{asset-id}} \
--iterable-form-name columns \
--item-identifier {{column-name}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
## Atualização de glossários e termos
As atualizações entram em vigor imediatamente e são refletidas nos resultados da pesquisa.
**Para atualizar um glossário**
Use `UpdateGlossary`:
```
aws glue update-glossary \
--identifier {{glossary-id}} \
--name "Enterprise Finance Glossary" \
--description "Updated standardized financial terms for enterprise reporting"
```
**Para atualizar um termo do glossário**
Use `UpdateGlossaryTerm`:
```
aws glue update-glossary-term \
--identifier {{term-id}} \
--name "Monthly Active User" \
--short-description "A user with at least one login in the last 30 days"
```
## Exclusão de glossários e termos
Exclua todos os termos do glossário antes de excluí-lo.
**Para excluir um termo do glossário**
Use `DeleteGlossaryTerm`:
```
aws glue delete-glossary-term \
--identifier {{term-id}}
```
**Para excluir um glossário**
Use `DeleteGlossary` depois de remover todos os termos:
```
aws glue delete-glossary \
--identifier {{glossary-id}}
```
## Lista de glossários e termos
`ListGlossaries` e `ListGlossaryTerms` suportam a paginação com `MaxResults` e `NextToken`.
**Para listar todos os glossários**
Execute o seguinte comando:
```
aws glue list-glossaries \
--max-results 10
```
Resultado do exemplo:
```
{
"Items": [
{"Id": "gl-c9vq7sh2fk4t2h", "Name": "Finance Data Definitions"},
{"Id": "gl-f8yn2bx7jl5r4k", "Name": "Marketing Glossary"}
]
}
```
**Para listar termos em um glossário**
Execute o seguinte comando:
```
aws glue list-glossary-terms \
--glossary-identifier {{glossary-id}} \
--max-results 10
```
Resultado do exemplo:
```
{
"GlossaryId": "gl-c9vq7sh2fk4t2h",
"Items": [
{"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
{"Id": "gt-j6rm4xv9np8w3t", "Name": "EBITDA"}
]
}
```
## Recuperação de detalhes do glossário e do termo
**Para recuperar um glossário**
Execute o seguinte comando:
```
aws glue get-glossary \
--identifier {{glossary-id}}
```
**Para recuperar um termo do glossário**
Execute o seguinte comando:
```
aws glue get-glossary-term \
--identifier {{term-id}}
```