Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

WriteRecords

Le permite escribir sus datos de series temporales en Timestream. Puede especificar un único punto de datos o un lote de puntos de datos para insertarlos en el sistema. Timestream le ofrece un esquema flexible que detecta automáticamente los nombres de las columnas y los tipos de datos de las tablas de Timestream en función de los nombres de las dimensiones y los tipos de datos de los puntos de datos que especifique al invocar las escrituras en la base de datos.

Timestream admite una semántica de lectura coherente eventual. Esto significa que cuando consultas datos inmediatamente después de escribir un lote de datos en Timestream, es posible que los resultados de la consulta no reflejen los resultados de una operación de escritura completada recientemente. Los resultados también pueden incluir algunos datos obsoletos. Si repite la solicitud de consulta después de un breve período de tiempo, los resultados deberían arrojar los datos más recientes. Se aplican cuotas de servicio.

Consulte el ejemplo de código para obtener más detalles.

¿Molestas

Puede utilizar el Version parámetro en una WriteRecords solicitud para actualizar los puntos de datos. Timestream rastrea un número de versión con cada registro. Versionel valor predeterminado es 1 cuando no está especificado para el registro en la solicitud. Timestream actualiza el valor de medición de un registro existente junto con el suyo Version cuando recibe una solicitud de escritura con un Version número superior para ese registro. Cuando recibe una solicitud de actualización en la que el valor de la medida es el mismo que el del registro existente, Timestream sigue Version actualizándose si es mayor que el valor existente de. Version Puede actualizar un punto de datos tantas veces como desee, siempre que el valor de aumente de Version forma continua.

Por ejemplo, supongamos que escribe un registro nuevo sin indicarlo Version en la solicitud. Timestream almacena este registro y lo establece Version en. 1 Ahora, supongamos que intenta actualizar este registro con una WriteRecords solicitud del mismo registro con un valor de medida diferente, pero, como antes, no lo proporciona. Version En este caso, Timestream rechazará esta actualización con una, RejectedRecordsException ya que la versión del registro actualizado no es superior al valor actual de la versión.

Sin embargo, si volvieras a enviar la solicitud de actualización con el valor Version establecido en2, Timestream lograría actualizar el valor del registro y se establecería en. Version 2 A continuación, supongamos que ha enviado una WriteRecords solicitud con el mismo registro y un valor de medida idéntico, pero con Version el valor establecido en. 3 En este caso, Timestream solo se Version actualizaría a. 3 Cualquier actualización adicional tendría que enviar un número de versión superior a3, o las solicitudes de actualización recibirían un. RejectedRecordsException

Sintaxis de la solicitud

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

Parámetros de la solicitud

Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.

La solicitud acepta los siguientes datos en JSON formato.

Sintaxis de la respuesta

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

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: