Untuk kemampuan serupa dengan Amazon Timestream LiveAnalytics, pertimbangkan Amazon Timestream untuk InfluxDB. Ini menawarkan konsumsi data yang disederhanakan dan waktu respons kueri milidetik satu digit untuk analitik waktu nyata. Pelajari lebih lanjut [di sini](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# WriteRecords
Memungkinkan Anda untuk menulis data deret waktu Anda ke Timestream. Anda dapat menentukan satu titik data atau sekumpulan titik data yang akan dimasukkan ke dalam sistem. Timestream menawarkan skema fleksibel yang secara otomatis mendeteksi nama kolom dan tipe data untuk tabel Timestream Anda berdasarkan nama dimensi dan tipe data dari titik data yang Anda tentukan saat menjalankan penulisan ke dalam database.
Timestream mendukung semantik baca konsistensi akhirnya. Ini berarti bahwa ketika Anda melakukan kueri data segera setelah menulis kumpulan data ke Timestream, hasil kueri mungkin tidak mencerminkan hasil operasi penulisan yang baru saja selesai. Hasilnya mungkin juga mencakup beberapa data basi. Jika Anda mengulangi permintaan kueri setelah waktu yang singkat, hasilnya akan mengembalikan data terbaru. [Service quotas berlaku](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html).
Lihat [sampel kode](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html) untuk detail.
**Upserts**
Anda dapat menggunakan `Version` parameter dalam `WriteRecords` permintaan untuk memperbarui titik data. Timestream melacak nomor versi dengan setiap catatan. `Version`default `1` ketika itu tidak ditentukan untuk catatan dalam permintaan. Timestream memperbarui nilai ukuran rekaman yang ada bersama dengan `Version` saat menerima permintaan tulis dengan `Version` angka yang lebih tinggi untuk catatan itu. Ketika menerima permintaan pembaruan di mana nilai ukurannya sama dengan catatan yang ada, Timestream masih memperbarui`Version`, jika lebih besar dari `Version` nilai yang ada. Anda dapat memperbarui titik data sebanyak yang diinginkan, selama nilai `Version` terus meningkat.
Misalnya, misalkan Anda menulis catatan baru tanpa menunjukkan `Version` dalam permintaan. Timestream menyimpan catatan ini, dan diatur `Version` ke`1`. Sekarang, misalkan Anda mencoba memperbarui catatan ini dengan `WriteRecords` permintaan catatan yang sama dengan nilai ukuran yang berbeda tetapi, seperti sebelumnya, jangan berikan`Version`. Dalam hal ini, Timestream akan menolak pembaruan ini dengan `RejectedRecordsException` karena versi rekaman yang diperbarui tidak lebih besar dari nilai Versi yang ada.
Namun, jika Anda mengirim ulang permintaan pembaruan dengan `Version` set ke`2`, Timestream kemudian akan berhasil memperbarui nilai catatan, dan `Version` akan disetel ke. `2` Selanjutnya, misalkan Anda mengirim `WriteRecords` permintaan dengan catatan yang sama dan nilai ukuran yang identik, tetapi dengan `Version` set ke`3`. Dalam hal ini, Timestream hanya akan memperbarui `Version` ke`3`. Setiap pembaruan lebih lanjut perlu mengirim nomor versi yang lebih besar dari`3`, atau permintaan pembaruan akan menerima file`RejectedRecordsException`.
## Sintaksis Permintaan
```
{
"CommonAttributes": {
"Dimensions": [
{
"DimensionValueType": "string",
"Name": "string",
"Value": "string"
}
],
"MeasureName": "string",
"MeasureValue": "string",
"MeasureValues": [
{
"Name": "string",
"Type": "string",
"Value": "string"
}
],
"MeasureValueType": "string",
"Time": "string",
"TimeUnit": "string",
"Version": number
},
"DatabaseName": "string",
"Records": [
{
"Dimensions": [
{
"DimensionValueType": "string",
"Name": "string",
"Value": "string"
}
],
"MeasureName": "string",
"MeasureValue": "string",
"MeasureValues": [
{
"Name": "string",
"Type": "string",
"Value": "string"
}
],
"MeasureValueType": "string",
"Time": "string",
"TimeUnit": "string",
"Version": number
}
],
"TableName": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [CommonAttributes](#API_WriteRecords_RequestSyntax) **
Catatan yang berisi atribut ukuran, dimensi, waktu, dan versi umum yang dibagikan di semua catatan dalam permintaan. Atribut ukuran dan dimensi yang ditentukan akan digabungkan dengan atribut ukuran dan dimensi dalam objek rekaman saat data ditulis ke Timestream. Dimensi mungkin tidak tumpang tindih, atau `ValidationException` akan dilemparkan. Dengan kata lain, catatan harus berisi dimensi dengan nama unik.
Tipe: Objek [Record](API_Record.md)
Wajib: Tidak
** [DatabaseName](#API_WriteRecords_RequestSyntax) **
Nama basis data Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
** [Records](#API_WriteRecords_RequestSyntax) **
Larik catatan yang berisi atribut ukuran, dimensi, waktu, dan versi unik untuk setiap titik data deret waktu.
Tipe: Array objek [Record](API_Record.md)
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 100 item.
Wajib: Ya
** [TableName](#API_WriteRecords_RequestSyntax) **
Nama tabel Timestream.
Tipe: String
Batasan Panjang: Panjang minimum 3. Panjang maksimum 256.
Wajib: Ya
## Sintaksis Respons
```
{
"RecordsIngested": {
"MagneticStore": number,
"MemoryStore": number,
"Total": number
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [RecordsIngested](#API_WriteRecords_ResponseSyntax) **
Informasi tentang catatan yang dicerna oleh permintaan ini.
Tipe: Objek [RecordsIngested](API_RecordsIngested.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan ini.
Kode Status HTTP: 400
** InternalServerException **
Timestream tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.
Kode Status HTTP: 500
** InvalidEndpointException **
Endpoint yang diminta tidak valid.
Kode Status HTTP: 400
** RejectedRecordsException **
WriteRecords akan membuang pengecualian ini dalam kasus berikut:
+ Rekaman dengan data duplikat di mana ada beberapa catatan dengan dimensi, stempel waktu, dan nama ukuran yang sama tetapi:
+ Nilai ukur berbeda
+ Versi tidak hadir dalam permintaan *atau* nilai versi dalam catatan baru sama dengan atau lebih rendah dari nilai yang ada
Dalam hal ini, jika Timestream menolak data, `ExistingVersion` bidang dalam `RejectedRecords` respons akan menunjukkan versi rekaman saat ini. Untuk memaksa pembaruan, Anda dapat mengirim ulang permintaan dengan versi untuk catatan yang ditetapkan ke nilai yang lebih besar dari`ExistingVersion`.
+ Catatan dengan stempel waktu yang berada di luar durasi retensi penyimpanan memori.
+ Rekaman dengan dimensi atau ukuran yang melebihi batas yang ditentukan Timestream.
Untuk informasi selengkapnya, lihat [Kuota](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) di Panduan Pengembang Amazon Timestream.
** RejectedRecords **
Kode Status HTTP: 400
** ResourceNotFoundException **
Operasi mencoba mengakses sumber daya yang tidak ada. Sumber daya mungkin tidak ditentukan dengan benar, atau statusnya mungkin tidak AKTIF.
Kode Status HTTP: 400
** ThrottlingException **
Terlalu banyak permintaan yang dibuat oleh pengguna dan mereka melebihi kuota layanan. Permintaan itu dibatasi.
Kode Status HTTP: 400
** ValidationException **
Permintaan yang tidak valid atau cacat.
Kode Status HTTP: 400
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords)