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 berada dalam pratinjau AWS Glue dan dapat berubah.

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

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

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

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

### Untuk membuat jenis 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 bidang apa pun 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 bentuknya
<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
```

Contoh output:

```
{
    "Items": [
        {
            "ItemId": "{{asset-id}}#region",
            "ItemName": "region",
            "GlossaryTerms": ["{{term-id}}"],
            "Forms": {},
            "Attachments": {
                "sensitivity": {"FormTypeId": "DataClassification", "Content": "{\"classification\":\"PII\",\"sensitivity\":\"HIGH\"}"}
            }
        },
        {
            "ItemId": "{{asset-id}}#email",
            "ItemName": "email",
            "Forms": {},
            "Attachments": {}
        }
    ],
    "Errors": []
}
```

## Menghapus lampiran dan jenis 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 kolom tunggal, jalankan perintah berikut. Berikan nama formulir yang dapat diiterasi, pengidentifikasi 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"}
    ]
}
```