Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Allegare moduli

È possibile standardizzare i metadati definendo i tipi di modulo, che sono modelli di schema strutturati e riutilizzabili. Lo schema può quindi essere popolato allegando istanze di questi moduli alle risorse.

Definizione dei tipi di modulo

Un tipo di modulo definisce lo schema utilizzando la sintassi IDL di Smithy. I nomi devono iniziare con una lettera maiuscola.

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

Per creare un tipo di modulo

PutFormTypeDa utilizzare per creare o aggiornare un tipo di modulo.

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

Output di esempio:

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

Per recuperare un tipo di modulo

aws glue get-form-type --identifier DataResidency

Allegare moduli alle risorse

Per allegare un modulo a una risorsa

Utilizzalo PutAttachment con l'identificatore della risorsa, il nome dell'allegato, l'ID del tipo di modulo e il contenuto JSON conforme allo schema.

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

Per visualizzare i moduli e gli allegati di una risorsa

GetAssetUsalo per recuperare una risorsa insieme ai relativi moduli e allegati.

Il comando seguente recupera una risorsa:

aws glue get-asset --asset-identifier asset-id

Per allegare un modulo a una colonna

Puoi allegare un modulo a una singola colonna di una risorsa.

Ogni colonna è un singolo elemento del modulo columns iterabile con il nome della colonna come identificatore dell'elemento.

Il comando seguente allega un modulo a una colonna specifica:

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

Dopo aver allegato il modulo, utilizzalo SearchAssets per scoprire la risorsa tramite qualsiasi campo ricercabile nel modulo.

Recupero dei metadati delle colonne

Per elencare le colonne di una risorsa

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

Per recuperare colonne specifiche con i relativi moduli

BatchGetIterableFormsConsente di recuperare colonne e moduli allegati in un'unica richiesta.

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

Output di esempio:

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

Eliminazione di allegati e tipi di modulo

Come eliminare un collegamento

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

Per eliminare un allegato da una colonna specifica

Per rimuovere un modulo allegato a una singola colonna, esegui il comando seguente. Passate il nome iterabile del modulo, l'identificatore dell'elemento e il nome dell'allegato:

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

Per eliminare un tipo di modulo

Non è possibile eliminare un tipo di modulo a cui fa ancora riferimento un tipo di risorsa.

aws glue delete-form-type --identifier DataResidency

Elenco dei tipi di modulo

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

Output di esempio:

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