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 tabulari Athena, puoi accedere e utilizzare i tuoi data store Athena in. AWS IoT TwinMaker Puoi usare i tuoi dati 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, completate 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](https://docs.aws.amazon.com/athena/latest/ug/what-is.html)
+ Crea uno spazio di lavoro AWS IoT TwinMaker . Puoi creare uno spazio di lavoro nella [AWS IoT TwinMaker console. ](https://console.aws.amazon.com/iottwinmaker/)
+ Aggiorna il ruolo IAM del tuo workspace con le autorizzazioni Athena. Per ulteriori informazioni, consulta [Modifica il ruolo IAM del tuo workspace per utilizzare il connettore dati Athena](twinmaker-gs-service-role.md#athena-tabular-data-connector-ws-IAM).
+ Acquisisci familiarità con AWS IoT TwinMaker il suo sistema di componenti di entità e 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 si collega il componente a un'entità all'interno della scena per utilizzarlo. AWS IoT TwinMaker
**Create un tipo di componente con il connettore dati Athena **
Utilizzate 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. Aprite uno spazio di lavoro esistente o [ createne uno nuovo. ](twinmaker-gs-workspace.md)
1. Dal menu di navigazione a sinistra, scegliete Tipi di ** ** componenti e selezionate ** 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.
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. **
+ Scegli un ** database Athena. **
+ Scegli un nome ** per la ** tabella.
+ Scegli un ** Athena ** WorkGroup.
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 ID ** esterno. Seleziona una colonna dal passaggio precedente che funga da colonna ID esterno. L'ID esterno è l'id utilizzato per rappresentare una risorsa Athena e mapparla a un' AWS IoT TwinMaker entità.
1. **(Facoltativo) ** Aggiungi AWS tag a queste risorse, in modo da poterle raggruppare e organizzare.
1. Scegliete ** Crea tipo di componente ** per completare la creazione del tipo di componente.
**Create un componente con il tipo di connettore dati Athena e collegatelo a un'entità **
Utilizzate 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 uno nuovo. ](twinmaker-gs-workspace.md)
1. Dal menu di navigazione a sinistra**, scegli ** Entità e seleziona l'entità a cui desideri aggiungere il componente o creare una nuova entità.
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 ** che hai creato nella procedura precedente.
1. Inserite le informazioni sul ** ** componente**, un 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'**athena ComponentExternalId ** per il componente.
1. **Scegliete Aggiungi componente ** per completare la creazione del componente.
Ora avete creato con successo un componente con il connettore dati Athena come tipo di componente e lo avete collegato a un'entità.
## Utilizzo del riferimento JSON del connettore dati tabulare Athena
L'esempio seguente è il riferimento JSON completo per il connettore dati tabulari Athena. Usalo 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 visualizzare le entità che utilizzano le tabelle Athena in Grafana. Per ulteriori informazioni, consulta Integrazione con la dashboard di [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 relativi al connettore dati Athena
Questo argomento tratta i problemi più comuni che potresti riscontrare durante la configurazione del connettore dati Athena.
Ubicazione del gruppo di lavoro Athena:
Quando si crea un connettore Athena ComponentType, un gruppo di lavoro Athena deve avere impostato la posizione di output. Scopri 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 ruolo di servizio per. AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html)
## 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 filtro in base alle 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 di Athena, esaminate i seguenti prerequisiti:
+ Hai impostato un ambiente Grafana. Per ulteriori informazioni, vedi Integrazione con [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)
+ Hai dimestichezza con 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 di Grafana. AWS IoT TwinMaker
1. Seleziona il ** pannello ** Tabella nelle impostazioni del pannello.
1. Seleziona la tua fonte di dati nella configurazione dell'interrogazione.
1. Seleziona la query ** Get Property Value**.
1. Selezionare un'entità.
1. Selezionate un componente con un ComponentType che estende il tipo di componente base ** Athena. **
1. Selezionate il gruppo di proprietà della vostra 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 tuoi dati.
+ **OrderBy**: specifica se i dati devono essere restituiti in ordine crescente o decrescente per una proprietà.
