支援的 Amazon S3 清單檔案格式 - Amazon QuickSight
Amazon QuickSight 的清單檔案格式

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

支援的 Amazon S3 清單檔案格式

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

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

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

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

請確定您指定的任何檔案都位於您已授予 Amazon QuickSight 存取權的 Amazon S3 儲存貯體中。如需授權 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 QuickSight 帳戶所用的 Amazon S3 儲存貯體位於其他 AWS 區域，您即必須使用 URI 格式識別該區域。

      支援下列格式的 URI。

      URI 格式 範例 說明
      https://s3.amazonaws.com/<bucket name>/<file name> https://s3.amazonaws.com/amzn-s3-demo-bucket/data.csv
      s3://<bucket name>/<file name> s3：//amzn-s3-demo-bucket/data.csv
      https://<bucket name>.s3.amazonaws.com/<file name> https：//amzn-s3-demo-bucket.s3.amazonaws.com/data.csv
      https://s3-<region name>.amazonaws.com/<bucket name>/<file name> https：//s3-us-east-1.amazonaws.comamzn-s3-demo-bucket/data.csv

      這個 URI 類型可識別 Amazon S3 儲存貯體的 AWS 區域 。

      https://<bucket name>.s3-<region name>.amazonaws.com/<file name>

      		 https：//amzn-s3-demo-bucket.s3-us-east-1.amazonaws.com/data.csv 此 URI 類型可識別 Amazon S3 儲存貯 AWS 區域 體的 。

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

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

      支援下列格式的 URI 前綴。

      URI 前置字元格式 範例 說明

      https://s3.amazonaws.com/<bucket name>/

      		 https://s3.amazonaws.com/amzn-s3-demo-bucket/
      https://s3.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.) https://s3.amazonaws.com/amzn-s3-demo-bucket/folder1/
      s3://<bucket name> s3：//amzn-s3-demo-bucket/
      s3://<bucket name>/<folder name1>/(<folder name2>/etc.) s3：//amzn-s3-demo-bucket/folder1/

      https://<bucket name>.s3.amazonaws.com

      		 https：//amzn-s3-demo-bucket.s3.amazonaws.com
      https://s3-<region name>.amazonaws.com/<bucket name>/ https：//s3-your-region-for-example-us-east-2.amazonaws.com/amzn-s3-demo-bucket/ 此URIPrefix類型可識別 Amazon S3 儲存貯體 AWS 區域 的 。
      https://s3-<region name>.amazonaws.com/<bucket name>/<folder name1>/(<folder name2>/etc.) https：//s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/folder1/ 此URIPrefix類型可識別 Amazon S3 儲存貯體 AWS 區域 的 。
      https://<bucket name>.s3-<region name>.amazonaws.com

      https：//amzn-s3-demo-bucket.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/amzn-s3-demo-bucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}

以下範例識別的兩個儲存貯體包含要匯入的 .clf 檔案。一個與 Amazon QuickSight 帳戶 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"
    }
}