Glossários de negócios para AWS Glue Data Catalog

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.

aws glue associate-glossary-terms \
    --identifier asset-id \
    --glossary-term-identifiers '["term-id-1", "term-id-2"]'

Resultado do exemplo:

{
    "Identifier": "c2fymbu18rtsx5",
    "GlossaryTerms": [
        {"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
        {"Id": "gt-h4kp9wt6mq3v2n", "Name": "PII"}
    ]
}

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 \
    --identifier asset-id \
    --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