

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.

# Problèmes de connectivité lors de l'utilisation d'Amazon Athena avec Amazon Quick Sight
<a name="troubleshoot-athena"></a>

Vous trouverez ci-dessous des informations sur les problèmes de résolution des problèmes que vous pouvez rencontrer lors de l'utilisation d'Amazon Athena avec Amazon Quick Sight.

Avant d’essayer de résoudre tout autre problème relatif à Athéna, assurez-vous que vous pouvez vous connecter à Athéna. Pour plus d’informations sur la résolution des problèmes de connexion à Athena, consultez la rubrique [Je ne peux pas me connecter à Amazon Athena](troubleshoot-connect-athena.md). 

Si vous parvenez à vous connecter mais que vous rencontrez d'autres problèmes, il peut être utile d'exécuter votre requête dans la console Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) avant de l'ajouter à Amazon Quick Sight. Pour plus d’informations sur la résolution des problèmes, consultez la rubrique [Dépannage](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) dans le *Guide de l’utilisateur Athena*.

**Topics**
+ [Colonne introuvable lors de l'utilisation d'Athena avec Amazon Quick Sight](troubleshoot-athena-column-not-found.md)
+ [Données non valides lors de l'utilisation d'Athena avec Amazon Quick Sight](troubleshoot-athena-invalid-data.md)
+ [Expiration des requêtes lors de l'utilisation d'Athena avec Amazon Quick Sight](troubleshoot-athena-query-timeout.md)
+ [Le bucket de préparation n'existe plus lors de l'utilisation d'Athena avec Amazon Quick Sight](troubleshoot-athena-missing-bucket.md)
+ [Tableau incompatible lors de l'utilisation AWS Glue avec Athena dans Amazon Quick Sight](troubleshoot-athena-glue-table-not-upgraded.md)
+ [Tableau introuvable lors de l'utilisation d'Athena avec Amazon Quick Sight](troubleshoot-athena-table-not-found.md)
+ [Erreurs de groupe de travail et de sortie lors de l'utilisation d'Athena avec Quick Sight](troubleshoot-athena-workgroup.md)

# Colonne introuvable lors de l'utilisation d'Athena avec Amazon Quick Sight
<a name="troubleshoot-athena-column-not-found"></a>

Vous pouvez recevoir un message d’erreur « `column not found` » si les colonnes d’une analyse ne sont pas présentes dans la source de données Athena. 

Dans Amazon Quick Sight, ouvrez votre analyse. Sous l’onglet **Visualiser**, choisissez **Choisir un jeu de données...**, puis **Modifier les jeux de données de l’analyse**. 

Sur l’écran **Jeux de données dans l’analyse**, choisissez **Modifier** en regard de votre jeu de données pour l’actualiser. Amazon Quick Sight met le schéma en cache pendant deux minutes. Le délai d’affichage des dernières modifications peut ainsi être de deux minutes. 

Pour savoir comment la colonne a été perdue, vous pouvez accéder à la console Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) et consulter l'historique des requêtes pour trouver les requêtes qui ont modifié la table.

Si cette erreur s’est produite lors de la modification d’une requête SQL personnalisée dans la version préliminaire, vérifiez le nom de la colonne dans la requête, et recherchez d’éventuelles erreurs de syntaxe. Par exemple, vérifiez que le nom de la colonne n’est pas placé entre guillemets simples, qui sont réservées aux chaînes.

Si le problème persiste, vérifiez que vos tables, colonnes et requêtes sont conformes aux exigences d’Athena. Pour plus d’informations, consultez les rubriques [Noms des tables, des bases de données et des colonnes](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) et [Dépannage](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) dans le *Guide de l’utilisateur Athena*.

# Données non valides lors de l'utilisation d'Athena avec Amazon Quick Sight
<a name="troubleshoot-athena-invalid-data"></a>

Une erreur de données non valides peut se produire lorsque vous utilisez un opérateur ou une fonction dans un champ calculé. Pour y remédier, vérifiez que les données de la table sont cohérentes avec le format que vous avez fourni à la fonction.

Par exemple, supposons que vous utilisiez la fonction en `parseDate(expression, [‘format’], [‘time_zone’])` comme suit : **parseDate(date\$1column, ‘MM/dd/yyyy’)**. Dans ce cas, toutes les valeurs saisies dans `date_column` doivent être conformes au format `'MM/dd/yyyy'` (`’05/12/2016’`). Les valeurs dont le format est différent (**‘2016/12/05’**) peuvent générer une erreur.

# Expiration des requêtes lors de l'utilisation d'Athena avec Amazon Quick Sight
<a name="troubleshoot-athena-query-timeout"></a>

Si votre requête expire, vous pouvez appliquer ces options pour résoudre le problème.

Si l'échec est survenu pendant que vous travailliez sur une analyse, n'oubliez pas que le délai d'expiration d'Amazon Quick Sight pour générer un visuel est de deux minutes. Si vous utilisez une requête SQL personnalisée, vous pouvez simplifier votre requête pour optimiser la durée d’exécution. 

Si vous êtes en mode de requête directe (c’est-à-dire que vous n’utilisez pas SPICE), vous pouvez essayer d’importer vos données dans SPICE. Toutefois, si votre requête dépasse le délai d’attente de 30 minutes d’Athena, vous pouvez obtenir un nouveau délai d’attente pendant l’importation de données dans SPICE. Pour obtenir les dernières informations sur les limites Athena, consultez la rubrique [Limites Amazon Athena](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#amazon-athena-limits) dans le *Références générales AWS*.

# Le bucket de préparation n'existe plus lors de l'utilisation d'Athena avec Amazon Quick Sight
<a name="troubleshoot-athena-missing-bucket"></a>

Utilisez cette section pour aider à résoudre cette erreur : « **Le compartiment intermédiaire du résultat de cette requête n’existe plus dans la source de données sous-jacente.** »

 Lorsque vous créez un ensemble de données à l'aide d'Athena, Amazon Quick Sight crée un compartiment Amazon S3. Par défaut, ce compartiment possède un nom similaire à « `aws-athena-query-results-<REGION>-<ACCOUNTID>` ». Si vous supprimez ce compartiment, votre prochaine requête Athena peut échouer avec une erreur indiquant que le compartiment intermédiaire n’existe plus. 

 Pour corriger cette erreur, créez un nouveau compartiment avec le même nom dans la bonne Région AWS. 

# Tableau incompatible lors de l'utilisation AWS Glue avec Athena dans Amazon Quick Sight
<a name="troubleshoot-athena-glue-table-not-upgraded"></a>

Si vous rencontrez des erreurs lorsque vous utilisez AWS Glue des tables dans Athena avec Amazon Quick Sight, c'est peut-être parce que certaines métadonnées sont manquantes. Suivez ces étapes pour savoir si vos tables ne possèdent pas l'`TableType`attribut dont Amazon Quick Sight a besoin pour que le connecteur Athena fonctionne. En général, les métadonnées de ces tables n'étaient pas migrées vers le catalogue de AWS Glue données. Pour plus d'informations, consultez la section [Mise à niveau vers le catalogue de AWS Glue données Step-by-Step](https://docs.aws.amazon.com/athena/latest/ug/glue-upgrade.html) dans le *guide du AWS Glue développeur.*

Si vous ne souhaitez pas migrer vers le catalogue de AWS Glue données pour le moment, deux options s'offrent à vous. Vous pouvez recréer chaque AWS Glue table via la console AWS Glue de gestion. Vous pouvez également utiliser les AWS CLI scripts répertoriés dans la procédure suivante pour identifier et mettre à jour les tables dont les `TableType` attributs sont manquants.

Si vous préférez utiliser l’interface de ligne de commande pour effectuer cette opération, vous pouvez utiliser la procédure suivante pour la conception de vos scripts.

**Pour utiliser l’interface de ligne de commande afin de concevoir des scripts**

1. Utilisez la CLI pour savoir quelles AWS Glue tables ne possèdent aucun `TableType` attribut.

   ```
   aws glue get-tables --database-name <your_datebase_name>;
   ```

   Par exemple, vous pouvez exécuter la commande suivante dans l’interface de ligne de commande.

   ```
   aws glue get-table --database-name "test_database" --name "table_missing_table_type"
   ```

   L’exemple suivant montre à quoi peut ressembler la sortie. Vous pouvez voir que la table `"table_missing_table_type"` ne comporte pas l’attribut `TableType` déclaré.

   ```
   {
   		"TableList": [
   			{
   				"Retention": 0,
   				"UpdateTime": 1522368588.0,
   				"PartitionKeys": [
   					{
   						"Name": "year",
   						"Type": "string"
   					},
   					{
   						"Name": "month",
   						"Type": "string"
   					},
   					{
   						"Name": "day",
   						"Type": "string"
   					}
   				],
   				"LastAccessTime": 1513804142.0,
   				"Owner": "owner",
   				"Name": "table_missing_table_type",
   				"Parameters": {
   					"delimiter": ",",
   					"compressionType": "none",
   					"skip.header.line.count": "1",
   					"sizeKey": "75",
   					"averageRecordSize": "7",
   					"classification": "csv",
   					"objectCount": "1",
   					"typeOfData": "file",
   					"CrawlerSchemaDeserializerVersion": "1.0",
   					"CrawlerSchemaSerializerVersion": "1.0",
   					"UPDATED_BY_CRAWLER": "crawl_date_table",
   					"recordCount": "9",
   					"columnsOrdered": "true"
   				},
   				"StorageDescriptor": {
   					"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   					"SortColumns": [],
   					"StoredAsSubDirectories": false,
   					"Columns": [
   						{
   							"Name": "col1",
   							"Type": "string"
   						},
   						{
   							"Name": "col2",
   							"Type": "bigint"
   						}
   					],
   					"Location": "s3://myAthenatest/test_dataset/",
   					"NumberOfBuckets": -1,
   					"Parameters": {
   						"delimiter": ",",
   						"compressionType": "none",
   						"skip.header.line.count": "1",
   						"columnsOrdered": "true",
   						"sizeKey": "75",
   						"averageRecordSize": "7",
   						"classification": "csv",
   						"objectCount": "1",
   						"typeOfData": "file",
   						"CrawlerSchemaDeserializerVersion": "1.0",
   						"CrawlerSchemaSerializerVersion": "1.0",
   						"UPDATED_BY_CRAWLER": "crawl_date_table",
   						"recordCount": "9"
   					},
   					"Compressed": false,
   					"BucketColumns": [],
   					"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   					"SerdeInfo": {
   						"Parameters": {
   						"field.delim": ","
   						},
   						"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe"
   					}
   				}
   			}
   		]
   	}
   ```

1. Modifiez la définition de la table dans votre éditeur pour y ajouter `"TableType": "EXTERNAL_TABLE"`, comme illustré dans l’exemple suivant.

   ```
   {
   	"Table": {
   		"Retention": 0,
   		"TableType": "EXTERNAL_TABLE",
   		"PartitionKeys": [
   			{
   				"Name": "year",
   				"Type": "string"
   			},
   			{
   				"Name": "month",
   				"Type": "string"
   			},
   			{
   				"Name": "day",
   				"Type": "string"
   			}
   		],
   		"UpdateTime": 1522368588.0,
   		"Name": "table_missing_table_type",
   		"StorageDescriptor": {
   			"BucketColumns": [],
   			"SortColumns": [],
   			"StoredAsSubDirectories": false,
   			"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   			"SerdeInfo": {
   				"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
   				"Parameters": {
   					"field.delim": ","
   				}
   			},
   			"Parameters": {
   				"classification": "csv",
   				"CrawlerSchemaSerializerVersion": "1.0",
   				"UPDATED_BY_CRAWLER": "crawl_date_table",
   				"columnsOrdered": "true",
   				"averageRecordSize": "7",
   				"objectCount": "1",
   				"sizeKey": "75",
   				"delimiter": ",",
   				"compressionType": "none",
   				"recordCount": "9",
   				"CrawlerSchemaDeserializerVersion": "1.0",
   				"typeOfData": "file",
   				"skip.header.line.count": "1"
   			},
   			"Columns": [
   				{
   					"Name": "col1",
   					"Type": "string"
   				},
   				{
   					"Name": "col2",
   					"Type": "bigint"
   				}
   			],
   			"Compressed": false,
   			"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   			"NumberOfBuckets": -1,
   			"Location": "s3://myAthenatest/test_date_part/"
   		},
   		"Owner": "owner",
   		"Parameters": {
   			"classification": "csv",
   			"CrawlerSchemaSerializerVersion": "1.0",
   			"UPDATED_BY_CRAWLER": "crawl_date_table",
   			"columnsOrdered": "true",
   			"averageRecordSize": "7",
   			"objectCount": "1",
   			"sizeKey": "75",
   			"delimiter": ",",
   			"compressionType": "none",
   			"recordCount": "9",
   			"CrawlerSchemaDeserializerVersion": "1.0",
   			"typeOfData": "file",
   			"skip.header.line.count": "1"
   		},
   		"LastAccessTime": 1513804142.0
   	}
   	}
   ```

1. Vous pouvez adapter le script suivant pour mettre à jour l’entrée sur la table, afin qu’elle comprenne l’attribut `TableType`.

   ```
   aws glue update-table --database-name <your_datebase_name> --table-input <updated_table_input>
   ```

   Vous en trouverez un exemple ci-dessous. 

   ```
   aws glue update-table --database-name test_database --table-input '
   	{
   			"Retention": 0,
   			"TableType": "EXTERNAL_TABLE",
   			"PartitionKeys": [
   				{
   					"Name": "year",
   					"Type": "string"
   				},
   				{
   					"Name": "month",
   					"Type": "string"
   				},
   				{
   					"Name": "day",
   					"Type": "string"
   				}
   			],
   			"Name": "table_missing_table_type",
   			"StorageDescriptor": {
   				"BucketColumns": [],
   				"SortColumns": [],
   				"StoredAsSubDirectories": false,
   				"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   				"SerdeInfo": {
   					"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
   					"Parameters": {
   						"field.delim": ","
   					}
   				},
   				"Parameters": {
   					"classification": "csv",
   					"CrawlerSchemaSerializerVersion": "1.0",
   					"UPDATED_BY_CRAWLER": "crawl_date_table",
   					"columnsOrdered": "true",
   					"averageRecordSize": "7",
   					"objectCount": "1",
   					"sizeKey": "75",
   					"delimiter": ",",
   					"compressionType": "none",
   					"recordCount": "9",
   					"CrawlerSchemaDeserializerVersion": "1.0",
   					"typeOfData": "file",
   					"skip.header.line.count": "1"
   				},
   				"Columns": [
   					{
   						"Name": "col1",
   						"Type": "string"
   					},
   					{
   						"Name": "col2",
   						"Type": "bigint"
   					}
   				],
   				"Compressed": false,
   				"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   				"NumberOfBuckets": -1,
   				"Location": "s3://myAthenatest/test_date_part/"
   			},
   			"Owner": "owner",
   			"Parameters": {
   				"classification": "csv",
   				"CrawlerSchemaSerializerVersion": "1.0",
   				"UPDATED_BY_CRAWLER": "crawl_date_table",
   				"columnsOrdered": "true",
   				"averageRecordSize": "7",
   				"objectCount": "1",
   				"sizeKey": "75",
   				"delimiter": ",",
   				"compressionType": "none",
   				"recordCount": "9",
   				"CrawlerSchemaDeserializerVersion": "1.0",
   				"typeOfData": "file",
   				"skip.header.line.count": "1"
   			},
   			"LastAccessTime": 1513804142.0
   		}'
   ```

# Tableau introuvable lors de l'utilisation d'Athena avec Amazon Quick Sight
<a name="troubleshoot-athena-table-not-found"></a>

Vous pouvez recevoir un message d’erreur « `table not found` » si les tables d’une analyse ne sont pas présentes dans la source de données Athena. 

Dans la console Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)), recherchez votre table sous le schéma correspondant. Vous pouvez recréer la table dans Athena, puis créer un nouvel ensemble de données dans Amazon Quick Sight sur cette table. Pour comprendre comment la table a été perdue, vous pouvez utiliser la console Athena pour vérifier l’historique des requêtes. Cela vous permet de trouver les requêtes perdues.

Si cette erreur s’est produite lors de la modification d’une requête SQL personnalisée dans la version préliminaire, vérifiez le nom de la table dans la requête, et recherchez d’éventuelles erreurs de syntaxe. Amazon Quick Sight ne peut pas déduire le schéma à partir de la requête. Le schéma doit être spécifié dans la requête. 

Par exemple, l’instruction suivante fonctionne.

```
select from my_schema.my_table
```

L’instruction suivante échoue, car le schéma n’y est pas présent.

```
select from my_table
```

Si le problème persiste, vérifiez que vos tables, colonnes et requêtes sont conformes aux exigences d’Athena. Pour plus d’informations, consultez les rubriques [Noms des tables, des bases de données et des colonnes](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) et [Dépannage](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) dans le *Guide de l’utilisateur Athena*.

# Erreurs de groupe de travail et de sortie lors de l'utilisation d'Athena avec Quick Sight
<a name="troubleshoot-athena-workgroup"></a>

Pour confirmer que les groupes de travail sont correctement configurés, vérifiez les paramètres suivants :
+ **Le groupe de travail Athena associé à la source de données doit exister.**

  Pour résoudre ce problème, vous pouvez revenir aux paramètres de la source de données Athena et choisir un autre groupe de travail. Pour plus d’informations, consultez la rubrique [Configuration de groupes de travail](https://docs.aws.amazon.com/athena/latest/ug/workgroups-procedure.html) dans le *Guide de l’utilisateur Athena*.

  Une autre solution consiste à demander à l' Compte AWS administrateur de recréer le groupe de travail dans la console Athena. 
+ **Le groupe de travail Athena associé à la source de données doit être activé.**

  Un Compte AWS administrateur doit activer le groupe de travail dans la console Athena. Ouvrez la console Athena en utilisant ce lien direct :. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) Choisissez ensuite le groupe de travail approprié dans le panneau **Workgroup (Groupe de travail)** et affichez ses paramètres. Choisissez **Activer le groupe de travail**. 
+ **Assurez-vous que vous avez accès à l’emplacement de sortie Amazon S3 associé au groupe de travail Athena.**

  Pour accorder à Amazon Quick Sight l'autorisation d'accéder à l'emplacement de sortie S3, l'administrateur d'Amazon Quick Sight peut modifier la **sécurité et les autorisations** dans l' QuickSightécran **Gérer**. 
+ **Un emplacement de sortie S3 doit être associé au groupe de travail Athena.**

  Un Compte AWS administrateur doit associer un compartiment S3 au groupe de travail dans la console Athena. Ouvrez la console Athena en utilisant ce lien direct :. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) Choisissez ensuite le groupe de travail approprié dans le panneau **Workgroup (Groupe de travail)** et affichez ses paramètres. Renseignez le champ **Emplacement des résultats de requête**. 