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

WriteRecords

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

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

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

Upserts

您可以在WriteRecords请求中使用Version参数来更新数据点。Timestream 会跟踪每条记录的版本号。 Version1当请求中没有为记录指定时，默认为。Timestream 会更新现有记录的度量值以及该记录的度量值更高的写入请求Version时该记录的度Version量值。当 Timestream 收到的度量值与现有记录的度量值相同的更新请求时，如果 Timestream 的现有值大于的Version现有值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格式返回。

错误

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

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：