Spécifier l'emplacement d'une table dans Amazon S3 - Amazon Athena

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.

Spécifier l'emplacement d'une table dans Amazon S3

Lorsque vous exécutez une CREATE TABLE requête dans Athéna, Athéna enregistre votre table dans le catalogue de AWS Glue données, dans lequel Athéna stocke vos métadonnées.

Pour spécifier le chemin d'accès à vos données dans Amazon S3, utilisez la LOCATION propriété dans votre CREATE TABLE déclaration, comme dans l'exemple suivant :

CREATE EXTERNAL TABLE `test_table`(
...
)
ROW FORMAT ...
STORED AS INPUTFORMAT ...
OUTPUTFORMAT ...
LOCATION s3://amzn-s3-demo-bucket/folder/

  • Pour plus d'informations sur l'attribution de noms aux compartiments, consultez la section Restrictions et limites des compartiments du Guide de l'utilisateur Amazon Simple Storage Service.

  • Pour plus d'informations sur l'utilisation des dossiers dans Simple Storage Service (Amazon S3), consultez la section Utilisation des dossiers du Guide de l'utilisateur de la console Amazon Simple Storage Service.

La propriété LOCATION dans Simple Storage Service (Amazon S3) spécifie tous les fichiers représentant votre table.

Important

Athena lit toutes les données stockées dans le dossier Simple Storage Service (Amazon S3) que vous spécifiez. Si vous avez des données que vous ne voulez pas qu'Athena lise, ne les stockez pas dans le même dossier Simple Storage Service (Amazon S3) que les données que vous voulez qu'Athena lise.

Lorsque vous spécifiez la propriété LOCATION dans l'instruction CREATE TABLE, suivez les instructions suivantes :

  • Utilisez une barre oblique de fin.

  • Vous pouvez utiliser un chemin d'accès à un dossier Simple Storage Service (Amazon S3) ou un alias de point d'accès Simple Storage Service (Amazon S3). Pour plus d'informations sur les alias de point d'accès Simple Storage Service (Amazon S3), consultez la rubrique Utilisation d'un alias de type compartiment pour votre point d'accès du Guide de l'utilisateur Simple Storage Service (Amazon S3).

Utilisez :

s3://amzn-s3-demo-bucket/folder/
s3://amzn-s3-demo-bucket-metadata-s3alias/folder/

N'utilisez aucun des éléments suivants pour spécifier LOCATION pour vos données.

  • N'utilisez pas les noms de fichiers, les traits de soulignement, les caractères génériques ni les modèles glob pour spécifier les emplacements des fichiers.

  • N'ajoutez pas la HTTP notation complète, par exemple s3.amazon.com au chemin du compartiment Amazon S3.

  • N'utilisez pas de dossiers vides comme // dans le chemin d'accès, comme ci-après : S3://amzn-s3-demo-bucket/folder//folder/.

  • N'utilisez pas de chemins tels que les suivants :

    s3://amzn-s3-demo-bucket
s3://amzn-s3-demo-bucket/*
s3://amzn-s3-demo-bucket/mySpecialFile.dat
s3://amzn-s3-demo-bucket/prefix/filename.csv
s3://amzn-s3-demo-bucket.s3.amazon.com
S3://amzn-s3-demo-bucket/prefix//prefix/
arn:aws:s3:::amzn-s3-demo-bucket/prefix
s3://arn:aws:s3:<region>:<account_id>:accesspoint/<accesspointname>
https://<accesspointname>-<number>.s3-accesspoint.<region>.amazonaws.com