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

# 支援的 Amazon S3 清單檔案格式
<a name="supported-manifest-file-format"></a>

您可以使用 JSON 資訊清單檔案，在 Amazon S3 中指定檔案以匯入 Quick Sight。這些 JSON 資訊清單檔案可以使用以下所述的 Quick Sight 格式或《Amazon Redshift 資料庫開發人員指南》中的[使用資訊清單來指定資料檔案](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html)中所述的 Amazon Redshift 格式。 **您不需要使用 Amazon Redshift 來使用 Amazon Redshift 清單檔案格式。

如果您使用 Quick Sight 資訊清單檔案，它必須具有 .json 副檔名，例如 `my_manifest.json`。如果您使用 Amazon Redshift 清單檔案，它可以有任何副檔名。

如果您使用 Amazon Redshift 資訊清單檔案，Quick Sight 會像 Amazon Redshift 一樣處理選用`mandatory`選項。如果找不到相關聯的檔案，Quick Sight 會結束匯入程序並傳回錯誤。

您選取匯入的檔案必須是分隔的文字 (例如，.csv 或 .tsv)、日誌 (.clf) 或延伸日誌 (.elf) 格式，或 JSON (.json)。一個資訊清單檔案中識別的所有個檔案，必須使用相同的檔案格式。另外，它們必須具有相同數量和類型的資料欄。Quick Sight 支援 UTF-8 檔案編碼，但不支援具有位元組順序標記 (BOM) 的 UTF-8。如果您要匯入 JSON 檔案，則對於 `globalUploadSettings`，請指定 `format`，而不是 `delimiter`、`textqualifier` 和 `containsHeader`。

請確定您指定的任何檔案都位於您已授予 Quick Sight 存取權的 Amazon S3 儲存貯體中。如需授予 Quick Sight AWS 資源存取權的詳細資訊，請參閱 [設定 AWS Amazon Quick Sight 對資料來源的存取](access-to-aws-resources.md)。

## Quick Sight 的資訊清單檔案格式
<a name="quicksight-manifest-file-format"></a>

Quick Sight 資訊清單檔案使用以下 JSON 格式。

```
{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
```

使用 `fileLocations` 元素中的欄位以指定要匯入的檔案，使用 `globalUploadSettings` 元素中的欄位以指定這些檔案的匯入設定，例如欄位分隔符號。

資訊清單檔案元素如下所述：
+ **fileLocations** – 此元素用於指定要匯入的檔案。您可以使用 `URIs` 和 `URIPrefixes` 陣列其中一個或兩個都用來這樣做。您至少必須在其中之一指定一個值。
  + **URI** – 此陣列用於列出要匯入之特定檔案的 URI。

    Quick Sight 可以存取任何 中的 Amazon S3 檔案 AWS 區域。不過，如果您的 Amazon S3 儲存貯體與 Quick 帳戶所使用的區域不同，您必須使用識別 Amazon S3 儲存貯 AWS 體區域的 URI 格式。

    支援下列格式的 URI。  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/supported-manifest-file-format.html)
  + **URIPrefixes** – 此陣列用於列出 S3 儲存貯體和資料夾的 URI 前綴。指定儲存貯體或資料夾中的所有檔案都會匯入。Quick Sight 會以遞迴方式從子資料夾擷取檔案。

    Quick Sight 可以存取任何 中的 Amazon S3 儲存貯體或資料夾 AWS 區域。 AWS 區域 如果 S3 儲存貯體與您的快速帳戶使用不同，請務必使用識別 S3 儲存貯體的 URI 字首格式。

    支援下列格式的 URI 前綴。  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/supported-manifest-file-format.html)
+ **globalUploadSettings** – (選用) 此元素用於指定 Amazon S3 檔案的匯入設定，例如欄位分隔符號。如果未指定此元素，Quick Sight 會使用本節中欄位的預設值。
**重要**  
對於日誌 (.clf) 和延伸日誌 (.elf) 檔案，此區段中只有 **format** 欄位適用，因此您可以略過其他欄位。如果您選擇包含它們，則會忽略它們的值。
  + **format** – (選用) 指定要匯入的檔案的格式。有效格式為 **CSV**、**TSV**、**CLF**、**ELF** 和 **JSON**。預設值為 **CSV**。
  + **delimiter** – (選用) 指定檔案欄位分隔符號。這必須映射到 `format` 欄位中指定的檔案類型。有效格式為 .csv 檔案的逗號 (**,**) 和 .tsv 檔案的製表符 (**\\t**)。預設值為逗號 (**,**)。
  + **textqualifier** – (選用) 指定檔案文字限定詞。有效格式為單引號 (**'**)、雙引號 (**\\"**)。對於 JSON 中的雙引號，前導反斜線是必要的逸出字元。預設值為雙引號 (**\\"**)。如果您的文字不需要文字限定詞，請勿加入此屬性。
  + **containsHeader** – (選用) 指定檔案是否有標題列。有效格式為 **true** 或 **false**。預設值為 **true**。

### Quick Sight 的資訊清單檔案範例
<a name="quicksight-manifest-file-examples"></a>

以下是已完成 Quick Sight 資訊清單檔案的一些範例。

以下範例顯示的資訊清單檔案中識別兩個要匯入的特定 .csv 檔案。這些檔案使用雙引號作為文字限定詞。因為可接受預設值，所以略過 `format`、`delimiter` 和 `containsHeader` 欄位。

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://{{yourBucket}}.{{s3}}.{{amazonaws.com}}/{{data-file.csv}}",
                "https://{{yourBucket}}.{{s3}}.{{amazonaws.com}}/{{data-file-2.csv}}"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}
```

以下範例顯示的資訊清單檔案，可識別一個要匯入的特定 .tsv 檔案。此檔案還包含位在另一個 AWS 區域的儲存貯體，內含要匯入的其他 .tsv 檔案。因為可接受預設值，所以略過 `textqualifier` 和 `containsHeader` 欄位。

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://{{s3}}.{{amazonaws.com/}}{{amzn-s3-demo-bucket}}/{{data.tsv}}"
            ]
        },
        {
            "URIPrefixes": [
                "https://{{s3-us-east-1.amazonaws.com}}/{{amzn-s3-demo-bucket}}/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}
```

以下範例識別的兩個儲存貯體包含要匯入的 .clf 檔案。一個與 Quick 帳戶 AWS 區域 位於相同的 ，另一個位於不同的 AWS 區域。因為 `delimiter`、`textqualifier` 和 `containsHeader` 欄位不適用於日誌檔，所以會略過。

```
{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://{{amzn-s3-demo-bucket1}}.{{your-s3-url}}.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}
```

以下範例使用 Amazon Redshift 格式來標識要匯入的 .csv 檔案。

```
{
    "entries": [
        {
            "url": "https://{{amzn-s3-demo-bucket}}.{{your-s3-url}}.com/myalias-test/file-to-import.csv",
            "mandatory": true
        }
    ]
}
```

以下範例使用 Amazon Redshift 格式來標識兩個要匯入的 JSON 檔案。

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://{{yourBucket}}.{{s3}}.{{amazonaws.com}}/{{data-file.json}}",
                "https://{{yourBucket}}.{{s3}}.{{amazonaws.com}}/{{data-file-2.json}}"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}
```