2.23.1.4. Утилита Redis-cli
Внимание!
Для работы утилиты необходимо подключить Redis в хостинг-аккаунте.Утилита 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
Более детально команды описаны в официальной документации.