Record - Amazon Timestream

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Record

Representa um ponto de dados de série temporal sendo gravado no Timestream. Cada registro contém uma matriz de dimensões. As dimensões representam os atributos de metadados de um ponto de dados de série temporal, como o nome da instância ou a zona de disponibilidade de uma EC2 instância. Um registro também contém o nome da medida, que é o nome da medida que está sendo coletada (por exemplo, a CPU utilização de uma EC2 instância). Além disso, um registro contém o valor da medida e o tipo de valor, que é o tipo de dados do valor da medida. Além disso, o registro contém o timestamp de quando a medida foi coletada e a unidade de timestamp, que representa a granularidade do timestamp.

Os registros têm um Version campo de 64 bits long que você pode usar para atualizar pontos de dados. As gravações de um registro duplicado com a mesma dimensão, data e hora e nome de medida, mas com valores de medida diferentes, só serão bem-sucedidas se o Version atributo do registro na solicitação de gravação for maior que o do registro existente. O padrão do Timestream é Version de 1 para registros sem o campo. Version

Sumário

Dimensions

Contém a lista de dimensões para pontos de dados de séries temporais.

Tipo: matriz de objetos Dimension

Membros da matriz: número máximo de 128 itens.

Obrigatório: Não

MeasureName

A medida representa o atributo de dados da série temporal. Por exemplo, a CPU utilização de uma EC2 instância ou RPM de uma turbina eólica são medidas.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Obrigatório: Não

MeasureValue

Contém o valor da medida para o ponto de dados da série temporal.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Obrigatório: Não

MeasureValues

Contém a lista de quatro pontos MeasureValue de dados de séries temporais.

Isso só é permitido para tiposMULTI. Para valores escalares, use o MeasureValue atributo do registro diretamente.

Tipo: matriz de objetos MeasureValue

Obrigatório: Não

MeasureValueType

Contém o tipo de dados do valor da medida para o ponto de dados da série temporal. O tipo padrão éDOUBLE. Para obter mais informações, consulte Tipos de dados.

Tipo: string

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

Obrigatório: Não

Time

Contém a hora em que o valor da medida para o ponto de dados foi coletado. O valor do tempo mais a unidade fornece o tempo decorrido desde a época. Por exemplo, se o valor do tempo for 12345 e a unidade forms, então já 12345 ms passaram desde a época.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Obrigatório: Não

TimeUnit

A granularidade da unidade de registro de data e hora. Ele indica se o valor do tempo está em segundos, milissegundos, nanossegundos ou outros valores compatíveis. O padrão é MILLISECONDS.

Tipo: string

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

Obrigatório: Não

Version

Atributo de 64 bits usado para atualizações de registros. As solicitações de gravação de dados duplicados com um número de versão maior atualizarão o valor e a versão existentes da medida. Nos casos em que o valor da medida for o mesmo, ainda Version será atualizado. O valor padrão é 1.

nota

Versiondeve ser 1 ou maior, ou você receberá um ValidationException erro.

Tipo: longo

Obrigatório: Não

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: