Spec-Zone.ru › Redis

TS.GET

TS.GET
Синтаксис
TS.GET key 
  [LATEST]
Доступно в:
Redis Stack / TimeSeries 1.0.0
Временная сложность:
O(1)

Получить образец с наибольшей меткой времени из заданного временного ряда

Примеры

Обязательные аргументы

key

это имя ключа для временного ряда.

Необязательные аргументы

LATEST (с версии RedisTimeSeries v1.8)

используется, когда временной ряд является сжатым. С LATEST, TS.GET сообщает о сжатом значении последнего, возможно частичного, бакета. Без LATEST, TS.GET не сообщает о последнем, возможно частичном, бакете. Когда временной ряд не является сжатым, LATEST игнорируется.

Данные в последнем бакете сжатого временного ряда, возможно, неполные. Бакет считается закрытым и сжатым только при появлении нового образца, который открывает новый последний бакет. Однако есть случаи, когда требуется сжатое значение последнего, возможно частичного, бакета. В таком случае используйте LATEST.

Возвращаемое значение

Один из:

  • Массивный ответ из одной пары (Целочисленный ответ, Простой строковый ответ) представляющей (метка времени, значение(double)) образца с наибольшей меткой времени
  • Пустой массивный ответ — когда временной ряд пуст
  • Ошибка (например, когда ключ не существует или количество аргументов неверно)

Примеры

Получить последнюю измеренную температуру для города

Создайте временной ряд для хранения температур, измеренных в Тель-Авиве, и добавьте четыре измерения на 01 Января 2023 года

127.0.0.1:6379> TS.CREATE temp:TLV LABELS type temp location TLV
OK
127.0.0.1:6379> TS.MADD temp:TLV 1672534800 12 temp:TLV 1672556400 16 temp:TLV 1672578000 21 temp:TLV 1672599600 14

Далее, получите последнюю измеренную температуру (температуру с наибольшей меткой времени)

127.0.0.1:6379> TS.GET temp:TLV
1) (integer) 1672599600
2) 14
Получить последнюю максимальную дневную температуру для города

Создайте временной ряд для хранения температур, измеренных в Иерусалиме

127.0.0.1:6379> TS.CREATE temp:JLM LABELS type temp location JLM
OK

Далее, создайте сжатый временной ряд с именем dailyAvgTemp:JLM, содержащий один сжатый образец в 24 часа: максимальное значение всех измерений, взятых с полуночи до следующей полуночи.

127.0.0.1:6379> TS.CREATE dailyMaxTemp:JLM LABELS type temp location JLM
OK
127.0.0.1:6379> TS.CREATERULE temp:JLM dailyMaxTemp:JLM AGGREGATION max 86400000
OK

Добавьте четыре измерения на 01 Января 2023 года и три измерения на 02 Января 2023 года

127.0.0.1:6379> TS.MADD temp:JLM 1672534800000 12 temp:JLM 1672556400000 16 temp:JLM 1672578000000 21 temp:JLM 1672599600000 14
1) (integer) 1672534800000
2) (integer) 1672556400000
3) (integer) 1672578000000
4) (integer) 1672599600000
127.0.0.1:6379> TS.MADD temp:JLM 1672621200000 11 temp:JLM 1672642800000 21 temp:JLM 1672664400000 26
1) (integer) 1672621200000
2) (integer) 1672642800000
3) (integer) 1672664400000

Далее, получите последнюю максимальную дневную температуру; не сообщать о последнем, возможно частичном, бакете

127.0.0.1:6379> TS.GET dailyMaxTemp:JLM
1) (integer) 1672531200000
2) 21

Получить последнюю максимальную дневную температуру (температуру с наибольшей меткой времени); сообщить о последнем, возможно частичном, бакете

127.0.0.1:6379> TS.GET dailyMaxTemp:JLM LATEST
1) (integer) 1672617600000
2) 26

См. также

TS.MGET

Связанные темы

RedisTimeSeries

© 2006–2022 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.
https://redis.io/commands/ts.get/

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API