Record - Amazon Timestream

Para obtener capacidades similares a las de Amazon Timestream para LiveAnalytics, considere Amazon Timestream para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.

Record

Representa un punto de datos de serie temporal que se escribe en Timestream. Cada registro contiene una matriz de dimensiones. Las dimensiones representan los atributos de los metadatos de un punto de datos de serie temporal, como el nombre de la instancia o la zona de disponibilidad de una instancia de EC2. Un registro también contiene el nombre de la medida, que es el nombre de la medida que se recopila (por ejemplo, el uso de la CPU de una instancia de EC2). Además, un registro contiene el valor de medida y el tipo de valor, que es el tipo de datos del valor de medida. También el registro contiene la marca de tiempo del momento en que se recopiló la medida y la unidad de la marca de tiempo, que representa la granularidad de la marca de tiempo.

Los registros tienen un campo Version, que es de 64 bits long, que puede utilizarse para actualizar los puntos de datos. La escritura de un registro duplicado con la misma dimensión, marca de tiempo y nombre de medida, pero con un valor de medida diferente, solo se realizará de manera correcta si el atributo Version del registro de la solicitud de escritura es superior al del registro existente. Timestream establece el valor predeterminado Version a 1 para los registros sin el campo Version.

Contenido

Dimensions

Contiene la lista de dimensiones de los puntos de datos de serie temporal.

Tipo: matriz de objetos Dimension

Miembros de la matriz: número máximo de 128 elementos.

Obligatorio: no

MeasureName

La medida representa el atributo de los datos de la serie temporal. Por ejemplo, se mide el uso de la CPU de una instancia de EC2 o el RPM de una turbina eólica.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.

Obligatorio: no

MeasureValue

Contiene el valor de medida del punto de datos de serie temporal.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Obligatorio: no

MeasureValues

Contiene la lista de MeasureValue del punto de datos de serie temporal.

Esto solo está permitido para el tipo MULTI. Para valores escalares, utilice directamente el atributo MeasureValue del registro.

Tipo: matriz de objetos MeasureValue

Obligatorio: no

MeasureValueType

Contiene el tipo de datos del valor de medida del punto de datos de serie temporal. El tipo predeterminado es DOUBLE. Para obtener más información, consulte Tipos de datos.

Tipo: cadena

Valores válidos: DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

Obligatorio: no

Time

Contiene la hora en la que se recopiló el valor de medida del punto de datos. El valor de tiempo más la unidad brinda el tiempo transcurrido desde la época. Por ejemplo, si el valor del tiempo es 12345 y la unidad es ms, entonces transcurrieron 12345 ms desde la época.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.

Obligatorio: no

TimeUnit

La granularidad de la unidad de marca de tiempo. Indica si el valor de tiempo está en segundos, milisegundos, nanosegundos u otros valores admitidos. El valor predeterminado es MILLISECONDS.

Tipo: cadena

Valores válidos: MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

Obligatorio: no

Version

Atributo de 64 bits utilizado para las actualizaciones de los registros. Las solicitudes de escritura de datos duplicados con un número de versión superior actualizarán el valor de medida y la versión existentes. En los casos en que el valor de la medida sea el mismo, Version se seguirá actualizando. El valor predeterminado es 1.

nota

Version debe ser 1 o superior o recibirá un error de ValidationException.

Tipo: Long

Obligatorio: no

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: