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См. также
Связанные темы
© 2006–2022 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.
https://redis.io/commands/ts.get/