기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Marketplace Commerce Analytics Service를 사용하여 데이터세트 생성
AWS Marketplace Commerce Analytics Service에 등록한 후에는 AWS CLI와 AWS SDK for Java를 통해 사용, 구독, 청구 보고서에 액세스할 수 있습니다. SDK 도구를 사용하여 요청한 데이터는 AWS 계정에 데이터 세트로 제공됩니다. 대부분의 데이터 세트는 [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour)에서 사용할 수 있는 텍스트 기반 보고서와 동일한 형태의 데이터에 해당합니다. 자세한 내용은 [AWS Marketplace 상거래 분석 서비스를 사용하여 제품 및 고객 데이터 액세스](commerce-analytics-service.md) 단원을 참조하세요. 이 섹션에서는 Commerce Analytics Service에서 생성한 데이터세트와 관련된 파라미터, 응답 및 출력에 대한 정보를 제공합니다.
**Topics**
+ [`GenerateDataSet` 파라미터](#generate-data-set-parameters)
+ [응답](#responses)
+ [결과](#outputs)
## `GenerateDataSet` 파라미터
AWS Marketplace Commerce Analytics Service는 하나의 `GenerateDataSet` 메서드를 표시하며, 이 메서드를 사용해 Amazon S3 버킷에 데이터세트를 게시하도록 요청할 수 있습니다. 다음 표는 `GenerateDataSet`에 대한 파라미터를 나열합니다.
**데이터 세트 파라미터**
| **필드** | **설명** |
| --- | --- |
| Data Set Type | 이 데이터 세트는 요청의 결과로 반환됩니다. |
| Data Set Publication Date | 데이터 세트가 게시된 날짜입니다.
일별 데이터 세트의 경우 원하는 날의 일 수준으로 세분화된 날짜를 입력합니다.
월별 데이터 세트의 경우 원하는 달의 월 수준으로 세분화된 날짜를 입력합니다. 일 값은 무시됩니다. |
| Role Name ARN | 연결된 권한 정책이 포함된 역할의 ARN은 리소스에 대한 액세스를 포함한 서비스를 제공합니다. |
| Destination Amazon S3 Bucket Name | 대상 Amazon S3 버킷의 이름(ARN이 아닌 익숙한 이름)입니다. 데이터 세트가 이 위치에 게시됩니다. |
| Destination Amazon S3 Prefix | (선택 사항) 게시된 데이터 세트의 Amazon S3 접두사이며 표준 파일 시스템의 디렉터리 경로와 유사합니다.
예를 들어 해당 버킷 이름이 `mybucket`이고 접두사가 `myprefix/mydatasets`인 경우 출력 파일은 `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`에 게시됩니다.
접두사 구조 디렉터리가 존재하지 않으면 새로 생성됩니다.
접두사가 제공되지 않으면 데이터 세트가 Amazon S3 버킷 루트에 게시됩니다. |
| SNS 주제 ARN | 데이터 세트가 게시되거나 오류가 발생할 때 알림을 받는 Amazon SNS 주제의 ARN입니다. |
## 응답
AWS Marketplace 상거래 분석 서비스는 두 가지 응답을 반환합니다. 첫 번째는 즉시 반환되는 동기식이고, 두 번째는 Amazon SNS를 사용하여 반환되는 비동기식입니다. 동기식 응답은 다음 예제와 유사합니다.
**데이터 세트 파라미터**
| **필드** | **설명** |
| --- | --- |
| Data Set Request ID | 서비스에 대한 특정 요청을 나타내는 고유 식별자입니다. 이 식별자를 사용하여 요청에 Amazon SNS 주제에 대한 알림을 연결할 수 있습니다. |
비동기식 응답은 Amazon SNS 주제에 JSON 형식의 문서로 게시되며 다음 예제와 유사합니다.
**데이터 세트 파라미터**
| **필드** | **설명** |
| --- | --- |
| Data Set S3 Location | 전달된 데이터 세트의 버킷 이름 및 키입니다. |
| Data Set Meta Data S3 Location | 전달된 데이터 세트 메타데이터 파일의 버킷 이름 및 키입니다. |
| Data Set Request ID | 서비스에 대한 특정 요청을 나타내는 고유 식별자입니다. 이 식별자를 사용하여 요청에 Amazon SNS 주제에 대한 알림을 연결할 수 있습니다. |
| Success | 작업이 성공하면 "true"이고, 성공하지 않으면 "false”입니다. |
| 메시지 | (선택 사항) 오류가 발생한 경우(예: “Success”가 “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 파일의 메타데이터 필드가 나열되어 있습니다.
**메타데이터 필드**
| **필드** | **설명** |
| --- | --- |
| Data Set Request ID | 서비스에 대한 특정 요청을 나타내는 고유 식별자입니다. 이 식별자를 사용하여 요청에 Amazon SNS 주제에 대한 알림을 연결할 수 있습니다. |
| Data Set Coverage Range | 데이터 범위에 대한 시작 날짜/시간 및 종료 날짜/시간을 정의합니다. 이 날짜는 ISO 8601 형식입니다. |
| Data Set Request Parameters | GenerateDataSet 메서드에 대한 원래 요청 파라미터입니다. |
| Data Set S3 Location | 전달된 데이터 세트의 버킷 이름 및 키입니다. |
| Data Set Meta Data S3 Location | 전달된 데이터 세트 메타데이터 파일의 버킷 이름 및 키입니다. |
다음은 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 설명서](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options)를 참조하세요.