Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Penyimpanan dan struktur umpan AWS Marketplace data
<a name="data-feed-details"></a>

AWS Marketplace menyediakan umpan data sebagai mekanisme untuk mengirim informasi terstruktur, up-to-date produk, dan pelanggan dari AWS Marketplace sistem ke bucket Amazon S3 penjual untuk ETL (ekstrak, transformasi, dan muat) antara alat intelijen bisnis milik penjual. Topik ini memberikan informasi lebih lanjut tentang struktur dan penyimpanan umpan data.

Umpan data mengumpulkan dan mengirimkan file nilai dipisahkan koma (CSV) ke bucket Amazon S3 terenkripsi yang Anda berikan. File CSV memiliki karakteristik sebagai berikut:
+ Mereka mengikuti [standar 4180](https://tools.ietf.org/html/rfc4180).
+ Pengkodean karakter adalah UTF-8 tanpa BOM.
+ Koma digunakan sebagai pemisah antar nilai.
+ Bidang diloloskan oleh tanda kutip ganda. 
+ `\n`adalah karakter umpan baris.
+ Tanggal dilaporkan dalam zona waktu UTC, dalam format tanggal dan waktu ISO 8601, dan akurat dalam 1 detik.
+ Semua `*_period_start_date` dan `*_period_end_date` nilai bersifat inklusif, yang berarti itu `23:59:59` adalah stempel waktu terakhir yang mungkin untuk setiap hari. 
+ Semua bidang moneter didahului dengan bidang mata uang. 
+ Bidang moneter menggunakan karakter period (`.`) sebagai pemisah desimal, dan jangan gunakan koma (,) sebagai pemisah ribuan. 

Umpan data dihasilkan dan disimpan sebagai berikut:
+ Umpan data dihasilkan dalam sehari, dan berisi 24 jam data dari hari sebelumnya. 
+ Di bucket Amazon S3, umpan data diatur berdasarkan bulan menggunakan format berikut:

  `bucket-name/data-feed-name_version/year=YYYY/month=MM/data.csv`
+ Karena setiap umpan data harian dihasilkan, itu ditambahkan ke file CSV yang ada untuk bulan itu. Saat bulan baru dimulai, file CSV baru dibuat untuk setiap umpan data. 
+ [Informasi dalam umpan data diisi kembali dari 2010/01/01 hingga 2020/04/30 (inklusif) dan tersedia dalam file CSV di subfolder.](#data-feed-details) `year=2010/month=01`

  Anda mungkin melihat kasus di mana file bulan berjalan untuk umpan data tertentu hanya berisi header kolom, dan tidak ada data. Ini berarti bahwa tidak ada entri baru untuk bulan itu untuk umpan. Ini dapat terjadi dengan umpan data yang diperbarui lebih jarang, seperti umpan produk. Dalam kasus ini, data tersedia di folder yang diisi ulang. 
+ Di Amazon S3, Anda dapat membuat kebijakan [siklus hidup Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-lifecycle.html) untuk mengelola berapa lama menyimpan file di bucket. 
+ Anda dapat mengonfigurasi Amazon SNS untuk memberi tahu Anda saat data dikirimkan ke bucket Amazon S3 terenkripsi. Untuk informasi tentang cara mengonfigurasi notifikasi, lihat [Memulai Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di Panduan *Pengembang Layanan Pemberitahuan Sederhana Amazon*.

## Historisasi data
<a name="data-feed-historization"></a>

Setiap umpan data menyertakan kolom yang mendokumentasikan riwayat data. Kecuali untuk`valid_to`, kolom ini umum untuk semua umpan data. Mereka disertakan sebagai skema riwayat umum dan berguna dalam menanyakan data. 


| Nama kolom  | Deskripsi  | 
| --- | --- | 
| valid\$1dari | Tanggal pertama dimana nilai untuk kunci utama valid dalam kaitannya dengan nilai untuk bidang lain. | 
| valid\$1to | Kolom ini hanya ditampilkan pada umpan data [Alamat](data-feed-address.md) dan selalu kosong. | 
| insert\$1date | Tanggal catatan dimasukkan ke dalam umpan data. | 
| update\$1date | Tanggal rekor terakhir diperbarui.  | 
| delete\$1date | Kolom ini selalu kosong. | 

Berikut ini menunjukkan contoh kolom ini. 


|  valid\$1dari  |  valid\$1to  |  insert\$1date  |  update\$1date  |  delete\$1date  | 
| --- | --- | --- | --- | --- | 
|  2018-12-12T 02:00:00 Z  |   |  2018-12-12T 02:00:00 Z  |  2018-12-12T 02:00:00 Z  |   | 
|  2019-03-29T 03:00:00 Z  |   |  2019-03-29T 03:00:00 Z  |  2019-03-29T 03:00:00 Z  |   | 
|  2019-03-29T 03:00:00 Z  |   |  2019-03-29T 03:00:00 Z  |  2019-04-28T 03:00:00 Z  |   | 

`update_date`Bidang `valid_from` dan bersama-sama membentuk model *data bi-temporal*. `valid_from`Bidang, seperti namanya, memberi tahu Anda kapan item tersebut valid dari. Jika item diedit, itu dapat memiliki beberapa catatan dalam umpan, masing-masing dengan `valid_from` tanggal yang berbeda`update_date`, tetapi sama. Misalnya, untuk menemukan nilai saat ini untuk suatu item, Anda akan menemukan catatan dengan yang terbaru`update_date`, dari daftar catatan dengan `valid_from` tanggal terbaru.

Pada contoh di atas, catatan awalnya dibuat 2018-12-12. Itu kemudian diubah pada 2019-03-29 (misalnya, jika alamat dalam catatan berubah). Kemudian, pada 2019-04-28, perubahan alamat diperbaiki (jadi `valid_from` tidak berubah, tetapi berubah). `update_date` Memperbaiki alamat (peristiwa langka) secara surut mengubah catatan dari `valid_from` tanggal asli, sehingga bidang itu tidak berubah. Kueri untuk menemukan yang terbaru `valid_from` akan mengembalikan dua catatan, satu dengan yang terbaru `update_date` memberi Anda catatan saat ini yang sebenarnya.