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.

Joindre des formulaires

Vous pouvez normaliser les métadonnées en définissant des types de formulaires, qui sont des modèles de schéma structurés réutilisables. Le schéma peut ensuite être renseigné en attachant des instances de ces formulaires aux ressources.

Définition des types de formulaires

Un type de formulaire définit le schéma à l'aide de la syntaxe Smithy IDL. Les noms doivent commencer par une majuscule.

structure DataResidency {
    region: String
    complianceFramework: String
    retentionDays: Integer
}

Pour créer un type de formulaire

Permet PutFormType de créer ou de mettre à jour un type de formulaire.

aws glue put-form-type \
    --name DataResidency \
    --schema 'structure DataResidency {
    region: String
    complianceFramework: String
    retentionDays: Integer
}'

Exemple de sortie :

{
    "Id": "DataResidency",
    "Name": "DataResidency"
}

Pour récupérer un type de formulaire

aws glue get-form-type --identifier DataResidency

Joindre des formulaires aux actifs

Pour joindre un formulaire à une ressource

PutAttachmentÀ utiliser avec l'identifiant de la ressource, le nom de la pièce jointe, l'ID du type de formulaire et le contenu JSON conformément au schéma.

aws glue put-attachment \
    --asset-identifier asset-id \
    --attachment-name residencyInfo \
    --form-type-id DataResidency \
    --content '{"region":"us-east-1","complianceFramework":"SOC2","retentionDays":730}'

Pour consulter les formulaires et les pièces jointes d'un actif

GetAssetÀ utiliser pour récupérer un actif ainsi que ses formulaires et pièces jointes.

La commande suivante permet de récupérer un actif :

aws glue get-asset --asset-identifier asset-id

Pour joindre un formulaire à une colonne

Vous pouvez joindre un formulaire à une seule colonne d'une ressource.

Chaque colonne est un élément unique du formulaire columns itérable dont le nom de colonne est l'identifiant de l'élément.

La commande suivante associe un formulaire à une colonne spécifique :

aws glue put-attachment \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --item-identifier region \
    --attachment-name sensitivity \
    --form-type-id DataClassification \
    --content '{"classification":"PII","sensitivity":"HIGH"}'

Après avoir joint le formulaire, utilisez-le SearchAssets pour découvrir la ressource à l'aide de tous les champs consultables du formulaire.

Récupération des métadonnées des colonnes

Pour répertorier les colonnes d'un actif

aws glue list-iterable-forms \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --max-results 20

Pour récupérer des colonnes spécifiques avec leurs formulaires

Permet BatchGetIterableForms de récupérer les colonnes et les formulaires joints en une seule demande.

aws glue batch-get-iterable-forms \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --item-identifiers region email

Supprimer des pièces jointes et des types de formulaires

Pour supprimer un attachement

aws glue delete-attachment \
    --asset-identifier asset-id \
    --attachment-name residencyInfo

Pour supprimer une pièce jointe d'une colonne spécifique

Pour supprimer un formulaire attaché à une seule colonne, exécutez la commande suivante. Transmettez le nom du formulaire itérable, l'identifiant de l'élément et le nom de la pièce jointe :

aws glue delete-attachment \
    --asset-identifier asset-id \
    --iterable-form-name columns \
    --item-identifier region \
    --attachment-name sensitivity

Pour supprimer un type de formulaire

Vous ne pouvez pas supprimer un type de formulaire qui est toujours référencé par un type de ressource.

aws glue delete-form-type --identifier DataResidency

Types de formulaires de mise en vente

aws glue list-form-types --max-results 20

Exemple de sortie :

{
    "Items": [
        {"Id": "DataResidency", "Name": "DataResidency"},
        {"Id": "DataClassification", "Name": "DataClassification"}
    ]
}