使用 AWS Marketplace Commerce Analytics Service 產生資料集 - AWS Marketplace
GenerateDataSet 參數回應輸出

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

使用 AWS Marketplace Commerce Analytics Service 產生資料集

註冊 AWS Marketplace Commerce Analytics Service 後，您可以透過 和 存取您的用量、訂閱 AWS CLI 和帳單報告 AWS SDK for Java。您使用SDK工具請求的資料會以資料集 AWS 帳戶 的形式交付至您的 。大多數資料集對應於與 上可用的文字型報告相同的資料AWS Marketplace 管理入口網站。如需詳細資訊，請參閱使用 AWS Marketplace Commerce Analytics Service 存取產品和客戶資料。這些區段提供有關 Commerce Analytics Service 產生之資料集的相關參數、回應和輸出的資訊。

GenerateDataSet 參數

AWS Marketplace Commerce Analytics Service 公開了一種方法 GenerateDataSet，您可以使用它來請求將資料集發佈至 Amazon S3 儲存貯體。下表列出 的參數GenerateDataSet。

資料集參數
欄位 Description
資料集類型 此資料集將作為請求的結果傳回。
資料集發佈日期

資料集發佈的日期。

對於每日資料集，請提供所需日期的日層級精細度。

對於每月資料集，請提供所需月份的月份層級精細度日期。系統會忽略日值。
角色名稱 ARN 具有已連接許可政策的角色ARN的 ，該政策提供 服務存取您的 資源。
目的地 Amazon S3 儲存貯體名稱 目的地 Amazon S3 儲存貯體的名稱 （易記的名稱，而非 ARN）。您的資料集會發佈到此位置。
目的地 Amazon S3 字首

（選用） 已發佈資料集的 Amazon S3 字首，類似於標準檔案系統中的目錄路徑。

例如，如果指定儲存貯體名稱mybucket和字首 myprefix/mydatasets，輸出檔案會發佈至 s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile。

如果字首目錄結構不存在，則會建立。

如果未提供字首，資料集會發佈至 Amazon S3 儲存貯體根。
SNS 主題 ARN

在資料集發佈或發生錯誤時通知的 Amazon SNS主題ARN的 。

回應

AWS Marketplace Commerce Analytics Service 會傳回兩個回應。第一個是同步的，它會立即傳回，第二個是非同步的，它會使用 Amazon 傳回SNS。同步回應與此範例類似。

資料集參數
欄位 Description
資料集請求 ID 代表服務特定請求的唯一識別碼。此識別符可用於將請求與 Amazon SNS主題的通知建立關聯。

非同步回應會以 JSON格式化文件形式發佈至您的 Amazon SNS主題，與此範例類似。

資料集參數
欄位 Description
資料集 S3 位置 交付資料集的儲存貯體名稱和金鑰。
資料集中繼資料 S3 位置 已交付資料集中繼資料檔案的儲存貯體名稱和金鑰。
資料集請求 ID 代表服務特定請求的唯一識別碼。此識別符可用於將請求與 Amazon SNS主題的通知建立關聯。
Success (成功) 如果操作成功，則為「True」；如果失敗，則為「false」。
訊息 （選用） 如果發生錯誤 （例如，「成功」是「錯誤」），此訊息會包含失敗的相關資訊。

範例 JSON- 格式非同步回應 


 {    
   "dataSetS3Location":{
      "bucketName":"demo-bucket",
      "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
   },
   "dataSetMetaDataS3Location":{
      "bucketName":"demo-bucket",
      "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
   },
   "dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023",
   "success":true
 }

輸出

成功請求後，請求的資料集會以 .csv 檔案的形式交付至您的 Amazon S3 儲存貯體。JSON格式化的中繼資料檔案會發佈到與資料集檔案相同的位置。中繼資料檔案提供有關資料集和原始請求參數的有用資訊。中繼資料檔案與資料集檔案的名稱相同，但結尾為副檔名 .meta.json。下表列出 .csv 檔案中的中繼資料欄位。

中繼資料欄位
欄位 Description
資料集請求 ID 代表服務特定請求的唯一識別碼。此識別符可用於將請求與 Amazon SNS主題的通知建立關聯。
資料集涵蓋範圍 定義資料涵蓋範圍date/time and end date/time的開始。這些日期採用 ISO 8601 格式。
資料集請求參數 GenerateDataSet 方法的原始請求參數。
資料集 S3 位置 交付資料集的儲存貯體名稱和金鑰。
資料集中繼資料 S3 位置 已交付資料集中繼資料檔案的儲存貯體名稱和金鑰。

以下是 JSON格式化中繼資料內容的範例。


{
"dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1",
"dataSetCoverageRange": {
"startDateTime": "2014-06-08T00:00:00.000Z",
"endDateTime": "2014-06-08T23:59:59.000Z"
},
"dataSetRequestParameters": {
"sellerAccountId": "123412341234",
"dataSetType": "customer_subscriber_hourly_monthly_subscriptions",
"dataSetPublicationDate": "2014-06-09T00:00:00.000Z",
"roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole",
"destinationS3BucketName": "demo-bucket",
"destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions",
"snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic"
},
"dataSetS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
},
"dataSetMetaDataS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
}
}

如需可用資料集的完整清單，包括可用日期，請參閱 AWS SDK 文件 。