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.
# Connectez-vous à une source de données Amazon Athena
**Note**
Dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour de plus amples informations, veuillez consulter [Étendez votre espace de travail avec des plugins](grafana-plugins.md).
**Note**
Ce guide part du principe que vous connaissez le service Amazon Athena avant d'utiliser la source de données Athena.
Avec Amazon Managed Grafana, vous pouvez ajouter Athena en tant que source de données en utilisant l'option de configuration de la source de AWS données dans la console de l'espace de travail Grafana. Cette fonctionnalité simplifie l'ajout d'Athena en tant que source de données en découvrant vos comptes Athena existants et en gérant la configuration des informations d'authentification requises pour accéder à Athena. Vous pouvez utiliser cette méthode pour configurer l'authentification et ajouter Athena comme source de données, ou vous pouvez configurer manuellement la source de données et les informations d'authentification nécessaires en utilisant la même méthode que sur un serveur Grafana autogéré.
Certaines conditions sont requises pour qu'Athena soit accessible par Amazon Managed Grafana. Pour connaître les conditions préalables associées à l'utilisation de la source de données Athena, consultez. [Conditions préalables](Athena-prereq.md)
# Conditions préalables
Pour utiliser les politiques gérées pour Amazon Managed Grafana for Athena, effectuez les tâches suivantes avant de configurer la source de données Athena :
+ Marquez vos groupes de travail Athena avec. `GrafanaDataSource: true`
+ Créez un compartiment S3 dont le nom commence par`grafana-athena-query-results-`. Cette politique fournit des autorisations pour écrire les résultats des requêtes dans un compartiment S3 avec cette convention de dénomination.
Les autorisations Amazon S3 permettant d'accéder à la source de données sous-jacente d'une requête Athena ne sont pas incluses dans cette politique gérée. Vous devez ajouter les autorisations nécessaires pour les compartiments Amazon S3 manuellement, sur une case-by-case base régulière. Pour plus d'informations, consultez les [exemples de politiques basées sur l'identité dans Amazon Managed Grafana dans ce guide](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html).
# Utiliser la configuration de la source de AWS données pour ajouter Amazon Athena en tant que source de données
## Conditions préalables
+ La [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) est installée et configurée dans votre environnement.
+ Vous avez accès à Athéna depuis votre compte.
Pour utiliser la configuration AWS des sources de données, accédez d'abord à la console Amazon Managed Grafana pour activer les rôles IAM gérés par des services qui accordent à l'espace de travail les politiques IAM nécessaires pour lire les ressources Athena de votre compte ou de l'ensemble de vos unités organisationnelles. Vous utilisez ensuite la console d'espace de travail Amazon Managed Grafana pour ajouter Athena en tant que source de données.
# Pour utiliser la configuration de la source de AWS données pour ajouter Athena en tant que source de données
1. Assurez-vous que votre rôle d'utilisateur est administrateur ou éditeur.
1. Sélectionnez l'espace de travail sur lequel vous souhaitez travailler depuis la console Amazon Managed Grafana à l'adresse. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
1. Si vous n'avez pas choisi d'utiliser les autorisations gérées par les services pour cet espace de travail lorsque vous l'avez créé, passez des autorisations gérées par le client à des autorisations gérées par les services afin de vous assurer que les rôles et politiques IAM appropriés sont activés pour utiliser l'option de configuration de la AWS source de données dans la console de l'espace de travail Grafana. Pour ce faire, choisissez l'icône de modification par **rôle IAM**, puis choisissez **Service géré**, **Enregistrer les modifications**. Pour de plus amples informations, veuillez consulter [Autorisations et politiques Amazon Managed Grafana pour les sources de données AWS](AMG-manage-permissions.md).
1. Choisissez l'onglet **Sources de données**. Cochez ensuite la case pour **Amazon Athena**, puis choisissez **Actions**, **Activer la politique gérée par les services**.
1. Choisissez à nouveau l'onglet **Sources de données**, puis sélectionnez **Configurer dans Grafana** dans la ligne **Amazon Athena**.
1. Connectez-vous à la console de l'espace de travail Grafana à l'aide d'IAM Identity Center si nécessaire. L'utilisateur doit avoir une politique d'accès Athena attachée à l'utilisateur/au rôle afin d'avoir accès à la source de données Athena. Pour plus d’informations, consultez [AWS politique gérée : AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess).
1. **Dans la barre de navigation de gauche de la console de l'espace de travail Grafana, choisissez l' AWS icône inférieure (il y en a deux), puis choisissez **Athena dans le menu Sources de données**.**
1. Sélectionnez la région par défaut à partir de laquelle vous souhaitez que la source de données Athena interroge, puis sélectionnez les comptes souhaités, puis choisissez **Ajouter une source de données**.
1. Suivez les étapes pour configurer **Athena** Details dans [**Paramètres d'Athena Details**](#Athena-settings)
## **Paramètres d'Athena Details**
**Configurer les paramètres **d'Athena Details****
1. Dans le menu **Détails de la connexion**, sélectionnez le fournisseur d'authentification (recommandé : **rôle Workspace IAM**).
1. Sélectionnez la source de données Athena ciblée dans laquelle vous avez votre compte Athena. Si vous ne sélectionnez aucune source de données, une source de données par défaut apparaît dans le menu déroulant.
Pour créer un nouveau compte Athena, suivez les instructions de la section [Getting started](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html) with Athena
1. Sélectionnez votre base de données Athena ciblée dans la source de données sélectionnée ci-dessus.
1. Sélectionnez le groupe de travail. Le **mode principal** est défini par défaut.
1. Si aucun emplacement de sortie n'est déjà configuré pour votre groupe de travail, spécifiez un compartiment et un dossier S3 à utiliser pour les résultats des requêtes. Par exemple, `s3://grafana-athena-plugin-test-data/query-result-output/ `
1. Sélectionnez **Enregistrer et tester**.
# Ajouter manuellement la source de données Athena
## Conditions préalables
+ La [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) est installée et configurée dans votre environnement.
+ Vous avez accès à **Amazon Athena** depuis votre compte.
**Pour ajouter manuellement la source de données Athena :**
1. Dans le menu latéral de la console Grafana, faites une pause sur l'icône **Configuration** (engrenage), puis choisissez Sources de **données**.
1. Choisissez **Add data source**.
1. Choisissez la source de données **AWS Athena**. Si nécessaire, vous pouvez commencer à taper **Athena** dans le champ de recherche pour vous aider à le trouver.
1. Dans le menu **Détails de connexion**, configurez le fournisseur d'authentification (recommandé : **rôle Workspace IAM**)
1. Sélectionnez votre source de données, votre base de données et votre groupe de travail Athena cibles.
Pour créer un nouveau compte Athena, suivez les instructions de la section [Getting started with Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html).
1. Si aucun emplacement de sortie n'est déjà configuré pour votre groupe de travail, spécifiez un compartiment et un dossier S3 à utiliser pour les résultats des requêtes. Par exemple, `s3://grafana-athena-plugin-test-data/query-result-output/ `.
1. Sélectionnez **Enregistrer et tester**.
Voici un exemple des paramètres **Athena Details**.
![\[Exemple d'Athena Details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/athena.png)
# Utilisation de la source de données Athena
## politiques IAM
Grafana a besoin d'autorisations accordées via IAM pour pouvoir lire les métriques d'Athena. Vous pouvez associer ces autorisations aux rôles IAM et utiliser le support intégré de Grafana pour assumer des rôles. Notez que vous devrez [configurer la politique requise](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) pour votre rôle avant d'ajouter la source de données à Grafana. Vous aurez besoin d'un rôle d'administrateur ou d'éditeur pour ajouter une source de données. La politique d'accès intégrée à Amazon Grafana Athena est définie dans cette section. [AWS politique gérée : AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess)
## Interrogez les données d'Athéna
La source de données Athena fournit un éditeur de requêtes SQL standard. Amazon Managed Grafana inclut des macros pour vous aider à écrire des requêtes de séries chronologiques plus complexes.
Macros
| Macro | Description | Exemple | Exemple de sortie |
| --- | --- | --- | --- |
| \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltercrée un filtre conditionnel qui sélectionne les données (en utilisantcolumn) en fonction de la plage de dates du panneau. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' |
| \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimeconvertit un varchar en horodatage avec le format donné. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') |
| \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFiltercrée un conditionnel qui filtre les données (en utilisantcolumn) en fonction de la plage de temps du panneau. Le deuxième argument est utilisé pour analyser éventuellement la colonne d'un varchar à un horodatage avec un format spécifique. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeFrom() | \$1\$1\$1timeFromaffiche l'heure de début actuelle de la plage du panneau entre guillemets. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeTo() | \$1\$1\$1timeTo affiche l'heure de fin actuelle de la plage du panneau entre guillemets. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup regroupe les horodatages de manière à ce qu'il n'y ait qu'un point pour chaque période du graphique. Le troisième argument est utilisé pour analyser éventuellement la colonne d'un varchar à un horodatage avec un format spécifique. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) |
| \$1\$1\$1table | \$1\$1\$1tablerenvoie le tableau sélectionné dans le sélecteur de tableau. | \$1\$1\$1table | my\$1table |
| \$1\$1\$1column | \$1\$1\$1columnrenvoie la colonne sélectionnée dans le sélecteur de colonnes (un tableau est requis). | \$1\$1\$1column | col1 |
**Visualisation**
La plupart des requêtes dans Athena seront mieux représentées par une visualisation sous forme de table. Une requête affiche les données de retour dans une table. S'il peut être interrogé, il peut être affiché sous forme de tableau.
Cet exemple renvoie les résultats d'une visualisation de table :
```
SELECT {column_1}, {column_2} FROM {table};
```
**Visualisations de séries chronologiques/graphiques**
Pour les séries chronologiques et les visualisations de graphes, vous devez :
+ sélectionnez une colonne avec un `date` ou un `datetime` type. La `date` colonne doit être dans l'ordre croissant (utilisation`ORDER BY column ASC`).
+ sélectionnez également une colonne numérique.
**Inspection de la requête**
Amazon Managed Grafana prend en charge les macros qu'Athena ne prend pas en charge, ce qui signifie qu'une requête peut ne pas fonctionner si elle est copiée et collée directement dans Athena. Pour afficher la requête interpolée complète, qui fonctionne directement dans Athena, cliquez sur le bouton **Query Inspector**. La requête complète est affichée sous l'onglet **Requête**.
## Modèles et variables
Pour plus d'informations sur l'ajout d'une variable de requête Athena, consultez. [Ajouter une variable de requête](variables-types.md#add-a-query-variable) Utilisez votre source de données Athena comme source de données pour les requêtes disponibles.
Toute valeur interrogée à partir d'une table Athena peut être utilisée comme variable. Évitez de sélectionner trop de valeurs, car cela peut entraîner des problèmes de performances.
Après avoir créé une variable, vous pouvez l'utiliser dans vos requêtes Athena en utilisant. [Syntaxe variable](templates-and-variables.md#variable-syntax) Pour plus d'informations sur les variables, consultez[Modèles et variables](templates-and-variables.md).
## Annotations
[Annotations](dashboard-annotations.md)vous permettent de superposer des informations détaillées sur les événements au-dessus des graphiques. Vous pouvez ajouter des annotations en sélectionnant le panneau ou en ajoutant des requêtes d'annotation à l'aide de la vue des **annotations** du menu du tableau de **bord**.
Exemple de requête pour ajouter automatiquement des annotations :
```
SELECT
time as time,
environment as tags,
humidity as text
FROM
tableName
WHERE
$__dateFilter(time) and humidity > 95
```
Le tableau suivant décrit les colonnes qui peuvent être utilisées pour afficher des annotations :
| Nom | Description |
| --- | --- |
| Time | Le nom du date/time champ. Il peut s'agir d'une colonne avec un type de date/time données SQL natif ou une valeur d'époque. |
| Timeend | Nom facultatif du date/time champ de fin. Il peut s'agir d'une colonne avec un type de date/time données SQL natif ou une valeur d'époque. (Grafana v6.6 et versions ultérieures) |
| Text | Champ de description de l'événement. |
| Tags | Nom de champ facultatif à utiliser pour les balises d'événements sous forme de chaîne séparée par des virgules. |
## Support des données de requêtes asynchrones
Les requêtes Athena dans Amazon Managed Grafana sont traitées de manière asynchrone afin d'éviter les délais d'attente. Les requêtes asynchrones utilisent des requêtes distinctes pour démarrer la requête, puis vérifier sa progression et enfin récupérer les résultats. Cela permet d'éviter les délais d'attente pour les requêtes qui s'exécutent pendant une longue période.
## Réutilisation des résultats de requête
Vous pouvez réutiliser les résultats des requêtes précédentes pour améliorer les performances des requêtes. Pour activer la réutilisation des requêtes, cette option se trouve dans la section **Réutilisation des résultats** de la requête de l'éditeur de requêtes. Cela doit être fait pour chaque requête que vous souhaitez réutiliser.
**Note**
Cette fonctionnalité nécessite que votre instance Athena soit installée sur la version 3 du moteur. Pour plus d'informations, consultez la section [Modification des versions du moteur Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) dans le guide de l'utilisateur *Amazon Athena*.