# Glosarios empresariales para AWS Glue Data Catalog
<a name="catalog-business-glossaries"></a>

**nota**  
El contexto empresarial y la búsqueda semántica se encuentran en una versión preliminar para AWS Glue, y están sujetos a cambios.

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
<a name="catalog-business-glossaries-create"></a>

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
<a name="catalog-business-glossaries-create-term"></a>

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
<a name="catalog-business-glossaries-associate"></a>

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

**nota**  
Durante la vista previa, puede asociar un máximo de 10 términos de glosario por recurso.

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

Ejemplo de código de salida:

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

## Eliminación de asociaciones de términos de glosario
<a name="catalog-business-glossaries-disassociate"></a>

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

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

## Actualización de glosarios y términos
<a name="catalog-business-glossaries-update"></a>

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
<a name="catalog-business-glossaries-delete"></a>

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
<a name="catalog-business-glossaries-list"></a>

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
<a name="catalog-business-glossaries-get"></a>

**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}}
```