TDIGEST.MERGE

TDIGEST.MERGE

Синтаксис

TDIGEST.MERGE destination-key numkeys source-key [source-key ...]
  [COMPRESSION compression] [OVERRIDE]

Доступно в:: Redis Stack / Bloom 2.4.0
Временная сложность:: O(N*K), где N — количество центроидов, а K — количество входных набросков

Объединяет несколько набросков t-digest в один набросок.

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

destination-key

— это имя ключа для наброска t-digest, к которому нужно добавить значения наблюдений.

Если destination-key не существует — создается новый набросок.

Если destination-key — это существующий набросок, его значения объединяются со значениями исходных ключей. Чтобы перезаписать содержимое целевого ключа, используйте OVERRIDE.

numkeys

Количество набросков, значения наблюдений которых нужно объединить (1 или более).

source-key

Каждый из них — это имя ключа для наброска t-digest, значения наблюдений из которого нужно объединить.

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

COMPRESSION compression

— это управляемый параметр, определяющий компромисс между точностью и потреблением памяти. Значение 100 обычно используется для обычных задач. 1000 обеспечивает большую точность. Если значение не указано, по умолчанию используется сжатие 100. Более подробную информацию о влиянии параметра сжатия на точность см. в статье The t-digest: Efficient estimates of distributions.

Когда COMPRESSION не указано:

Если destination-key не существует или если OVERRIDE указано, сжатие устанавливается в максимальное значение среди всех исходных набросков.
Если destination-key уже существует и OVERRIDE не указано, его сжатие не изменяется.

OVERRIDE

При указании, если ключ `destination-key` уже существует, он перезаписывается.

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

OK при успехе, ошибка в противном случае.

Примеры

redis> TDIGEST.CREATE s1
OK
redis> TDIGEST.CREATE s2
OK
redis> TDIGEST.ADD s1 10.0 20.0
OK
redis> TDIGEST.ADD s2 30.0 40.0
OK
redis> TDIGEST.MERGE sM 2 s1 s2
OK
redis> TDIGEST.BYRANK sM 0 1 2 3 4
1) "10"
2) "20"
3) "30"
4) "40"
5) "inf"

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