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

# AWS Marketplace 資料饋送的儲存和結構
<a name="data-feed-details"></a>

AWS Marketplace 提供資料饋送作為一種機制，在賣方擁有的商業智慧工具之間，將結構化up-to-date產品和客戶資訊從 AWS Marketplace 系統傳送至賣方 Amazon S3 儲存貯體以進行 ETL （擷取、轉換和載入）。本主題提供有關資料饋送結構和儲存體的詳細資訊。

資料饋送會收集逗號分隔值 (CSV) 檔案，並將其交付至您提供的加密 Amazon S3 儲存貯體。CSV 檔案具有下列特性：
+ 它們遵循 [4180 標準](https://tools.ietf.org/html/rfc4180)。
+ 字元編碼是不含 BOM 的 UTF-8。
+ 逗號用作值之間的分隔符號。
+ 欄位會被雙引號逸出。
+ `\n` 是換行字元。
+ 日期會以 UTC 時區報告、以 ISO 8601 日期和時間格式報告，且在 1 秒內準確。
+ 所有 `*_period_start_date`和 `*_period_end_date`值都包含在內，這表示 `23:59:59`是任何一天的最後一個可能時間戳記。
+ 所有貨幣欄位前面都有貨幣欄位。
+ 貨幣欄位使用句點 (`.`) 字元做為十進位分隔符號，而不使用逗號 (，) 做為千位分隔符號。

資料饋送的產生和存放方式如下：
+ 資料饋送會在一天內產生，並包含前一天的 24 小時資料。
+ 在 Amazon S3 儲存貯體中，資料饋送是使用下列格式按月組織：

  `bucket-name/data-feed-name_version/year=YYYY/month=MM/data.csv`
+ 產生每日資料饋送時，它會附加到該月的現有 CSV 檔案。當新的月份開始時，會為每個資料饋送產生新的 CSV 檔案。
+ 資料摘要中的資訊會從 2010/01/01 回填至 2020/04/30 （包含），並可在 `year=2010/month=01`子資料夾中的 [CSV 檔案中](#data-feed-details)取得。

  您可能會注意到指定資料饋送的當月檔案僅包含資料欄標頭，且沒有資料的情況。這表示該月沒有饋送的新項目。這可能會在更新頻率較低的資料饋送中發生，例如產品饋送。在這些情況下，資料可在回填資料夾中取得。
+ 在 Amazon S3 中，您可以建立 [Amazon S3 生命週期政策](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-lifecycle.html)，以管理檔案在儲存貯體中保留多久。
+ 您可以設定 Amazon SNS 在資料交付到加密的 Amazon S3 儲存貯體時通知您。如需如何設定通知的資訊，請參閱《[Amazon Simple Notification Service 開發人員指南》中的 Amazon SNS 入門](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。 **

## 資料的歷史化
<a name="data-feed-historization"></a>

每個資料饋送都包含記錄資料歷史記錄的資料欄。除了 之外`valid_to`，這些資料欄適用於所有資料饋送。它們被納入為常見的歷史記錄結構描述，有助於查詢資料。


| 資料欄名稱  | 描述  | 
| --- | --- | 
| valid\$1from | 相對於其他欄位的值，主索引鍵值對 有效的第一個日期。 | 
| valid\$1to | 此欄僅顯示在[地址](data-feed-address.md)資料饋送上，且一律為空白。 | 
| insert\$1date | 將記錄插入資料饋送的日期。 | 
| update\$1date | 記錄上次更新的日期。 | 
| delete\$1date | 此欄一律為空白。 | 

以下顯示這些資料欄的範例。


|  valid\$1from  |  valid\$1to  |  insert\$1date  |  update\$1date  |  delete\$1date  | 
| --- | --- | --- | --- | --- | 
|  2018-12-12T02：00：00Z  |   |  2018-12-12T02：00：00Z  |  2018-12-12T02：00：00Z  |   | 
|  2019-03-29T03：00：00Z  |   |  2019-03-29T03：00：00Z  |  2019-03-29T03：00：00Z  |   | 
|  2019-03-29T03：00：00Z  |   |  2019-03-29T03：00：00Z  |  2019-04-28T03：00：00Z  |   | 

`valid_from` 和 `update_date` 欄位一起形成*雙時間資料模型*。`valid_from` 欄位命名為 時， 會告訴您項目的有效期。如果項目已編輯，它可以在摘要中具有多個記錄，每個記錄都有不同的 `update_date`，但`valid_from`日期相同。例如，若要尋找項目的目前值，您可以從具有最新`valid_from`日期的記錄`update_date`清單中找到具有最新 的記錄。

在上述範例中，記錄最初是在 2018-12-12 建立。然後，它在 2019-03-29 變更 （例如，如果記錄中的地址變更）。稍後於 2019-04-28 更正地址變更 （因此 `valid_from` 不會變更，但 `update_date`會變更）。更正地址 （罕見事件） 會追溯變更原始`valid_from`日期的記錄，因此欄位不會變更。尋找最新記錄的查詢`valid_from`會傳回兩個記錄，具有最新記錄的 `update_date`會為您提供實際的目前記錄。