Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击此处了解更多信息。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

WriteRecords

让您能够将时间序列数据写入 Timestream。您可以指定要插入系统的单个数据点或批量数据点。Timestream 提供灵活的架构，能够根据您在调用数据库写入操作时指定的数据点维度名称和数据类型，自动检测 Timestream 表的列名和数据类型。

Timestream 支持最终一致性读取语义。这意味着，如果您将批量数据写入 Timestream 后立即查询数据，查询结果可能不会反映最近完成的写入操作结果。结果可能还包含某些陈旧数据。如果您在短时间后重复查询请求，结果将返回最新的数据。适用服务配额。

请参阅代码示例，了解详细信息。

更新插入

您可以在 WriteRecords 请求中使用 Version 参数，以更新数据点。Timestream 会跟踪每条记录的版本号。当请求中没有为记录指定版本号时，Version 默认为 1。当 Timestream 接收到针对某条记录具有更高 Version 号的写入请求时，会更新该记录的度量值及其 Version。当 Timestream 收到更新请求时，如果该请求的度量值与现有记录相同，只要该值大于 Version 的现有值，Timestream 仍会更新 Version。只要 Version 的值不断增加，即可根据需要多次更新数据点。

例如，假设您写入新记录，但没有在请求中注明 Version。Timestream 会存储此记录，并将 Version 设置为 1。现在，假设您尝试使用具有不同度量值的相同记录的 WriteRecords 请求更新此记录，但与之前一样，没有提供 Version。在此情况下，Timestream 将拒绝此更新，并显示 RejectedRecordsException，因为已更新记录的版本不大于“版本”的现有值。

然而，如果您重新发送更新请求时将 Version 设置为 2，Timestream 将成功更新该记录的值，并将 Version 设置为 2。接下来，假设您发送的 WriteRecords 请求具有相同的记录和相同的度量值，但将 Version 设置为 3。在此情况下，Timestream 仅会将 Version 更新为 3。任何进一步的更新都需要发送大于 3 的版本号，否则更新请求将收到 RejectedRecordsException。

请求语法

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

请求参数

有关所有操作的通用参数的信息，请参阅常用参数。

请求接受采用 JSON 格式的以下数据。

响应语法

{
   "RecordsIngested": { 
      "MagneticStore": number,
      "MemoryStore": number,
      "Total": number
   }
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

错误

有关所有操作的常见错误的信息，请参阅常见错误。

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：