Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Allegare moduli
<a name="catalog-metadata-forms"></a>

**Nota**  
Il contesto aziendale e la ricerca semantica sono disponibili in anteprima AWS Glue e sono soggette a modifiche.

È possibile standardizzare i metadati definendo i tipi di modulo, che sono modelli di schemi strutturati e riutilizzabili. Lo schema può quindi essere compilato allegando istanze di questi moduli alle risorse.

## Definizione dei tipi di modulo
<a name="catalog-metadata-forms-defining"></a>

Un tipo di modulo definisce lo schema utilizzando la sintassi Smithy IDL. I nomi devono iniziare con una lettera maiuscola.

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

### Per creare un tipo di modulo
<a name="catalog-metadata-forms-put-form-type"></a>

Utilizzare `PutFormType` per creare o aggiornare un tipo di modulo.

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

Output di esempio:

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

### Per recuperare un tipo di modulo
<a name="catalog-metadata-forms-get-form-type"></a>

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

## Allegare moduli alle risorse
<a name="catalog-metadata-forms-attaching"></a>

### Per allegare un modulo a una risorsa
<a name="catalog-metadata-forms-put-attachment"></a>

Utilizzalo `PutAttachment` con l'identificatore della risorsa, il nome dell'allegato, l'ID del tipo di modulo e il contenuto JSON conforme allo schema.

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

## Recupero dei metadati delle colonne
<a name="catalog-metadata-forms-retrieving-columns"></a>

### Per elencare le colonne relative a una risorsa
<a name="catalog-metadata-forms-list-iterable"></a>

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

### Per recuperare colonne specifiche con i relativi moduli
<a name="catalog-metadata-forms-batch-get"></a>

Utilizzato `BatchGetIterableForms` per recuperare colonne e moduli allegati in un'unica richiesta.

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

## Eliminazione di allegati e tipi di modulo
<a name="catalog-metadata-forms-deleting"></a>

### Come eliminare un collegamento
<a name="catalog-metadata-forms-delete-attachment"></a>

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

### Per eliminare un tipo di modulo
<a name="catalog-metadata-forms-delete-form-type"></a>

Non è possibile eliminare un tipo di modulo a cui fa ancora riferimento un tipo di risorsa.

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

## Elenco dei tipi di modulo
<a name="catalog-metadata-forms-listing"></a>

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

Output di esempio:

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