Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Glossaires commerciaux pour AWS Glue Data Catalog
**Note**
Le contexte commercial et la recherche sémantique sont en cours d'aperçu AWS Glue et sont sujets à modification.
Un glossaire métier est un contenant contenant des termes de vocabulaire contrôlé qui définissent les concepts commerciaux au sein de votre organisation. Associez les termes du glossaire aux actifs du catalogue de données pour leur donner un sens commercial et améliorer leur visibilité grâce à la recherche sémantique.
## Création d'un glossaire
`CreateGlossary`À utiliser pour créer un glossaire commercial.
```
aws glue create-glossary \
--name "Finance Data Definitions" \
--description "Standardized financial terms used across reporting and analytics"
```
Exemple de sortie :
```
{
"Id": "gl-c9vq7sh2fk4t2h",
"Name": "Finance Data Definitions"
}
```
## Création de termes du glossaire
Permet `CreateGlossaryTerm` d'ajouter des termes à un glossaire.
```
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."
```
Exemple de sortie :
```
{
"Id": "gt-d7xm3np5rk2w9j",
"GlossaryId": "gl-c9vq7sh2fk4t2h",
"Name": "Active User"
}
```
## Associer des termes du glossaire à des actifs
Utilisez `AssociateGlossaryTerms` pour associer des termes aux actifs du catalogue de données.
**Note**
Lors de la prévisualisation, vous pouvez associer un maximum de 10 termes du glossaire par ressource.
```
aws glue associate-glossary-terms \
--asset-identifier {{asset-id}} \
--glossary-term-identifiers '["{{term-id-1}}", "{{term-id-2}}"]'
```
Exemple de sortie :
```
{
"AssetIdentifier": "{{asset-id}}",
"GlossaryTerms": ["{{term-id-1}}", "{{term-id-2}}"]
}
```
## Supprimer les associations de termes du glossaire
Permet `DisassociateGlossaryTerms` de supprimer les associations de termes d'un actif.
```
aws glue disassociate-glossary-terms \
--asset-identifier {{asset-id}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
## Associer les termes du glossaire à une seule colonne
Vous pouvez définir une association de termes de glossaire à un seul élément d'un formulaire itérable, par exemple, une colonne d'un tableau, au lieu de l'ensemble de la ressource. Pour ce faire, transmettez `--iterable-form-name` et `--item-identifier` accompagnez l'identifiant de l'actif. Chaque colonne est un élément unique du formulaire `columns` itérable, et le nom de colonne est l'identifiant de l'élément.
**Note**
Vous pouvez associer un maximum de 5 termes du glossaire par colonne.
```
aws glue associate-glossary-terms \
--asset-identifier {{asset-id}} \
--iterable-form-name columns \
--item-identifier {{column-name}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
La réponse fait écho au nom du formulaire itérable et à l'identifiant de l'élément, ainsi qu'à la liste de termes actuelle de la colonne :
```
{
"AssetIdentifier": "{{asset-id}}",
"IterableFormName": "columns",
"ItemIdentifier": "{{column-name}}",
"GlossaryTerms": ["{{term-id}}"]
}
```
Pour supprimer un terme d'une colonne, utilisez la `disassociate-glossary-terms` commande avec `--iterable-form-name` les mêmes `--item-identifier` paramètres. Les termes associés au niveau de l'actif et les termes associés aux colonnes individuelles sont indépendants.
```
aws glue disassociate-glossary-terms \
--asset-identifier {{asset-id}} \
--iterable-form-name columns \
--item-identifier {{column-name}} \
--glossary-term-identifiers '["{{term-id}}"]'
```
## Mise à jour des glossaires et des termes
Les mises à jour prennent effet immédiatement et sont répercutées dans les résultats de recherche.
**Pour mettre à jour un glossaire**
Utilisation `UpdateGlossary` :
```
aws glue update-glossary \
--identifier {{glossary-id}} \
--name "Enterprise Finance Glossary" \
--description "Updated standardized financial terms for enterprise reporting"
```
**Pour mettre à jour un terme du glossaire**
Utilisation `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"
```
## Supprimer des glossaires et des termes
Vous devez supprimer tous les termes d'un glossaire avant de pouvoir supprimer le glossaire.
**Pour supprimer un terme du glossaire**
Utilisation `DeleteGlossaryTerm` :
```
aws glue delete-glossary-term \
--identifier {{term-id}}
```
**Pour supprimer un glossaire**
À utiliser `DeleteGlossary` après avoir supprimé tous les termes :
```
aws glue delete-glossary \
--identifier {{glossary-id}}
```
## Répertorier les glossaires et les termes
Les deux `ListGlossaryTerms` prennent `ListGlossaries` en charge la pagination avec `MaxResults` et. `NextToken`
**Pour répertorier tous les glossaires**
Exécutez la commande suivante :
```
aws glue list-glossaries \
--max-results 10
```
Exemple de sortie :
```
{
"Items": [
{"Id": "gl-c9vq7sh2fk4t2h", "Name": "Finance Data Definitions"},
{"Id": "gl-f8yn2bx7jl5r4k", "Name": "Marketing Glossary"}
]
}
```
**Pour répertorier des termes dans un glossaire**
Exécutez la commande suivante :
```
aws glue list-glossary-terms \
--glossary-identifier {{glossary-id}} \
--max-results 10
```
Exemple de sortie :
```
{
"GlossaryId": "gl-c9vq7sh2fk4t2h",
"Items": [
{"Id": "gt-d7xm3np5rk2w9j", "Name": "Active User"},
{"Id": "gt-j6rm4xv9np8w3t", "Name": "EBITDA"}
]
}
```
## Récupération du glossaire et des détails terminologiques
**Pour récupérer un glossaire**
Exécutez la commande suivante :
```
aws glue get-glossary \
--identifier {{glossary-id}}
```
**Pour récupérer un terme du glossaire**
Exécutez la commande suivante :
```
aws glue get-glossary-term \
--identifier {{term-id}}
```