Menghasilkan kumpulan data dengan menggunakan Layanan Analisis AWS Marketplace Perdagangan

Setelah mendaftar di Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses laporan penggunaan, langganan, dan penagihan Anda melalui dan. AWS CLI AWS SDK for Java Data yang Anda minta menggunakan SDK alat dikirimkan ke kumpulan data Anda Akun AWS sebagai. Sebagian besar kumpulan data sesuai dengan data yang sama dengan laporan berbasis teks yang tersedia di file. Portal Manajemen AWS Marketplace Untuk informasi selengkapnya, lihat Mengakses data produk dan pelanggan dengan Layanan Analisis AWS Marketplace Perdagangan. Bagian ini memberikan informasi tentang parameter, respons, dan output yang terkait dengan kumpulan data yang dihasilkan oleh Layanan Analisis Perdagangan.

Parameter GenerateDataSet

Layanan Analisis AWS Marketplace Perdagangan memperlihatkan satu metodeGenerateDataSet, yang dapat Anda gunakan untuk meminta kumpulan data yang akan dipublikasikan ke bucket Amazon S3 Anda. Tabel berikut mencantumkan parameter untukGenerateDataSet.

Parameter basis data

Bidang	Deskripsi
Tipe Set Data	Dataset ini akan dikembalikan sebagai hasil dari permintaan.
Tanggal Publikasi Data Set	Tanggal set data diterbitkan. Untuk set data harian, berikan tanggal dengan granularitas tingkat hari untuk hari yang diinginkan. Untuk set data bulanan, berikan tanggal dengan granularitas tingkat bulan untuk bulan yang diinginkan. Nilai hari diabaikan.
Nama Peran ARN	ARNPeran dengan kebijakan izin terlampir yang menyediakan layanan akses ke sumber daya Anda.
Nama Bucket Amazon S3 Bucket	Nama (nama ramah, bukanARN) dari ember Amazon S3 tujuan. Dataset Anda dipublikasikan ke lokasi ini.
Prefiks Amazon S3 Tujuan	(Opsional) prefiks Amazon S3 untuk set data diterbitkan, mirip dengan path direktori dalam sistem file standar. Sebagai contoh, jika diberikan nama bucketmybucketdan prefiksmyprefix/mydatasets, file output diterbitkan untuks3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile. Jika struktur direktori prefiks tidak ada, ini dibuat. Jika tidak ada prefiks yang disediakan, set data diterbitkan ke Amazon S3 bucket root.
SNSTopik ARN	SNSTopik ARN untuk Amazon yang diberitahukan saat dataset telah diterbitkan atau jika terjadi kesalahan.

Respons

Layanan Analisis AWS Marketplace Perdagangan mengembalikan dua tanggapan. Yang pertama sinkron, yang segera dikembalikan, dan yang kedua asinkron, yang dikembalikan menggunakan Amazon. SNS Responnya sinkron serupa dengan contoh ini.

Adalah parameter ditetapkan?

Bidang	Deskripsi
ID Permintaan Set Data	Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk menghubungkan permintaan dengan pemberitahuan tentang topik AmazonSNS.

Respons asinkron diposting sebagai JSON dokumen berformat -ke SNS topik Amazon Anda dan mirip dengan contoh ini.

Parameter basis data

Bidang	Deskripsi
Lokasi Set Data S3	Nama bucket dan kunci untuk set data disampaikan.
Lokasi Data Set Meta Data S3	Nama bucket dan kunci untuk file metadata set data terkirim.
ID Permintaan Set Data	Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk menghubungkan permintaan dengan pemberitahuan tentang topik AmazonSNS.
Sukses	“Benar” jika operasi berhasil; “palsu” jika tidak.
Pesan	(Opsional) Jika terjadi kesalahan (misalnya, “Sukses” adalah “palsu”), pesan ini berisi informasi tentang kegagalan.

Contoh respon JSON asinkron yang diformat

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

Output

Setelah permintaan berhasil, set data yang diminta dikirim ke bucket Amazon S3 Anda sebagai file.csv. File metadata JSON yang diformat dipublikasikan ke lokasi yang sama dengan file dataset. File metadata menyediakan informasi yang berguna tentang set data dan parameter permintaan asli. File metadata memiliki nama yang sama dengan file set data, tetapi diakhiri dengan ekstensi .meta.json. Tabel berikut mencantumkan kolom metadata dalam file.csv.

Kolom metadata

Bidang	Deskripsi
ID Permintaan Set Data	Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk menghubungkan permintaan dengan pemberitahuan tentang topik AmazonSNS.
Rentang Liputan Set Data	Mendefinisikan awal date/time and end date/time untuk rentang cakupan data. Tanggal-tanggal ini dalam format ISO 8601.
Parameter Permintaan Set Data	Asli permintaan parameter untukGenerateDataSetmetode.
Lokasi Set Data S3	Nama bucket dan kunci untuk set data disampaikan.
Lokasi Data Set Meta Data S3	Nama bucket dan kunci untuk file metadata set data terkirim.

Berikut ini adalah contoh isi JSON metadata -format.

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

Untuk daftar lengkap kumpulan data yang tersedia, termasuk tanggal ketersediaan, lihat dokumentasi. AWS SDK