Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Melampirkan formulir
<a name="catalog-metadata-forms"></a>

**catatan**  
Konteks bisnis dan pencarian semantik dalam pratinjau AWS Glue dan dapat berubah sewaktu-waktu.

Anda dapat membakukan metadata dengan menentukan jenis formulir, yang dapat digunakan kembali, templat skema terstruktur. Skema kemudian dapat diisi dengan melampirkan contoh formulir ini ke aset.

## Mendefinisikan jenis formulir
<a name="catalog-metadata-forms-defining"></a>

Tipe formulir mendefinisikan skema menggunakan sintaks Smithy IDL. Nama harus dimulai dengan huruf besar.

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

### Untuk membuat tipe formulir
<a name="catalog-metadata-forms-put-form-type"></a>

Gunakan `PutFormType` untuk membuat atau memperbarui jenis formulir.

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

Contoh output:

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

### Untuk mengambil jenis formulir
<a name="catalog-metadata-forms-get-form-type"></a>

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

## Melampirkan formulir ke aset
<a name="catalog-metadata-forms-attaching"></a>

### Untuk melampirkan formulir ke aset
<a name="catalog-metadata-forms-put-attachment"></a>

Gunakan `PutAttachment` dengan pengenal aset, nama lampiran, ID tipe formulir, dan konten JSON yang sesuai dengan skema.

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

### Untuk melihat formulir dan lampiran aset
<a name="catalog-metadata-forms-get-asset-attachments"></a>

Gunakan `GetAsset` untuk mengambil aset beserta formulir dan lampirannya.

Perintah berikut mengambil aset:

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

### Untuk melampirkan formulir ke kolom
<a name="catalog-metadata-forms-put-attachment-item"></a>

Anda dapat melampirkan formulir ke satu kolom aset.

Setiap kolom adalah satu item dari formulir `columns` iterable dengan nama kolom sebagai pengidentifikasi item.

Perintah berikut melampirkan formulir ke kolom tertentu:

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

Setelah Anda melampirkan formulir, gunakan `SearchAssets` untuk menemukan aset dengan kolom yang dapat dicari pada formulir.

## Mengambil metadata kolom
<a name="catalog-metadata-forms-retrieving-columns"></a>

### Untuk membuat daftar kolom untuk aset
<a name="catalog-metadata-forms-list-iterable"></a>

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

### Untuk mengambil kolom tertentu dengan formulir mereka
<a name="catalog-metadata-forms-batch-get"></a>

Gunakan `BatchGetIterableForms` untuk mengambil kolom dan formulir terlampir dalam satu permintaan.

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

## Menghapus lampiran dan tipe formulir
<a name="catalog-metadata-forms-deleting"></a>

### Untuk menghapus lampiran
<a name="catalog-metadata-forms-delete-attachment"></a>

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

### Untuk menghapus lampiran dari kolom tertentu
<a name="catalog-metadata-forms-delete-attachment-item"></a>

Untuk menghapus formulir yang dilampirkan ke satu kolom, jalankan perintah berikut. Berikan nama formulir yang dapat diulang, pengenal item, dan nama lampiran:

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

### Untuk menghapus jenis formulir
<a name="catalog-metadata-forms-delete-form-type"></a>

Anda tidak dapat menghapus jenis formulir yang masih direferensikan oleh jenis aset.

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

## Jenis formulir daftar
<a name="catalog-metadata-forms-listing"></a>

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

Contoh output:

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