本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 存取資料摘要
透過 AWS Marketplace，您可以使用資料饋送作為一種機制，在賣方擁有的商業智慧工具之間，從 Amazon S3 儲存貯體 ETL （擷取、轉換和載入） AWS Marketplace 的系統傳送結構化、up-to-date產品和客戶資訊。您需要將環境設定為接收加密 Amazon S3 儲存貯體的資料饋送。本主題說明如何存取和取消訂閱資料摘要。
**Topics**
+ [存取資料饋送](#data-feed-accessing-procedure)
+ [資料饋送政策](#data-feed-policies)
+ [取消訂閱資料摘要](#data-feed-unsubscribing)
## 存取資料饋送
1. 使用 SQL 和 ETL （擷取、轉換、載入） 體驗來配置商業智慧或資料工程師。此人員也需要設定 APIs的經驗。
1. 設定 Amazon Simple Storage Service 儲存貯體和資料摘要的訂閱。使用與您的 Marketplace 產品清單相關聯的 AWS 賣方帳戶 ID。若要這麼做，您可以[觀看此 YouTube 影片](https://www.youtube.com/watch?v=heCsZdOT-hw)或遵循下列步驟。
影片和步驟說明如何使用有助於簡化組態的[CloudFormation 範本](https://s3.amazonaws.com/aws-marketplace-reports-resources/DataFeedsResources.yaml)。
1. 開啟 Web 瀏覽器並登入 [AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/)，然後前往[設定客戶資料儲存](https://aws.amazon.com/marketplace/management/reports/data-feed-configuration)。
1. 選擇**使用 CloudFormation 範本建立資源**，在另一個視窗中開啟 CloudFormation 主控台中的範本。
1. 在範本中，指定下列項目，然後選擇**下一步**：
+ 堆疊名稱 – 您要建立以啟用資料饋送存取的資源集合。
+ Amazon S3 儲存貯體名稱 – 儲存資料摘要的儲存貯體。
+ （選用） Amazon SNS 主題名稱 – Amazon Simple Storage Service 儲存貯體時接收通知的主題。
1. 在**檢閱**頁面上，確認您的項目，然後選擇**建立堆疊**。這會開啟具有 CloudFormation 狀態和詳細資訊的新頁面。
1. 從**資源**索引標籤中，將下列資源的 Amazon Resource Name (ARNs) 從 CloudFormation 頁面複製到 AWS Marketplace [設定客戶資料儲存](https://aws.amazon.com/marketplace/management/reports/data-feed-configuration)頁面上的欄位：
+ 用於儲存資料饋送的 Amazon S3 儲存貯體
+ AWS KMS 用於加密 Amazon S3 儲存貯體的金鑰
+ （選用） 當 將新資料 AWS 交付至 Amazon S3 儲存貯體時，用於接收通知的 Amazon SNS 主題
1. 在**設定客戶資料儲存**頁面上，選擇**提交**。
1. （選用） 編輯 CloudFormation 範本建立的政策。如需詳細資訊，請參閱[資料饋送政策](#data-feed-policies)。
您現在已訂閱 資料摘要。下次產生資料摘要時，您可以存取資料。
1. 使用 ETL （擷取、轉換、載入） 操作將資料饋送連接到您的資料倉儲或關聯式資料庫。
**注意**
資料工具具有不同的功能。您必須讓商業智慧工程師或資料工程師參與，才能設定整合以符合工具的功能。
1. 若要執行或建立 SQL 查詢，請設定資料饋送，以在資料工具中強制執行主要和外部金鑰。每個資料饋送都代表唯一的資料表，而且您必須使用實體關係來設定資料結構描述中的所有資料饋送。如需資料表和實體關係的詳細資訊，請參閱本指南[資料饋送資料表概觀](data-feed-joining.md)中的 。
1. 設定 Amazon Simple Notification Service 以自動重新整理您的資料倉儲或關聯式資料庫。您可以設定 Amazon SNS 通知，在將來自每個唯一摘要的資料交付至 Amazon S3 儲存貯體時傳送提醒。如果賣方資料工具支援此功能，則可以利用這些通知，在透過資料饋送接收新資料時自動重新整理賣方資料倉儲。請參閱《[Amazon Simple Notification Service 開發人員指南》中的 Amazon SNS 入門](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)。 **
通知範例：
```
{
"mainExecutionId": "1bc08b11-ab4b-47e1-866a-9c8f38423a98",
"executionId": "52e862a9-42d2-41e0-8010-810af84d39b1",
"subscriptionId": "27ae3961-b13a-44bc-a1a7-365b2dc181fd",
"processedFiles": [],
"executionStatus": "SKIPPED",
"errors": [],
"feedType": "[data feed name]"
}
```
通知可以有下列`executionStatus`狀態：
+ `SKIPPED` – 賣方當天沒有新資料。
+ `COMPLETED` – 我們交付了包含新資料的摘要。
+ `FAILED` – 饋送交付發生問題。
1. 執行 SQL 查詢來驗證設定。您可以使用[本指南中的範例查詢](https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-full-examples.html)，或 GitHub 上的查詢，網址為 [ https：//https://github.com/aws-samples/aws-marketplace-api-samples/tree/main/seller-data-feeds/queries](https://github.com/aws-samples/aws-marketplace-api-samples/tree/main/seller-data-feeds/queries)。
**注意**
本指南中的範例查詢是針對 AWS Athena 撰寫的。您可能需要修改查詢，以便與工具搭配使用。
1. 決定商業使用者想要在何處使用資料。例如，您可以：
+ 從資料倉儲或 SQL 資料庫匯出 .csv 資料。
+ 將您的資料連接到視覺化工具，例如 PowerBI 或 Tableau。
+ 將資料映射到您的 CRM、ERP 或財務工具，例如 Salesforce、Infor 或 Netsuite。
如需 CloudFormation 範本的詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*》中的[使用 CloudFormation 範本](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html)。
## 資料饋送政策
當 CloudFormation 範本建立您的 Amazon S3 儲存貯體時，它會建立連接到該儲存貯體、 AWS KMS 金鑰和 Amazon SNS 主題的存取政策。這些政策允許 AWS Marketplace 報告服務使用資料饋送資訊寫入您的儲存貯體和 SNS 主題。每個政策都有如下所示的區段 （此範例來自 Amazon S3 儲存貯體）。
```
{
"Sid": "AwsMarketplaceDataFeedsAccess",
"Effect": "Allow",
"Principal": {
"Service": "reports.marketplace.amazonaws.com"
},
"Action": [
"s3:ListBucket",
"s3:GetObject",
"s3:PutObject",
"s3:GetEncryptionConfiguration",
"s3:GetBucketAcl",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
```
在此政策中， AWS Marketplace 會使用 `reports.marketplace.amazonaws.com`服務主體將資料推送至 Amazon S3 儲存貯體。您已在 CloudFormation 範本中指定 *amzn-s3-demo-bucket*。
當 AWS Marketplace 報告服務呼叫 Amazon S3 AWS KMS或 Amazon SNS 時，它會提供想要寫入儲存貯體的資料 ARN。若要確保寫入儲存貯體的唯一資料是代表您寫入的資料，您可以在 政策的條件`aws:SourceArn`中指定 。在下列範例中，您必須將 *account-id* 取代為 的 ID AWS 帳戶。
```
{
"Sid": "AwsMarketplaceDataFeedsAccess",
"Effect": "Allow",
"Principal": {
"Service": "reports.marketplace.amazonaws.com"
},
"Action": [
"s3:ListBucket",
"s3:GetObject",
"s3:PutObject",
"s3:GetEncryptionConfiguration",
"s3:GetBucketAcl",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
,
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account-id",
"aws:SourceArn": ["arn:aws:marketplace::account-id:AWSMarketplace/SellerDataSubscription/DataFeeds_V1",
"arn:aws:marketplace::account-id:AWSMarketplace/SellerDataSubscription/Example-Report"]
}
}
},
```
## 取消訂閱資料摘要
開啟 Web 瀏覽器並登入 [AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/)。然後，前往[聯絡我們頁面](https://aws.amazon.com/marketplace/management/contact-us/)，向 AWS Marketplace 賣方營運團隊提交取消訂閱請求。取消訂閱請求最多可能需要 10 個工作天才能處理。