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à.
# AWS IoT TwinMaker Connettore dati tabulare Athena
Con il connettore dati tabulare Athena, puoi accedere e utilizzare i tuoi archivi dati Athena in. AWS IoT TwinMaker Puoi usare i dati di Athena per creare gemelli digitali senza un intenso sforzo di migrazione dei dati. Puoi utilizzare il connettore predefinito o creare un connettore Athena personalizzato per accedere ai dati dalle tue fonti di dati Athena.
## AWS IoT TwinMaker Prerequisiti del connettore dati Athena
Prima di utilizzare il connettore dati tabulare Athena, completa i seguenti prerequisiti:
+ Crea tabelle Athena gestite e le relative risorse Amazon S3 associate. [Per informazioni sull'uso di Athena, consulta la documentazione di Athena.](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)
+ Crea uno spazio di lavoro AWS IoT TwinMaker . [È possibile creare un'area di lavoro nella AWS IoT TwinMaker console.](https://console.aws.amazon.com/iottwinmaker/)
+ Aggiorna il ruolo IAM del tuo spazio di lavoro con le autorizzazioni Athena. Per ulteriori informazioni, consulta [Modifica il ruolo IAM del tuo spazio di lavoro per utilizzare il connettore dati Athena](twinmaker-gs-service-role.md#athena-tabular-data-connector-ws-IAM).
+ Acquisisci familiarità con AWS IoT TwinMaker il sistema entità-componente e con come creare entità. Per ulteriori informazioni, consulta [Crea la tua prima entità](twinmaker-gs-entity.md).
+ Acquisisci familiarità con i AWS IoT TwinMaker connettori dati. Per ulteriori informazioni, consulta [AWS IoT TwinMaker connettori dati](data-connector-interface.md).
## Utilizzo del connettore dati Athena
Per utilizzare il connettore dati Athena, è necessario creare un componente, utilizzando il connettore Athena come tipo di componente. Quindi colleghi il componente a un'entità all'interno della scena per utilizzarlo in. AWS IoT TwinMaker
**Creare un tipo di componente con il connettore dati Athena**
Usa questa procedura per creare un tipo di AWS IoT TwinMaker componente con il connettore dati tabulare Athena:
1. Passare alla [console AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Apri uno spazio di lavoro esistente o [creane](twinmaker-gs-workspace.md) uno nuovo.
1. Dal menu di navigazione a sinistra, scegli **Tipi di componenti** e seleziona **Crea tipo di componente** per aprire la pagina di creazione del tipo di componente.
1. Nella pagina **Crea tipo di componente**, compila il campo **ID** con un ID che corrisponda al tuo caso d'uso.
![\[La pagina della console informativa sul tipo di componente con i campi di immissione per l'ID, la descrizione e il tipo di base.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/CreateComponentType-ComponentTypeInformation.png)
1. Scegli il **tipo di base**. **Dall'elenco a discesa, seleziona il connettore dati tabulare Athena etichettato come com.amazon.athena.connector.**
1. Configura l'**origine dati** del tipo di componente scegliendo le risorse Athena per i seguenti campi:
+ Scegli un'origine dati **Athena**.
+ Scegliete un **database Athena**.
+ Scegli un **nome per la tabella**.
+ Scegliete un gruppo di **lavoro Athena**.
1. Dopo aver selezionato le risorse Athena che desideri utilizzare come origine dati, scegli quali colonne della tabella desideri includere.
1. Seleziona il **nome di una colonna con ID esterno**. Seleziona una colonna del passaggio precedente da utilizzare come colonna ID esterno. L'ID esterno è l'ID utilizzato per rappresentare una risorsa Athena e mapparla a un' AWS IoT TwinMaker entità.
![\[La pagina della console Athena Data Connector ti consente di scegliere l'origine dati, il database, il nome della tabella e le colonne.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/CreateComponentType-AthenaDataConnector.png)
1. **(Facoltativo)** Aggiungi AWS tag a queste risorse per raggrupparle e organizzarle.
1. Scegliete **Crea tipo di componente** per completare la creazione del tipo di componente.
**Crea un componente con il tipo di connettore dati Athena e collegalo a un'entità**
Usa questa procedura per creare un AWS IoT TwinMaker componente con il connettore dati tabulare Athena e collegarlo a un'entità:
È necessario disporre di un tipo di componente esistente che utilizzi il connettore dati tabulare Athena come origine dati per completare questa procedura. Vedi la procedura precedente **Creare un tipo di componente con il connettore dati Athena** prima di iniziare questa procedura dettagliata.
1. Passare alla [console AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Apri uno spazio di lavoro esistente o [creane](twinmaker-gs-workspace.md) uno nuovo.
1. Dal menu di navigazione a sinistra scegli **Entità** e seleziona l'entità a cui desideri aggiungere il componente o crearne una nuova.
1. [Crea una nuova entità](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/twinmaker-gs-entity.html).
1. Quindi seleziona **Aggiungi componente.** , compila il campo **Nome del componente** con un nome che corrisponda al tuo caso d'uso.
1. Dal menu a discesa **Tipo di componente****, seleziona l'ID del tipo** di componente creato nella procedura precedente.
1. Immettete **le informazioni sul componente****, il nome** del componente e selezionate il figlio ComponentType creato in precedenza. Questo è quello ComponentType che hai creato con il connettore dati Athena.
1. Nella sezione **Proprietà**, inserisci l'**athenaComponentExternalID** del componente.
![\[La pagina della console Properties consente di aggiungere le proprietà del componente.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/CreateEntity-Properties.png)
1. Scegli **Aggiungi componente** per completare la creazione del componente.
Ora hai creato con successo un componente con il connettore dati Athena come tipo di componente e lo hai collegato a un'entità.
## Utilizzo del riferimento JSON del connettore dati tabulare Athena
L'esempio seguente è il riferimento JSON completo per il connettore dati tabulare Athena. Utilizzalo come risorsa per creare connettori dati e tipi di componenti personalizzati.
```
{
"componentTypeId": "com.amazon.athena.connector",
"description": "Athena connector for syncing tabular data",
"workspaceId":"AmazonOwnedTypesWorkspace",
"propertyGroups": {
"tabularPropertyGroup": {
"groupType": "TABULAR",
"propertyNames": []
}
},
"propertyDefinitions": {
"athenaDataSource": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaDatabase": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaTable": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaWorkgroup": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true
},
"athenaExternalIdColumnName": {
"dataType": { "type": "STRING" },
"isRequiredInEntity": true,
"isExternalId": false
},
"athenaComponentExternalId": {
"dataType": { "type": "STRING" },
"isStoredExternally": false,
"isRequiredInEntity": true,
"isExternalId": true
}
},
"functions": {
"tabularDataReaderByEntity": {
"implementedBy": {
"isNative": true
}
}
}
}
```
## Utilizzo del connettore dati Athena
È possibile far emergere le entità che utilizzano le tabelle Athena in Grafana. Per ulteriori informazioni, consulta Integrazione della [dashboard AWS IoT TwinMaker Grafana](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html).
Leggi la [documentazione di Athena](https://docs.aws.amazon.com//athena/latest/ug/what-is.html) per informazioni sulla creazione e l'utilizzo delle tabelle Athena per archiviare i dati.
### Risoluzione dei problemi del connettore dati Athena
In questo argomento vengono descritti i problemi più comuni che possono verificarsi durante la configurazione del connettore dati Athena.
Sede del gruppo di lavoro Athena:
Quando si crea il ComponentType del connettore Athena, un gruppo di lavoro Athena deve disporre della posizione di uscita configurata. [Vedi Come funzionano i gruppi di lavoro.](https://docs.aws.amazon.com//athena/latest/ug/user-created-workgroups.html)
Autorizzazioni per i ruoli IAM mancanti:
Al ruolo AWS IoT TwinMaker; workspace potrebbe mancare l'autorizzazione di accesso all'API Athena durante la creazione di un ComponentType, l'aggiunta di un componente Ca a un'entità o l'esecuzione dell'API. GetPropertyValue Per aggiornare le autorizzazioni IAM, consulta [Creare e gestire un](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html) ruolo di servizio per. AWS IoT TwinMaker
## Visualizza i dati tabulari di Athena in Grafana
È disponibile anche un plug-in Grafana per visualizzare i dati tabulari su Grafana, un pannello di dashboard con funzionalità aggiuntive come l'ordinamento e il filtraggio in base a proprietà selezionate senza effettuare chiamate API o interazioni con Athena. AWS IoT TwinMaker Questo argomento mostra come configurare Grafana per visualizzare i dati tabulari di Athena.
### Prerequisiti
Prima di configurare un pannello Grafana per la visualizzazione dei dati tabulari Athena, verifica i seguenti prerequisiti:
+ Hai creato un ambiente Grafana. Per ulteriori informazioni, vedere Integrazione [AWS IoT TwinMaker Grafana](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html).
+ È possibile configurare un'origine dati Grafana. Per ulteriori informazioni, vedere [Grafana AWS IoT TwinMaker](https://github.com/grafana/grafana-iot-twinmaker-app/blob/main/src/datasource/README.md).
+ Conosci bene la creazione di una nuova dashboard e l'aggiunta di un nuovo pannello.
### Visualizza i dati tabulari di Athena in Grafana
Questa procedura mostra come configurare un pannello Grafana per visualizzare i dati tabulari di Athena.
1. Apri la dashboard AWS IoT TwinMaker Grafana.
1. Seleziona il pannello **Tabella** nelle impostazioni del pannello.
1. Seleziona la tua fonte di dati nella configurazione della query.
1. Seleziona la query **Get Property Value**.
1. Selezionare un'entità.
1. Seleziona un componente con un ComponentType che estende il tipo di componente **base Athena**.
1. Seleziona il gruppo di proprietà della tua tabella Athena.
1. Seleziona un numero qualsiasi di proprietà dal gruppo di proprietà.
1. Configura le condizioni tabulari tramite un elenco di filtri e ordini di proprietà. Con le seguenti opzioni:
+ **Filtro**: definisci un'espressione per il valore di una proprietà per filtrare i dati.
+ **OrderBy**: specifica se i dati devono essere restituiti in ordine crescente o decrescente per una proprietà.
![\[Un esempio di pannello della console Grafana configurato per visualizzare i dati tabulari di Athena.\]](http://docs.aws.amazon.com/it_it/iot-twinmaker/latest/guide/images/ate-grafana-panel.png)