Record - Amazon Timestream

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'Versionattributo 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 tipoMULTI. Per i valori scalari, usa direttamente l'MeasureValueattributo 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, allora 12345 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

Versiondeve essere uguale 1 o superiore, altrimenti riceverai un ValidationException 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: