Glosarios empresariales para AWS Glue Data Catalog

Un glosario empresarial es un contenedor de términos de vocabulario controlado que definen los conceptos empresariales de su organización. Asocie los términos de glosario a los activos del Catálogo de datos para enriquecerlos con un significado empresarial y mejorar la visibilidad mediante la búsqueda semántica.

Creación de un glosario

Utilice CreateGlossary para crear un glosario empresarial.

aws glue create-glossary \
    --name "Finance Data Definitions" \
    --description "Standardized financial terms used across reporting and analytics"

Ejemplo de código de salida:

{
    "Id": "gl-c9vq7sh2fk4t2h",
    "Name": "Finance Data Definitions"
}

Creación de términos de glosario

Utilice CreateGlossaryTerm para agregar términos a un glosario.

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."

Ejemplo de código de salida:

{
    "Id": "gt-d7xm3np5rk2w9j",
    "GlossaryId": "gl-c9vq7sh2fk4t2h",
    "Name": "Active User"
}

Asociación de términos de glosario a activos

Utilice AssociateGlossaryTerms para asociar términos a los activos del Catálogo de datos.

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

Ejemplo de código de salida:

{
    "AssetIdentifier": "asset-id",
    "GlossaryTerms": ["term-id-1", "term-id-2"]
}

Eliminación de asociaciones de términos de glosario

Utilice DisassociateGlossaryTerms para eliminar las asociaciones de términos de un activo.

aws glue disassociate-glossary-terms \
    --asset-identifier asset-id \
    --glossary-term-identifiers '["term-id"]'

Asociación de términos del glosario a una sola columna

Puede limitar la asociación de términos del glosario a un único elemento de forma iterable (por ejemplo, una columna de una tabla) en lugar de a todo el activo. Para ello, pase --iterable-form-name y --item-identifier junto con el identificador del activo. Cada columna es un único elemento del formulario iterable columns, y el nombre de la columna es el identificador del elemento.

aws glue associate-glossary-terms \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --item-identifier column-name \
    --glossary-term-identifiers '["term-id"]'

La respuesta repite el nombre del formulario iterable y el identificador del elemento junto con la lista de términos actual de la columna:

{
    "AssetIdentifier": "asset-id",
    "IterableFormName": "columns",
    "ItemIdentifier": "column-name",
    "GlossaryTerms": ["term-id"]
}

Para eliminar un término de una columna, use el comando disassociate-glossary-terms con los mismos parámetros --iterable-form-name y --item-identifier. Los términos asociados a cada activo y los términos asociados a columnas específicas son independientes.

aws glue disassociate-glossary-terms \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --item-identifier column-name \
    --glossary-term-identifiers '["term-id"]'

Actualización de glosarios y términos

Las actualizaciones se aplican de inmediato y se reflejan en los resultados de búsqueda.

Cómo actualizar un glosario

Utilice UpdateGlossary:

aws glue update-glossary \
    --identifier glossary-id \
    --name "Enterprise Finance Glossary" \
    --description "Updated standardized financial terms for enterprise reporting"

Cómo actualizar un término de glosario

Utilice 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"

Eliminación de glosarios y términos

Debe eliminar todos los términos de un glosario antes de eliminar el glosario.

Cómo eliminar un término de glosario

Utilice DeleteGlossaryTerm:

aws glue delete-glossary-term \
    --identifier term-id

Cómo eliminar un glosario

Utilice DeleteGlossary después de eliminar todos los términos:

aws glue delete-glossary \
    --identifier glossary-id

Consulta de glosarios y términos

Tanto ListGlossaries como ListGlossaryTerms admiten la paginación mediante MaxResults y NextToken.

Cómo consultar todos los glosarios

Use el siguiente comando:

aws glue list-glossaries \
    --max-results 10

Ejemplo de código de salida:

{
    "Items": [
        {"Id": "gl-c9vq7sh2fk4t2h", "Name": "Finance Data Definitions"},
        {"Id": "gl-f8yn2bx7jl5r4k", "Name": "Marketing Glossary"}
    ]
}

Cómo consultar los términos en un glosario

Use el siguiente comando:

aws glue list-glossary-terms \
    --glossary-identifier glossary-id \
    --max-results 10

Ejemplo de código de salida:

{
    "GlossaryId": "gl-c9vq7sh2fk4t2h",
    "Items": [
        {"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
        {"Id": "gt-j6rm4xv9np8w3t", "Name": "EBITDA"}
    ]
}

Recuperación del glosario y los detalles de los términos

Cómo recuperar un glosario

Use el siguiente comando:

aws glue get-glossary \
    --identifier glossary-id

Cómo recuperar un término de glosario

Use el siguiente comando:

aws glue get-glossary-term \
    --identifier term-id