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

# Guida introduttiva al contesto aziendale nel catalogo dati
<a name="catalog-business-context-getting-started"></a>

**Nota**  
Il contesto aziendale e la ricerca semantica sono disponibili in anteprima AWS Glue nei seguenti Regioni AWS: Stati Uniti orientali (Virginia settentrionale), Stati Uniti orientali (Ohio), Stati Uniti occidentali (Oregon) ed Europa (Irlanda). Questa funzionalità è soggetta a modifiche.

Questo tutorial illustra come creare un glossario, etichettare le risorse e utilizzare la ricerca semantica per scoprire i dati in base al significato.

## Prerequisiti
<a name="business-context-getting-started-prereqs"></a>
+ Un AWS account con il catalogo AWS Glue dati configurato in una regione supportata.
+ L' AWS CLI installato e configurato.
+ Almeno una tabella registrata nel catalogo dati.
+ Un ruolo o utente IAM con autorizzazioni per le azioni del AWS Glue Data Catalog.
+ Sono necessarie autorizzazioni aggiuntive per cercare nei cataloghi crittografati con una chiave KMS gestita dal cliente. Per ulteriori informazioni, consulta [Crittografia delle risorse del catalogo con AWS KMS chiave gestita dal cliente](encrypt-glue-data-catalog.md#encrypt-context-search).

Allega la seguente policy IAM per concedere le autorizzazioni richieste:

```
{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "glue:SearchAssets", "glue:PutAsset", "glue:GetAsset", "glue:DeleteAsset",
            "glue:PutAssetType", "glue:GetAssetType", "glue:DeleteAssetType", "glue:ListAssetTypes",
            "glue:CreateGlossary", "glue:UpdateGlossary", "glue:GetGlossary", "glue:ListGlossaries", "glue:DeleteGlossary",
            "glue:CreateGlossaryTerm", "glue:UpdateGlossaryTerm", "glue:GetGlossaryTerm", "glue:ListGlossaryTerms", "glue:DeleteGlossaryTerm",
            "glue:AssociateGlossaryTerms", "glue:DisassociateGlossaryTerms",
            "glue:PutFormType", "glue:GetFormType", "glue:DeleteFormType", "glue:ListFormTypes",
            "glue:PutAttachment", "glue:DeleteAttachment",
            "glue:ListIterableForms", "glue:BatchGetIterableForms"
        ],
        "Resource": "*"
    }]
}
```

## Passaggio 1: crea un glossario e contrassegna una risorsa
<a name="business-context-step1-create-glossary"></a>

**Per creare un glossario**  
Esegui il comando seguente:

```
aws glue create-glossary \
  --name "Enterprise Data Glossary" \
  --description "Standardized business definitions for enterprise data assets."
```

Output di esempio:

```
{
    "Id": "d7xm3np5rk2w9j",
    "Name": "Enterprise Data Glossary"
}
```

**Per creare un termine del glossario**  
Sostituisci l'identificatore del glossario con quello dell'`Id`output precedente.

```
aws glue create-glossary-term \
  --glossary-identifier "d7xm3np5rk2w9j" \
  --name "Active User" \
  --short-description "A user with at least one login in the last 30 days." \
  --long-description "An account that has logged in at least once within the trailing 30-day window."
```

Output di esempio:

```
{
    "Id": "c2fymbu18rtsx5",
    "GlossaryId": "d7xm3np5rk2w9j",
    "Name": "Active User"
}
```

**Per associare il termine a una risorsa**  
Esegui il comando seguente:

```
aws glue associate-glossary-terms \
  --asset-identifier "arn:aws:glue:us-east-1:123456789012:table/mydb/sales_transactions" \
  --glossary-term-identifiers "c2fymbu18rtsx5"
```

## Fase 2: Ricerca dei dati utilizzando il contesto aziendale
<a name="business-context-step2-search"></a>

Usa l'`SearchAssets`API per trovare le risorse in base al significato aziendale.

```
aws glue search-assets \
  --search-text "active users"
```

Output di esempio:

```
{
    "Items": [
        {"Id": "c9vq7sh2fk4t2h", "AssetName": "Customer Sales Transactions", "AssetTypeId": "Table"}
    ]
}
```

Per filtrare i risultati per tipo di risorsa:

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}}' \
  --max-results 10
```

Per filtrare solo AWS Glue le tabelle (escluse le tabelle di altri sistemi di origine):

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"namespace","Operator":"equals","Value":{"StringValue":"amazon.glue"}}}]}' \
  --max-results 10
```

## Utilizzo degli agenti AI con il catalogo
<a name="business-context-getting-started-agent-toolkit"></a>

MCP-compatible Gli agenti di intelligenza artificiale possono scoprire le risorse del catalogo, recuperare il contesto aziendale e caricare i contenuti relativi alle competenze utilizzando le competenze dell' AWS Agent Toolkit. Puoi acquisire competenze in materia di catalogo nei seguenti modi:
+ **Fornito in bundle con un plug-in**: installa il `aws-data-analytics` plug-in, che include una serie curata di competenze di catalogo disponibili per l'agente subito dopo l'installazione. Per istruzioni, consulta [ Installazione dei plugin ](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/plugins.html#installing-plugins) nella Guida per l'utente di AWS Agent Toolkit.
+ **Installate localmente**: scaricate le singole competenze dall'Agent Toolkit per l' AWS archivio GitHub e aggiungetele alla directory delle competenze del vostro agente. Le seguenti competenze supportano i flussi di lavoro del catalogo:
  + [exploring-data-catalog ](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/exploring-data-catalog)
  + [trovare-risorse-data-lake ](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/finding-data-lake-assets)

## Fasi successive
<a name="business-context-getting-started-next-steps"></a>
+ Allega moduli per standardizzare i campi dei metadati, ad esempio la residenza o la politica di conservazione dei dati.
+ Crea risorse di competenze che forniscano agli agenti di intelligenza artificiale il contesto di dominio per i tuoi dati.