2.23.1.3. Утилита Redis-cli

Утилита Redis-cli является полноценным клиентом Redis и используется для работы с данными, сохраненными в базе данных Redis.

Просмотр краткой документации:

redis-cli -h

Для подключения к Redis используется Unix-сокет. Команда для подключения выглядит так:

redis-cli -s ~/.system/redis.sock

Ключ -s указывается обязательно, без него нельзя подключиться к Unix-сокету.

После подключения к сокету Redis доступны к использованию следующие популярные команды:

Управление данными

  • Вывести все записанные ключи:
    keys '*'
  • Вывести все записанные ключи, которые имеют в названии key_:
    keys key_*

    В паттерне можно использовать символы:

    • * — любое количество любых символов.
    • ? — один любой символ.
  • Записать данные example_data с ключом key_example:
    set key_example "example_data"
  • Получить данные, записанные ранее с ключом key_example:
    get key_example
  • Получить тип данных, сохраненных в этом ключе:
    type key_example
  • Переименовать ключ с key_example на key_another_example:
    rename key_example key_another_example
  • Проверить существование ключа:
    exists key_example

    Если ключ существует, будет выведено 1, если нет — 0.

  • Удалить данные и ключ key_example:
    del key_example
  • Получить время жизни ключа:
    ttl key_example

    По умолчанию выводится -1, что означает отсутствие ограничения времени жизни.

  • Установить TTL и данных, записанных в нём, по истечению которого ключ будет удалён:
    expire key_example

Очередь выполнения команд

  • Активировать режим записи команд в очередь:
    multi

    Этот режим полезен для поочерёдного выполнения множества команд.

  • Выполнить все команды, записанные в очередь после multi:
    exec

    Если во время указания команд возникла ошибка, то все записи в очереди будут сброшены.

Операции над числами

  • Инкремент, увеличение значения данных на единицу, записанных в ключе key_example:
    incr key_example
  • Инкремент, увеличение значения данных на число, указанное вместо increment:
    incrby key_example increment
  • Декремент, уменьшение значения данных на единицу, записанных в ключе key_example:
    decr key_example
  • Декремент, увеличение значения данных на число, указанное вместо decrement:
    decrby key_example decrement

Операции над строками

  • Дописать в конец строки данных ключа key_example текст test_text:
    append key_example "test_text"
  • Длина записанной строки данных в ключе:
    strlen key_example
  • Получить определённый диапазон символов строки:
    getrange key_example start end

    Начало и конце диапазона указываются вместо start и end. Например, для строки 1234567890 команда getrange key_example 2 6 вернёт 4567. Отсчёт символов производится с 0.

  • Заменить данные, записанные в ключе, начиная с символа под номером start:
    setrange key_example start "text"

    Например, строку 1234567890 команда setrange key_example 2 «123» изменит на 1212367890.

Работа со списками

  • Добавить в конец списка новый элемент с текстом test:
    rpush key_example "test"
  • Вывести элементы списка, начиная с элемента под номером start и заканчивая номером stop:
    lrange key_example start stop
  • Получить количество элементов списка:
    llen key_example
  • Удалить первый элемент списка и получить данные следующего:
    lpop key_example

Более детально команды описаны в официальной документации.

  • hosting/configuration/libs-and-utils/redis-cli.txt
  • Последнее изменение: 2020/07/09 12:20
  • karlov