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

Melampirkan formulir

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

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

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

aws glue get-form-type --identifier DataResidency

Melampirkan formulir ke aset

Untuk melampirkan formulir ke aset

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

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

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

Untuk membuat daftar kolom untuk aset

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

Untuk mengambil kolom tertentu dengan bentuknya

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

Untuk menghapus lampiran

aws glue delete-attachment \
    --asset-identifier asset-id \
    --attachment-name residencyInfo

Untuk menghapus lampiran dari kolom tertentu

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

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

aws glue delete-form-type --identifier DataResidency

Jenis formulir daftar

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

Contoh output:

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