本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon S3 中指定資料表位置
<a name="tables-location-format"></a>

當您在 Athena 中執行`CREATE TABLE`查詢時，Athena 會向 AWS Glue Data Catalog 註冊資料表，這是 Athena 存放中繼資料的位置。

若要在 Amazon S3 中指定資料的路徑，請在 `CREATE TABLE` 陳述式中使用 `LOCATION` 屬性，如下列範例所示：

```
CREATE EXTERNAL TABLE `test_table`(
...
)
ROW FORMAT ...
STORED AS INPUTFORMAT ...
OUTPUTFORMAT ...
LOCATION s3://amzn-s3-demo-bucket/{{folder}}/
```
+ 如需有關命名儲存貯體的詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》**中的[儲存貯體限制](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html)。
+ 如需有關在 Amazon S3 中使用資料夾的詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》**中的[使用資料夾](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-folders.html)。

Amazon S3 中的 `LOCATION` 會指定代表您資料表的*所有*檔案。

**重要**  
Athena 會讀取在您指定的 Amazon S3 資料夾中存放的*所有*資料。如果您有*不*希望 Athena 讀取的資料，請勿使用與您希望 Athena 讀取之資料相同的 Amazon S3 資料夾存放該資料。

當您在 `CREATE TABLE` 陳述式中指定 `LOCATION` 時，請使用下列指導方針：
+ 使用後置斜線。
+ 您可以使用 Amazon S3 資料夾的路徑或 Amazon S3 存取點別名。如需有關 Amazon S3 存取點別名的資訊，請參閱《Amazon S3 使用者指南》**中的[為存取點使用儲存貯體型別名](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-alias.html)。

 **使用**：

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

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

請勿使用以下任何項目指定您資料的 `LOCATION`。
+ 請勿使用檔案名稱、底線、萬用字元或 glob 模式來指定檔案位置。
+ 請勿將完整 HTTP 標記法 (例如 `s3.amazon.com`) 新增至 Amazon S3 儲存貯體路徑。
+ 請勿在路徑中使用 `//` 等使用空的資料夾，如下所示：`S3://amzn-s3-demo-bucket/{{folder}}//{{folder}}/`。
+ 請勿使用如下路徑：

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