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 atributoMeasureValuedel 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 | MULTIObligatorio: 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
12345y la unidad esms, entonces transcurrieron12345 msdesde 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 | NANOSECONDSObligatorio: 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,
Versionse seguirá actualizando. El valor predeterminado es1.nota
Versiondebe ser1o superior o recibirá un error deValidationException.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: