Record - Amazon Timestream

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Record

Stellt einen Zeitreihen-Datenpunkt dar, der in Timestream geschrieben wird. Jeder Datensatz enthält eine Reihe von Dimensionen. Dimensionen stellen die Metadatenattribute eines Zeitreihen-Datenpunkts dar, z. B. den Instanznamen oder die Availability Zone einer EC2 Instanz. Ein Datensatz enthält auch den Kennzahlnamen, d. h. den Namen der Messgröße, die erfasst wird (z. B. die CPU Auslastung einer EC2 Instanz). Darüber hinaus enthält ein Datensatz den Messwert und den Werttyp, der den Datentyp des Messwerts darstellt. Außerdem enthält der Datensatz den Zeitstempel, zu dem die Kennzahl erfasst wurde, und die Zeitstempeleinheit, die die Granularität des Zeitstempels darstellt.

Datensätze haben ein Version Feld, bei dem es sich um ein 64-Bit-Feld handeltlong, das Sie zum Aktualisieren von Datenpunkten verwenden können. Schreibvorgänge an einem doppelten Datensatz mit derselben Dimension, demselben Zeitstempel und demselben Kennzahlnamen, aber unterschiedlichem Kennzahlwert sind nur erfolgreich, wenn das Version Attribut des Datensatzes in der Schreibanforderung höher ist als das des vorhandenen Datensatzes. Timestream ist bei Datensätzen ohne das Feld standardmäßig auf „Versionof1“ eingestellt. Version

Inhalt

Dimensions

Enthält die Liste der Dimensionen für Zeitreihen-Datenpunkte.

Typ: Array von Dimension-Objekten

Array-Mitglieder: Maximale Anzahl von 128 Elementen.

Erforderlich: Nein

MeasureName

Measure stellt das Datenattribut der Zeitreihe dar. Beispielsweise handelt es sich bei der CPU Auslastung einer EC2 Instanz oder RPM der einer Windenergieanlage um Messwerte.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

MeasureValue

Enthält den Messwert für den Zeitreihen-Datenpunkt.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Nein

MeasureValues

Enthält die Liste der vier MeasureValue Zeitreihen-Datenpunkte.

Dies ist nur für den Typ MULTI zulässig. Verwenden Sie für Skalarwerte direkt MeasureValue das Attribut des Datensatzes.

Typ: Array von MeasureValue-Objekten

Erforderlich: Nein

MeasureValueType

Enthält den Datentyp des Messwerts für den Zeitreihendatenpunkt. Der Standardtyp istDOUBLE. Weitere Informationen finden Sie unter Datentypen.

Typ: Zeichenfolge

Zulässige Werte: DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

Erforderlich: Nein

Time

Enthält den Zeitpunkt, zu dem der Messwert für den Datenpunkt erfasst wurde. Der Zeitwert plus die Einheit gibt die Zeit an, die seit der Epoche vergangen ist. Wenn der Zeitwert beispielsweise ist 12345 und die Einheit istms, dann ist seit der 12345 ms Epoche vergangen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

TimeUnit

Die Granularität der Zeitstempeleinheit. Sie gibt an, ob der Zeitwert in Sekunden, Millisekunden, Nanosekunden oder anderen unterstützten Werten angegeben ist. Der Standardwert ist MILLISECONDS.

Typ: Zeichenfolge

Zulässige Werte: MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

Erforderlich: Nein

Version

64-Bit-Attribut, das für Datensatzaktualisierungen verwendet wird. Schreibanforderungen für doppelte Daten mit einer höheren Versionsnummer aktualisieren den vorhandenen Messwert und die Version. In Fällen, in denen der Messwert derselbe ist, Version wird er trotzdem aktualisiert. Der Standardwert ist 1.

Anmerkung

Versionmuss 1 oder höher sein, sonst erhalten Sie eine ValidationException Fehlermeldung.

Type: Long

Erforderlich: Nein

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: