XINFO

XINFO STREAM

XINFO STREAM key [FULL [COUNT count]]

Доступно с версии:

5.0.0

Сложность по времени:

O(1)

Категории ACL:

@read, @stream, @slow,

Эта команда возвращает информацию о потоке, хранящемся в <key>.

Информационные детали, предоставляемые этой командой:

• длина: количество записей в потоке (см. XLEN)
• ключи-дерева-поразрядности: количество ключей в базовой структуре данных поразрядного дерева
• узлы-дерева-поразрядности: количество узлов в базовой структуре данных поразрядного дерева
• группы: количество определенных для потока групп потребителей
• последний-сгенерированный-идентификатор: идентификатор последней добавленной в поток записи
• максимальный-удалённый-идентификатор-записи: максимальный идентификатор записи, удаленной из потока
• добавленные-записи: счётчик всех записей, добавленных в поток за время его существования
• первая-запись: идентификатор и кортежи значений полей первой записи в потоке
• последняя-запись: идентификатор и кортежи значений полей последней записи в потоке

Необязательный модификатор FULL обеспечивает более подробный ответ. При использовании модификатор FULL ответ включает массив записи, состоящий из записей потока (идентификатор и кортежи значений полей) в порядке возрастания. Кроме того, группы также является массивом, и для каждой из групп потребителей он состоит из информации, предоставляемой XINFO GROUPS и XINFO CONSUMERS.

Опция COUNT может быть использована для ограничения количества записей потока и PEL, которые возвращаются (возвращаются первые <count> записи). По умолчанию COUNT равно 10, а значение COUNT 0 означает, что будут возвращены все записи (время выполнения может быть долгим, если поток содержит большое количество записей).

Возврат

Массивный ответ: список информационных данных

Примеры

Ответ по умолчанию:

> XINFO STREAM mystream
 1) "length"
 2) (integer) 2
 3) "radix-tree-keys"
 4) (integer) 1
 5) "radix-tree-nodes"
 6) (integer) 2
 7) "last-generated-id"
 8) "1638125141232-0"
 9) "max-deleted-entry-id"
10) "0-0"
11) "entries-added"
12) (integer) 2
13) "groups"
14) (integer) 1
15) "first-entry"
16) 1) "1638125133432-0"
    2) 1) "message"
       2) "apple"
17) "last-entry"
18) 1) "1638125141232-0"
    2) 1) "message"
       2) "banana"

Полный ответ:

> XADD mystream * foo bar
"1638125133432-0"
> XADD mystream * foo bar2
"1638125141232-0"
> XGROUP CREATE mystream mygroup 0-0
OK
> XREADGROUP GROUP mygroup Alice COUNT 1 STREAMS mystream >
1) 1) "mystream"
   2) 1) 1) "1638125133432-0"
         2) 1) "foo"
            2) "bar"
> XINFO STREAM mystream FULL
 1) "length"
 2) (integer) 2
 3) "radix-tree-keys"
 4) (integer) 1
 5) "radix-tree-nodes"
 6) (integer) 2
 7) "last-generated-id"
 8) "1638125141232-0"
 9) "max-deleted-entry-id"
10) "0-0"
11) "entries-added"
12) (integer) 2
13) "entries"
14) 1) 1) "1638125133432-0"
       2) 1) "foo"
          2) "bar"
    2) 1) "1638125141232-0"
       2) 1) "foo"
          2) "bar2"
15) "groups"
16) 1)  1) "name"
        2) "mygroup"
        3) "last-delivered-id"
        4) "1638125133432-0"
        5) "entries-read"
        6) (integer) 1
        7) "lag"
        8) (integer) 1
        9) "pel-count"
       10) (integer) 1
       11) "pending"
       12) 1) 1) "1638125133432-0"
              2) "Alice"
              3) (integer) 1638125153423
              4) (integer) 1
       13) "consumers"
       14) 1) 1) "name"
              2) "Alice"
              3) "seen-time"
              4) (integer) 1638125133422
              5) "active-time"
              6) (integer) 1638125133432
              7) "pel-count"
              8) (integer) 1
              9) "pending"
              10) 1) 1) "1638125133432-0"
                     2) (integer) 1638125133432
                     3) (integer) 1

История

• Начиная с версии Redis 6.0.0: Добавлен модификатор FULL.
• Начиная с версии Redis 7.0.0: Добавлены поля max-deleted-entry-id, entries-added, recorded-first-entry-id, entries-read и lag.
• Начиная с версии Redis 7.2.0: Добавлен поле active-time, и изменено значение seen-time.