支援的 Amazon S3 清單檔案格式

您可以使用 JSON 資訊清單檔案在 Amazon S3 中指定要匯入到 Amazon 的檔案 QuickSight。這些 JSON 資訊清單檔案可以使用如下所述的 Amazon QuickSight 格式，或使用資訊清單指定資料檔案中所述的 Amazon Redshift 格式，請參閱 Amazon Redshift 資料庫開發人員指南。您不需要使用 Amazon Redshift 來使用 Amazon Redshift 清單檔案格式。

例my_manifest.json如，如果您使用 Amazon QuickSight 資訊清單檔案，則其副檔名必須為 .json。如果您使用 Amazon Redshift 清單檔案，它可以有任何副檔名。

如果您使用 Amazon Redshift 清單文件，Amazon 會像亞馬 Amazon Redshift 一樣 QuickSight 處理可選mandatory選項。如果找不到關聯的檔案，Amazon 會 QuickSight 結束匯入程序並傳回錯誤訊息。

您選取匯入的檔案必須是分隔的文字 (例如，.csv 或 .tsv)、日誌 (.clf) 或延伸日誌 (.elf) 格式，或 JSON (.json)。一個資訊清單檔案中識別的所有個檔案，必須使用相同的檔案格式。另外，它們必須具有相同數量和類型的資料欄。Amazon QuickSight 支持 UTF-8 文件編碼，但不支持 UTF-8（適用於南方 -1）。如果您要匯入 JSON 檔案，則對於 globalUploadSettings，請指定 format，而不是 delimiter、textqualifier 和 containsHeader。

請確定您指定的任何檔案都位於您已授與 Amazon 存取權的 Amazon S3 儲 QuickSight 存貯體中。如需授予 Amazon 資源 QuickSight 存取權的相關 AWS 資訊，請參閱存取資料來源。

Amazon 的清單文件格式 QuickSight

Amazon QuickSight 清單文件使用以下 JSON 格式。

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

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

資訊清單檔案元素如下所述：

• fileLocations – 此元素用於指定要匯入的檔案。您可以使用 URIs 和 URIPrefixes 陣列其中一個或兩個都用來這樣做。您至少必須在其中之一指定一個值。

  • URI – 此陣列用於列出要匯入之特定檔案的 URI。

    Amazon QuickSight 可以訪問 Amazon S3 文件是在任何 AWS 區域. 但是，如果 Amazon S3 儲存貯體的區域與 Amazon QuickSight 帳戶所使用的 AWS 區域不同，則必須使用 URI 格式來識別該儲存貯體的區域。

    支援下列格式的 URI。

    URI 格式	範例	說明
    https://s3.amazonaws.com/<bucket name>/<file name>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<bucket name>/<file name>	s3://awsexamplebucket/data.csv
    https://<bucket name>.s3.amazonaws.com/<file name>	https://awsexamplebucket.s3.amazonaws.com/data.csv
    https://s3-<region name>.amazonaws.com/<bucket name>/<file name>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	這個 URI 類型可識別 Amazon S3 儲存貯體的 AWS 區域 。
    https://<bucket name>.s3-<region name>.amazonaws.com/<file name>	https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv	此 URI 類型可識別 Amazon S3 儲存貯體的。 AWS 區域

  • URIPrefixes – 此陣列用於列出 S3 儲存貯體和資料夾的 URI 前綴。指定儲存貯體或資料夾中的所有檔案都會匯入。Amazon QuickSight 遞歸地從子文件夾中檢索文件。

    QuickSight 可以訪問 Amazon S3 存儲桶或任何 AWS 區域. 確保使用 URI 前綴格式，以識別 S3 存儲桶（ AWS 區域 如果它與您的 QuickSight 帳戶使用的不同）。

    支援下列格式的 URI 前綴。

    URI 前置字元格式	範例	說明
    https://s3.amazonaws.com/<bucket name>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<bucket name>	s3://awsexamplebucket/
    s3://<bucket name>/<folder name1>/(<folder name2>/etc.)	s3://awsexamplebucket/folder1/
    https://<bucket name>.s3.amazonaws.com	https://awsexamplebucket.s3.amazonaws.com
    https://s3-<region name>.amazonaws.com/<bucket name>/	https://s3-your-region-for-example美國東部-2. 亞馬遜網站/安全管理/	此URIPrefix類型可識別 Amazon S3 儲存貯體的儲存貯體。 AWS 區域
    https://s3-<region name>.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	此URIPrefix類型可識別 Amazon S3 儲存貯體的儲存貯體。 AWS 區域
    https://<bucket name>.s3-<region name>.amazonaws.com	https://awsexamplebucket.s3-us-east-1.amazonaws.com	此URIPrefix類型可識別 Amazon S3 儲存貯體的儲存貯體。 AWS 區域

• globalUploadSettings— (選擇性) 使用此元素指定 Amazon S3 檔案的匯入設定，例如欄位分隔符號。如果未指定此元素，Amazon QuickSight 會使用本節中欄位的預設值。

  重要

  對於日誌 (.clf) 和延伸日誌 (.elf) 檔案，此區段中只有 format 欄位適用，因此您可以略過其他欄位。如果您選擇包含它們，則會忽略它們的值。

  • format – (選用) 指定要匯入的檔案的格式。有效格式為 CSV、TSV、CLF、ELF 和 JSON。預設值為 CSV。

  • delimiter – (選用) 指定檔案欄位分隔符號。這必須映射到 format 欄位中指定的檔案類型。有效格式為 .csv 檔案的逗號 (,) 和 .tsv 檔案的製表符 (\t)。預設值為逗號 (,)。

  • textqualifier – (選用) 指定檔案文字限定詞。有效格式為單引號 (')、雙引號 (\")。對於 JSON 中的雙引號，前導反斜線是必要的逸出字元。預設值為雙引號 (\")。如果您的文字不需要文字限定詞，請勿加入此屬性。

  • containsHeader – (選用) 指定檔案是否有標題列。有效格式為 true 或 false。預設值為 true。

Amazon 的清單文件示例 QuickSight

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

以下範例顯示的資訊清單檔案中識別兩個要匯入的特定 .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/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}

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

{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

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

{
    "entries": [
        {
            "url": "https://awsexamplebucket.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"
    }
}