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
<a name="catalog-metadata-forms"></a>

**Note**  
Le contexte commercial et la recherche sémantique sont en cours de prévisualisation AWS Glue et sont susceptibles d'être modifiés.

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
<a name="catalog-metadata-forms-defining"></a>

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
<a name="catalog-metadata-forms-put-form-type"></a>

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
<a name="catalog-metadata-forms-get-form-type"></a>

```
aws glue get-form-type --identifier DataResidency
```

## Joindre des formulaires aux actifs
<a name="catalog-metadata-forms-attaching"></a>

### Pour joindre un formulaire à une ressource
<a name="catalog-metadata-forms-put-attachment"></a>

`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
<a name="catalog-metadata-forms-get-asset-attachments"></a>

`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
<a name="catalog-metadata-forms-put-attachment-item"></a>

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
<a name="catalog-metadata-forms-retrieving-columns"></a>

### Pour répertorier les colonnes d'un actif
<a name="catalog-metadata-forms-list-iterable"></a>

```
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
<a name="catalog-metadata-forms-batch-get"></a>

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
<a name="catalog-metadata-forms-deleting"></a>

### Pour supprimer un attachement
<a name="catalog-metadata-forms-delete-attachment"></a>

```
aws glue delete-attachment \
    --asset-identifier {{asset-id}} \
    --attachment-name residencyInfo
```

### Pour supprimer une pièce jointe d'une colonne spécifique
<a name="catalog-metadata-forms-delete-attachment-item"></a>

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
<a name="catalog-metadata-forms-delete-form-type"></a>

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
<a name="catalog-metadata-forms-listing"></a>

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

Exemple de sortie :

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