

# Especificar um local de tabela no Amazon S3
<a name="tables-location-format"></a>

Quando você executa uma consulta `CREATE TABLE` no Athena, ele registra a tabela no Catálogo de Dados do AWS Glue, que é onde o Athena armazena os metadados.

Para especificar o caminho para os seus dados no Amazon S3, use a propriedade `LOCATION` na sua instrução `CREATE TABLE`, conforme o exemplo a seguir:

```
CREATE EXTERNAL TABLE `test_table`(
...
)
ROW FORMAT ...
STORED AS INPUTFORMAT ...
OUTPUTFORMAT ...
LOCATION s3://amzn-s3-demo-bucket/{{folder}}/
```
+ Para obter informações sobre a nomenclatura de buckets, consulte [Restrições e limitações do bucket](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html) no *Guia do usuário do Amazon Simple Storage Service*.
+ Para obter informações sobre o uso de pastas no Amazon S3, consulte [Usar pastas](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-folders.html) no *Guia do usuário do Amazon Simple Storage Service*. 

O `LOCATION` no Amazon S3 especifica *todos* os arquivos que representam sua tabela. 

**Importante**  
O Athena lê *todos* os dados armazenados na pasta do Amazon S3 que você especificar. Se você tem dados que *não* deseja que o Athena leia, não os armazene na mesma pasta do Amazon S3 que os dados que deseja que o Athena leia.

Ao especificar o `LOCATION` na instrução `CREATE TABLE`, use as seguintes diretrizes:
+ Use uma barra no final.
+ Você pode usar um caminho para uma pasta do Amazon S3 ou um alias de ponto de acesso do Amazon S3. Para obter informações sobre aliases de ponto de acesso do Amazon S3, consulte [Usar um alias em estilo de bucket para seu ponto de acesso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-alias.html) no *Manual do usuário do Amazon S3*.

 **Use:**

```
s3://amzn-s3-demo-bucket/{{folder}}/
```

```
s3://amzn-s3-demo-bucket-{{metadata}}-s3alias/{{folder}}/
```

Não use nenhum dos itens a seguir para especificar a `LOCATION` dos dados.
+ Não use nomes de arquivo, sublinhado, curingas ou padrões glob para especificar locais de arquivos.
+ Não adicione a notação HTTP completa, como `s3.amazon.com` ao caminho do bucket do Amazon S3.
+ Não use pastas vazias, como `//`, no caminho, conforme segue: `S3://amzn-s3-demo-bucket/{{folder}}//{{folder}}/`. 
+ Não use os caminhos da seguinte maneira:

  ```
  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
  ```