Record - Amazon Timestream

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Record

Représente un point de données de série chronologique écrit dans Timestream. Chaque enregistrement contient un tableau de dimensions. Les dimensions représentent les attributs de métadonnées d'un point de données chronologique, tels que le nom de l'instance ou la zone de disponibilité d'une EC2 instance. Un enregistrement contient également le nom de la mesure, qui est le nom de la mesure collectée (par exemple, l'CPUutilisation d'une EC2 instance). En outre, un enregistrement contient la valeur de mesure et le type de valeur, qui est le type de données de la valeur de mesure. L'enregistrement contient également l'horodatage de la collecte de la mesure et l'unité d'horodatage, qui représente la granularité de l'horodatage.

Les enregistrements comportent un Version champ de 64 bits long que vous pouvez utiliser pour mettre à jour les points de données. Les écritures d'un enregistrement dupliqué avec la même dimension, le même horodatage et le même nom de mesure, mais avec une valeur de mesure différente, ne réussiront que si l'Versionattribut de l'enregistrement dans la demande d'écriture est supérieur à celui de l'enregistrement existant. La valeur par défaut de Timestream est Version de 1 pour les enregistrements sans le champ. Version

Table des matières

Dimensions

Contient la liste des dimensions des points de données de séries chronologiques.

Type : tableau d’objets Dimension

Membres du tableau : nombre maximum de 128 éléments.

Obligatoire : non

MeasureName

La mesure représente l'attribut de données de la série chronologique. Par exemple, l'CPUutilisation d'une EC2 instance ou RPM d'une éolienne sont des mesures.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

MeasureValue

Contient la valeur de mesure pour le point de données de la série chronologique.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.

Obligatoire : non

MeasureValues

Contient la liste des quatre points MeasureValue de données de séries chronologiques.

Ceci n'est autorisé que pour le typeMULTI. Pour les valeurs scalaires, utilisez directement MeasureValue l'attribut de l'enregistrement.

Type : tableau d’objets MeasureValue

Obligatoire : non

MeasureValueType

Contient le type de données de la valeur de mesure pour le point de données de la série chronologique. Le type par défaut estDOUBLE. Pour plus d'informations, consultez la section Types de données.

Type : String

Valeurs valides : DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

Obligatoire : non

Time

Contient l'heure à laquelle la valeur de mesure pour le point de données a été collectée. La valeur du temps plus l'unité indique le temps écoulé depuis l'époque. Par exemple, si la valeur temporelle est 12345 et l'unité l'estms, cela signifie que le temps s'est écoulé 12345 ms depuis l'époque.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

TimeUnit

La granularité de l'unité d'horodatage. Il indique si la valeur temporelle est en secondes, en millisecondes, en nanosecondes ou en d'autres valeurs prises en charge. La valeur par défaut est MILLISECONDS.

Type : String

Valeurs valides : MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

Obligatoire : non

Version

Attribut 64 bits utilisé pour les mises à jour des enregistrements. Rédiger des demandes pour des données dupliquées avec un numéro de version supérieur mettra à jour la valeur et la version de mesure existantes. Dans les cas où la valeur de mesure est identique, elle Version sera toujours mise à jour. La valeur par défaut est 1.

Note

Versiondoit être 1 égal ou supérieur, sinon vous recevrez un ValidationException message d'erreur.

Type : long

Obligatoire : non

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :