Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Formulare anhängen
<a name="catalog-metadata-forms"></a>

**Anmerkung**  
Der Geschäftskontext und die semantische Suche befinden sich in der Vorversion AWS Glue und können sich ändern.

Sie können Metadaten standardisieren, indem Sie Formulartypen definieren, bei denen es sich um wiederverwendbare, strukturierte Schemavorlagen handelt. Das Schema kann dann aufgefüllt werden, indem Instanzen dieser Formulare an Assets angehängt werden.

## Definieren von Formulartypen
<a name="catalog-metadata-forms-defining"></a>

Ein Formulartyp definiert das Schema mithilfe der Smithy-IDL-Syntax. Namen müssen mit einem Großbuchstaben beginnen.

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

### Um einen Formulartyp zu erstellen
<a name="catalog-metadata-forms-put-form-type"></a>

Wird verwendet`PutFormType`, um einen Formulartyp zu erstellen oder zu aktualisieren.

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

Beispielausgabe:

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

### Um einen Formulartyp abzurufen
<a name="catalog-metadata-forms-get-form-type"></a>

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

## Anhängen von Formularen an Assets
<a name="catalog-metadata-forms-attaching"></a>

### Um ein Formular an ein Asset anzuhängen
<a name="catalog-metadata-forms-put-attachment"></a>

Verwenden Sie es `PutAttachment` zusammen mit der Asset-ID, dem Namen des Anhangs, der Formulartyp-ID und dem JSON-Inhalt, der dem Schema entspricht.

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

### Um die Formulare und Anlagen eines Assets anzuzeigen
<a name="catalog-metadata-forms-get-asset-attachments"></a>

Wird verwendet`GetAsset`, um ein Asset zusammen mit seinen Formularen und Anhängen abzurufen.

Mit dem folgenden Befehl wird ein Asset abgerufen:

```
aws glue get-asset --asset-identifier {{asset-id}}
```

### Um ein Formular an eine Spalte anzuhängen
<a name="catalog-metadata-forms-put-attachment-item"></a>

Sie können ein Formular an eine einzelne Spalte eines Assets anhängen.

Jede Spalte ist ein einzelnes Element des `columns` iterierbaren Formulars mit dem Spaltennamen als Element-ID.

Mit dem folgenden Befehl wird ein Formular an eine bestimmte Spalte angehängt:

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

Verwenden Sie nach dem Anhängen des Formulars, `SearchAssets` um das Asset anhand aller durchsuchbaren Felder im Formular zu finden.

## Spaltenmetadaten werden abgerufen
<a name="catalog-metadata-forms-retrieving-columns"></a>

### Um Spalten für ein Asset aufzulisten
<a name="catalog-metadata-forms-list-iterable"></a>

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

### Um bestimmte Spalten mit ihren Formularen abzurufen
<a name="catalog-metadata-forms-batch-get"></a>

Wird verwendet`BatchGetIterableForms`, um Spalten und angehängte Formulare in einer einzigen Anfrage abzurufen.

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

## Löschen von Anlagen und Formulartypen
<a name="catalog-metadata-forms-deleting"></a>

### So löschen Sie einen Anhang
<a name="catalog-metadata-forms-delete-attachment"></a>

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

### Um einen Anhang aus einer bestimmten Spalte zu löschen
<a name="catalog-metadata-forms-delete-attachment-item"></a>

Führen Sie den folgenden Befehl aus, um ein Formular zu entfernen, das an eine einzelne Spalte angehängt ist. Übergeben Sie den Namen des iterierbaren Formulars, die Element-ID und den Namen des Anhangs:

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

### Um einen Formulartyp zu löschen
<a name="catalog-metadata-forms-delete-form-type"></a>

Sie können keinen Formulartyp löschen, auf den immer noch von einem Asset-Typ verwiesen wird.

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

## Formulartypen auflisten
<a name="catalog-metadata-forms-listing"></a>

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

Beispielausgabe:

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