Allegare moduli

Nota

Il contesto aziendale e la ricerca semantica sono disponibili in anteprima AWS Glue e sono soggette a modifiche.

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

Definizione dei tipi di modulo

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

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

Per creare un tipo di modulo

Utilizzare PutFormType 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

GetAssetUtilizzatelo 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

È possibile 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, usalo SearchAssets per scoprire la risorsa in base a tutti i campi ricercabili del modulo.

Recupero dei metadati delle colonne

Per elencare le colonne relative a 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

Utilizzato BatchGetIterableForms per 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

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. Passa il nome del modulo iterabile, 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"}
    ]
}