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.
Vous pouvez utiliser Athena pour interroger des objets restaurés à partir des classes de stockage Amazon S3 S3 Glacier Flexible Retrieval (anciennement Glacier) et S3 Glacier Deep Archive. Vous devez activer cette fonctionnalité par table. Si vous ne souhaitez pas activer la fonctionnalité sur une table avant d'exécuter une requête, Athena ignore tous les objets S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive de la table lors de l'exécution de la requête.
Considérations et restrictions
-
L'interrogation des objets Amazon S3 Glacier restaurés est prise en charge uniquement sur la version 3 du moteur Athena.
-
La fonctionnalité est prise en charge uniquement pour les tables Apache Hive.
-
Vous devez restaurer vos objets avant d'interroger vos données ; Athena ne les restaure pas à votre place.
Configuration d'un tableau pour utiliser les objets restaurés
Pour configurer votre table Athena afin d'inclure des objets restaurés dans vos requêtes, vous devez définir sa propriété de table read_restored_glacier_objects
sur true
. Pour ce faire, vous pouvez utiliser l'éditeur de requêtes Athena ou la AWS Glue console. Vous pouvez également utiliser l'interface de ligne de commande AWS Glue
Utiliser l'éditeur de requêtes Athena
Dans Athena, vous pouvez utiliser la commande ALTER TABLE SET TBLPROPERTIES pour définir la propriété de table, comme dans l'exemple suivant.
ALTER TABLE table_name SET TBLPROPERTIES ('read_restored_glacier_objects' = 'true')
Utiliser la AWS Glue console
Dans la AWS Glue console, effectuez les étapes suivantes pour ajouter la propriété de read_restored_glacier_objects
table.
Pour configurer les propriétés du tableau dans la AWS Glue console
Connectez-vous à la AWS Glue console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/glue/
. -
Effectuez l’une des actions suivantes :
-
Choisissez Accéder au catalogue de données.
-
Dans le panneau de navigation, choisissez Tables du catalogue de données.
-
-
Sur la page Tables, dans la liste des tables, choisissez le lien correspondant à la table que vous souhaitez modifier.
-
Sélectionnez Actions, puis Modifier la table.
-
Sur la page Modifier la table, dans la section Propriétés de la table, ajoutez la paire clé-valeur suivante.
-
Dans Clé, ajoutez
read_restored_glacier_objects
. -
Pour le champ Value (Valeur), entrez
true
.
-
-
Choisissez Save (Enregistrer).
Utilisez le AWS CLI
Dans le AWS CLI, vous pouvez utiliser la commande AWS Glue update-table--table-input
argument pour redéfinir la table et, ce faisant, ajouter la propriété. read_restored_glacier_objects
Dans l'argument --table-input
, utilisez la structure Parameters
pour spécifier la propriété read_restored_glacier_objects
et la valeur de true
. Notez que l'argument pour --table-input
ne doit pas comporter d'espaces et doit utiliser des barres obliques inverses pour éviter les guillemets doubles. Dans l'exemple suivant, remplacez my_database
et my_table
par le nom de votre base de données et de votre table.
aws glue update-table \ --database-name
my_database
\ --table-input={\"Name\":\"my_table
\",\"Parameters\":{\"read_restored_glacier_objects\":\"true\"}}
Important
La AWS Glue update-table
commande fonctionne en mode de remplacement, ce qui signifie qu'elle remplace la définition de table existante par la nouvelle définition spécifiée par le table-input
paramètre. Pour cette raison, veillez également à spécifier tous les champs que vous souhaitez voir figurer dans votre table dans le table-input
paramètre lorsque vous ajoutez la read_restored_glacier_objects
propriété.