Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# AWS IoT TwinMaker Connecteur de données tabulaires Athena
Avec le connecteur de données tabulaires Athena, vous pouvez accéder à vos magasins de données Athena et les utiliser dans. AWS IoT TwinMaker Vous pouvez utiliser vos données Athena pour créer des jumeaux numériques sans avoir à effectuer un effort intensif de migration des données. Vous pouvez utiliser le connecteur prédéfini ou créer un connecteur Athena personnalisé pour accéder aux données de vos sources de données Athena.
## AWS IoT TwinMaker Conditions requises pour le connecteur de données Athena
Avant d'utiliser le connecteur de données tabulaires Athena, remplissez les conditions préalables suivantes :
+ Créez des tables Athena gérées et leurs ressources Amazon S3 associées. [Pour plus d'informations sur l'utilisation d'Athena, consultez la documentation d'Athena.](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)
+ Créez un AWS IoT TwinMaker espace de travail. Vous pouvez créer un espace de travail dans la [AWS IoT TwinMaker console](https://console.aws.amazon.com/iottwinmaker/).
+ Mettez à jour le rôle IAM de votre espace de travail avec les autorisations Athena. Pour de plus amples informations, veuillez consulter [Modifiez le rôle IAM de votre espace de travail pour utiliser le connecteur de données Athena](twinmaker-gs-service-role.md#athena-tabular-data-connector-ws-IAM).
+ Familiarisez-vous avec AWS IoT TwinMaker le système de composants d'entités et apprenez à créer des entités. Pour de plus amples informations, veuillez consulter [Créez votre première entité](twinmaker-gs-entity.md).
+ Familiarisez-vous avec AWS IoT TwinMaker les connecteurs de données. Pour de plus amples informations, veuillez consulter [AWS IoT TwinMaker connecteurs de données](data-connector-interface.md).
## Utilisation du connecteur de données Athena
Pour utiliser le connecteur de données Athena, vous devez créer un composant en utilisant le connecteur Athena comme type de composant. Vous attachez ensuite le composant à une entité de votre scène pour l'utiliser dans AWS IoT TwinMaker.
**Création d'un type de composant avec le connecteur de données Athena**
Utilisez cette procédure pour créer un type de AWS IoT TwinMaker composant avec le connecteur de données tabulaires Athena :
1. Accédez à la [console AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Ouvrez un espace de travail existant ou [créez-en un nouveau](twinmaker-gs-workspace.md).
1. Dans le menu de navigation de gauche, choisissez **Types de composants**, puis sélectionnez **Créer un type de composant** pour ouvrir la page de création du type de composant.
1. Sur la page **Créer un type de composant**, renseignez le champ **ID** avec un ID correspondant à votre cas d'utilisation.
![\[La page de console d'informations sur le type de composant avec des champs de saisie pour l'ID, la description et le type de base.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/CreateComponentType-ComponentTypeInformation.png)
1. Choisissez le **type de base**. **Dans la liste déroulante, sélectionnez le connecteur de données tabulaire Athena intitulé com.amazon.athena.connector.**
1. Configurez la **source de données** du type de composant en choisissant les ressources Athena dans les champs suivants :
+ Choisissez une source de **données Athena**.
+ Choisissez une base de **données Athena**.
+ Choisissez un **nom de table**.
+ Choisissez un groupe de **travail Athena**.
1. Une fois que vous avez sélectionné les ressources Athena que vous souhaitez utiliser comme source de données, choisissez les colonnes du tableau que vous souhaitez inclure.
1. Sélectionnez le **nom d'une colonne d'ID externe**. Sélectionnez une colonne à l'étape précédente pour servir de colonne d'ID externe. L'identifiant externe est l'identifiant utilisé pour représenter un actif Athena et le mapper à une AWS IoT TwinMaker entité.
![\[La page de console Athena Data Connector vous permet de choisir votre source de données, votre base de données, le nom de votre table et vos colonnes.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/CreateComponentType-AthenaDataConnector.png)
1. **(Facultatif)** Ajoutez des AWS balises à ces ressources afin de pouvoir les regrouper et les organiser.
1. Choisissez **Créer un type de composant** pour terminer la création du type de composant.
**Créez un composant avec le type de connecteur de données Athena et attachez-le à une entité**
Utilisez cette procédure pour créer un AWS IoT TwinMaker composant avec le connecteur de données tabulaires Athena et l'associer à une entité :
Vous devez disposer d'un type de composant existant qui utilise le connecteur de données tabulaires Athena comme source de données pour effectuer cette procédure. Reportez-vous à la procédure précédente **Créez un type de composant avec le connecteur de données Athena** avant de commencer cette procédure pas à pas.
1. Accédez à la [console AWS IoT TwinMaker](https://console.aws.amazon.com/iottwinmaker/).
1. Ouvrez un espace de travail existant ou [créez-en un nouveau](twinmaker-gs-workspace.md).
1. Dans le menu de navigation de gauche, choisissez **Entités**, puis sélectionnez l'entité à laquelle vous souhaitez ajouter le composant ou créer une nouvelle entité.
1. [Créez une nouvelle entité](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/twinmaker-gs-entity.html).
1. Sélectionnez ensuite **Ajouter un composant.** , renseignez le champ **Nom du composant** avec un nom correspondant à votre cas d'utilisation.
1. Dans le menu déroulant **Type de composant**, sélectionnez l'**ID du type de composant** que vous avez créé lors de la procédure précédente.
1. Entrez **les informations du** **composant, un nom** de composant et sélectionnez l'enfant ComponentType créé précédemment. Il s'agit de ce ComponentType que vous avez créé avec le connecteur de données Athena.
1. Dans la section **Propriétés**, entrez l'**athenaComponentExternalidentifiant** du composant.
![\[La page de console Propriétés permet d'ajouter les propriétés du composant.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/CreateEntity-Properties.png)
1. Choisissez **Ajouter un composant** pour terminer la création du composant.
Vous venez de créer avec succès un composant avec le connecteur de données Athena comme type de composant et de l'associer à une entité.
## Utilisation de la référence JSON du connecteur de données tabulaires Athena
L'exemple suivant est la référence JSON complète pour le connecteur de données tabulaires Athena. Utilisez-le comme ressource pour créer des connecteurs de données et des types de composants personnalisés.
```
{
"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
}
}
}
}
```
## Utilisation du connecteur de données Athena
Vous pouvez faire apparaître vos entités qui utilisent des tables Athena dans Grafana. Pour plus d'informations, consultez la section Intégration du tableau de [bord AWS IoT TwinMaker Grafana](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html).
Consultez la [documentation Athena](https://docs.aws.amazon.com//athena/latest/ug/what-is.html) pour plus d'informations sur la création et l'utilisation des tables Athena pour stocker des données.
### Résolution des problèmes liés au connecteur de données Athena
Cette rubrique traite des problèmes courants que vous pouvez rencontrer lors de la configuration du connecteur de données Athena.
Emplacement du groupe de travail Athena :
Lors de la création du type de composant du connecteur Athena, un groupe de travail Athena doit avoir configuré l'emplacement de sortie. Consultez la section [Fonctionnement des groupes de travail.](https://docs.aws.amazon.com//athena/latest/ug/user-created-workgroups.html)
Autorisations de rôle IAM manquantes :
Il se peut que le AWS IoT TwinMaker rôle d'espace de travail ne dispose pas de l'autorisation d'accès à l'API Athena lors de la création d'un ComponentType, de l'ajout d'un composant Ca à une entité ou de l'exécution de l'API. GetPropertyValue Pour mettre à jour les autorisations IAM, voir [Créer et gérer un rôle de service pour AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html).
## Visualisez les données tabulaires d'Athena dans Grafana
Un plugin Grafana est également disponible pour visualiser vos données tabulaires sur Grafana, un panneau de tableau de bord doté de fonctionnalités supplémentaires telles que le tri et le filtrage en fonction des propriétés sélectionnées sans effectuer d'appels d'API AWS IoT TwinMaker ou d'interactions avec Athena. Cette rubrique explique comment configurer Grafana pour visualiser les données tabulaires d'Athena.
### Conditions préalables
Avant de configurer un panneau Grafana pour visualiser les données tabulaires d'Athena, vérifiez les conditions préalables suivantes :
+ Vous avez configuré un environnement Grafana. Pour plus d'informations, voir Intégration de [AWS IoT TwinMaker Grafana](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html).
+ Vous pouvez configurer une source de données Grafana. Pour plus d'informations, voir [Grafana AWS IoT TwinMaker](https://github.com/grafana/grafana-iot-twinmaker-app/blob/main/src/datasource/README.md).
+ Vous êtes habitué à créer un nouveau tableau de bord et à ajouter un nouveau panneau.
### Visualisez les données tabulaires d'Athena dans Grafana
Cette procédure explique comment configurer un panneau Grafana pour visualiser les données tabulaires d'Athena.
1. Ouvrez votre tableau de AWS IoT TwinMaker bord Grafana.
1. Sélectionnez le panneau **Table** dans les paramètres du panneau.
1. Sélectionnez votre source de données dans la configuration de la requête.
1. Sélectionnez la requête **Obtenir la valeur de la propriété**.
1. Sélectionnez une entité.
1. Sélectionnez un composant doté d'un ComponentType qui étend le type de composant de **base Athena**.
1. Sélectionnez le groupe de propriétés de votre table Athena.
1. Sélectionnez autant de propriétés que vous le souhaitez dans le groupe de propriétés.
1. Configurez les conditions tabulaires à l'aide d'une liste de filtres et d'ordres de propriétés. Avec les options suivantes :
+ **Filtre** : définissez une expression pour une valeur de propriété afin de filtrer vos données.
+ **OrderBy**: spécifiez si les données doivent être renvoyées par ordre croissant ou décroissant pour une propriété.
![\[Exemple de panneau de console Grafana configuré pour visualiser les données tabulaires d'Athena.\]](http://docs.aws.amazon.com/fr_fr/iot-twinmaker/latest/guide/images/ate-grafana-panel.png)