Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Record
Rappresenta un punto dati di serie temporali che viene scritto in Timestream. Ogni record contiene una serie di dimensioni. Le dimensioni rappresentano gli attributi dei metadati di un punto dati di una serie temporale, ad esempio il nome dell'istanza o la zona di disponibilità di un'EC2istanza. Un record contiene anche il nome della misura, che è il nome della misura raccolta (ad esempio, l'CPUutilizzo di un'EC2istanza). Inoltre, un record contiene il valore della misura e il tipo di valore, che è il tipo di dati del valore della misura. Inoltre, il record contiene il timestamp di quando la misura è stata raccolta e l'unità di timestamp, che rappresenta la granularità del timestamp.
I record hanno un Version
campo, a 64 bitlong
, che è possibile utilizzare per aggiornare i punti dati. La scrittura di un record duplicato con la stessa dimensione, timestamp e nome di misura ma un valore di misura diverso avrà esito positivo solo se l'Version
attributo del record nella richiesta di scrittura è superiore a quello del record esistente. Il valore predefinito di Timestream è quello dei record senza il campo. Version
1
Version
Indice
- Dimensions
-
Contiene l'elenco delle dimensioni per i punti dati delle serie temporali.
Tipo: matrice di oggetti Dimension
Membri dell'array: numero massimo di 128 elementi.
Campo obbligatorio: no
- MeasureName
-
La misura rappresenta l'attributo di dati della serie temporale. Ad esempio, l'CPUutilizzo di un'EC2istanza o RPM di una turbina eolica sono misure.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
- MeasureValue
-
Contiene il valore di misura per il punto dati della serie temporale.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Campo obbligatorio: no
- MeasureValues
-
Contiene l'elenco di quattro punti dati MeasureValue delle serie temporali.
È consentito solo per il tipo
MULTI
. Per i valori scalari, usa direttamente l'MeasureValue
attributo del record.Tipo: matrice di oggetti MeasureValue
Campo obbligatorio: no
- MeasureValueType
-
Contiene il tipo di dati del valore di misura per il punto dati della serie temporale. Il tipo predefinito è
DOUBLE
. Per ulteriori informazioni, consulta Tipi di dati.Tipo: stringa
Valori validi:
DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI
Campo obbligatorio: no
- Time
-
Contiene l'ora in cui è stato raccolto il valore di misura per il punto dati. Il valore temporale più l'unità fornisce il tempo trascorso dall'epoca. Ad esempio, se il valore temporale è
12345
e l'unità èms
, allora12345 ms
sono trascorsi dall'epoca.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
- TimeUnit
-
La granularità dell'unità timestamp. Indica se il valore temporale è in secondi, millisecondi, nanosecondi o altri valori supportati. Il valore predefinito è
MILLISECONDS
.Tipo: stringa
Valori validi:
MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS
Campo obbligatorio: no
- Version
-
Attributo a 64 bit utilizzato per gli aggiornamenti dei record. Le richieste di scrittura per dati duplicati con un numero di versione superiore aggiorneranno il valore e la versione della misura esistenti. Nei casi in cui il valore di misura è lo stesso,
Version
verrà comunque aggiornato. Il valore predefinito è1
.Nota
Version
deve essere uguale1
o superiore, altrimenti riceverai unValidationException
errore.Tipo: long
Campo obbligatorio: no
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API opzione in una delle lingue specifiche AWS SDKs, consulta quanto segue: