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

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

支援的 Amazon S3 清單檔案格式

您可以使用JSON資訊清單檔案來指定 Amazon S3 中的檔案,以匯入 Amazon QuickSight。這些JSON資訊清單檔案可以使用以下描述的 Amazon QuickSight 格式,也可以使用資訊清單來指定 Amazon Redshift 資料庫開發人員指南 中的資料檔案您不需要使用 Amazon Redshift 來使用 Amazon Redshift 清單檔案格式。

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

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

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

請確定您指定的任何檔案都位於您已授予 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 – 使用此元素指定要匯入的檔案。您可以使用 URIsURIPrefixes 陣列其中一個或兩個都用來這樣做。您至少必須在其中之一指定一個值。

    • URIs – 使用此陣列URIs列出要匯入的特定檔案。

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

      URIs 支援下列格式。

      URI 格式 範例 說明
      https://s3.amazonaws.com/<儲存貯體名稱 >/<檔案名稱 > 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類型可識別 AWS 區域 Amazon S3 儲存貯體的 。

      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 區域。 AWS 區域 如果 S3 儲存貯體與 QuickSight 您的帳戶所使用的儲存貯體不同,請務必使用可識別 S3 儲存貯體的URI字首格式。

      URI 支援下列格式的字首。

      URI 字首格式 範例 說明

      https://s3.amazonaws.com/<儲存貯體名稱 >/

      https://s3.amazonaws.com/awsexamplebucket/
      https://s3.amazonaws.com/<儲存貯體名稱 >/<folder name1>/(<folder name2>/etc.) https://s3.amazonaws.com/awsexamplebucket/資料夾1/
      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-us-east-2.amazonaws.com/awsexamplebucket/ 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 – (選用) 指定要匯入的檔案的格式。有效格式為 CSVTSVCLFELFJSON。預設值為 CSV

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

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

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

Amazon 的清單檔案範例 QuickSight

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

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

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

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

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

以下範例識別的兩個儲存貯體包含要匯入的 .clf 檔案。一個與 Amazon QuickSight 帳戶 AWS 區域 相同,另一個位於不同的 AWS 區域。因為 delimitertextqualifiercontainsHeader 欄位不適用於日誌檔,所以會略過。

{ "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" } }