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.

Anhängen von Formularen

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

Definieren von Formulartypen

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

Wird verwendetPutFormType, 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

aws glue get-form-type --identifier DataResidency

Anhängen von Formularen an Assets

Um ein Formular an ein Asset anzuhängen

Verwenden Sie es PutAttachment 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

Wird verwendetGetAsset, 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

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 Elementbezeichner.

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

Nachdem Sie das Formular angehängt haben, verwenden Sie es, SearchAssets um das Asset anhand aller durchsuchbaren Felder im Formular zu ermitteln.

Spaltenmetadaten werden abgerufen

Um Spalten für ein Asset aufzulisten

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

Um bestimmte Spalten mit ihren Formularen abzurufen

Wird verwendetBatchGetIterableForms, 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

Beispielausgabe:

{
    "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": []
}

Löschen von Anhängen und Formulartypen

So löschen Sie einen Anhang

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

Um einen Anhang aus einer bestimmten Spalte zu löschen

Führen Sie den folgenden Befehl aus, um ein Formular zu entfernen, das an eine einzelne Spalte angehängt ist. Übergeben Sie den iterierbaren Formularnamen, 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

Sie können keinen Formulartyp löschen, auf den immer noch ein Asset-Typ verweist.

aws glue delete-form-type --identifier DataResidency

Auflisten von Formulartypen

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

Beispielausgabe:

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