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

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.

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.

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