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

## 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 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"}
    ]
}
```