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 „Version
of1
“ 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 direktMeasureValue
das Attribut des Datensatzes.Typ: Array von MeasureValue-Objekten
Erforderlich: Nein
- MeasureValueType
-
Enthält den Datentyp des Messwerts für den Zeitreihendatenpunkt. Der Standardtyp ist
DOUBLE
. 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 der12345 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 ist1
.Anmerkung
Version
muss1
oder höher sein, sonst erhalten Sie eineValidationException
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: