TS.DECRBY
TS.DECRBY
TS.DECRBY key value
[TIMESTAMP timestamp]
[RETENTION retentionPeriod]
[UNCOMPRESSED]
[CHUNK_SIZE size]
[LABELS {label value}...]
- Доступно в:
- Redis Stack / TimeSeries 1.0.0
- Временная сложность:
- O(M), где M — количество правил компактирования, или O(1) без компактирования
Уменьшает значение выборки с максимальным существующим временным отметкой или создает новую выборку со значением, равным значению выборки с максимальной существующей временной отметкой, с заданным уменьшением.
Обязательные аргументы
key
имя ключа для временного ряда.
value
числовое значение данных выборки (double)
- Если указанный ключ не существует, создается новый временной ряд.
- Вы можете использовать эту команду как счётчик или измеритель, который автоматически получает историю как временной ряд.
- Явное добавление выборок в сжатый временной ряд (используя
TS.ADD,TS.MADD,TS.INCRBYилиTS.DECRBY) может привести к несоответствиям между необработанными и сжатыми данными. Процесс компактирования может переопределить такие выборки.
Необязательные аргументы
TIMESTAMP timestamp
— (целое число) временная отметка выборки Unix в миллисекундах или * для установки временной отметки по часам сервера.
timestamp должна быть равна или больше максимальной существующей временной отметки. Если они равны, значение выборки с максимальной существующей временной отметкой уменьшается. Если она больше, создается новая выборка с временной отметкой, установленной на timestamp, и ее значение устанавливается в значение выборки с максимальной существующей временной отметкой минус value.
Если временной ряд пустой, значение устанавливается в value.
Если не указано, временная отметка устанавливается по часам сервера.
RETENTION retentionPeriod максимальный период хранения, сравниваемый с максимальной существующей временной отметкой, в миллисекундах. Используйте только в случае создания нового временного ряда. Она игнорируется, если вы добавляете выборки в существующий временной ряд. См. RETENTION в TS.CREATE.
RETENTION в TS.CREATE.UNCOMPRESSED
изменяет хранение данных со сжатого (по умолчанию) на несжатое. Используйте только в случае создания нового временного ряда. Она игнорируется, если вы добавляете выборки в существующий временной ряд. См. ENCODING в TS.CREATE.
CHUNK_SIZE size
размер памяти в байтах, выделенный для каждого фрагмента данных. Используйте только в случае создания нового временного ряда. Она игнорируется, если вы добавляете выборки в существующий временной ряд. См. CHUNK_SIZE в TS.CREATE.
LABELS [{label value}...]
набор пар метка-значение, которые представляют метаданные метки ключа и служат вторичным индексом. Используйте только в случае создания нового временного ряда. Она игнорируется, если вы добавляете выборки в существующий временной ряд. См. LABELS в TS.CREATE.
- Вы можете использовать эту команду для добавления данных в несуществующий временной ряд в одной команде. Вот почему
RETENTION,UNCOMPRESSED,CHUNK_SIZE, иLABELSявляются необязательными аргументами. - Если указаны и ключ не существует, создается новый временной ряд. Установка
RETENTIONиLABELSдобавляет дополнительную временную сложность.
Возвращаемое значение
Целочисленный ответ — временная отметка добавленной выборки или ошибка.
См. также
Связанные темы
© 2006–2022 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.
https://redis.io/commands/ts.decrby/
