8.5.14. Redis CLI
Redis CLI — утилита для работы с Redis через интерфейс командной строки. Подробное описание всех возможностей доступно в официальной документации.
Встроенная документация
Просмотр краткой документации:
redis-cli -h
Подключение
С помощью строки подключения:
redis-cli -u redis://example.redis.tools:10000
Вместо redis://example.redis.tools:10000 используйте строку подключения к нужному инстансу Redis, скопированную из панели управления.
С помощью хоста и порта:
redis-cli -h example.redis.tools -p 10000
Вместо example.redis.tools и 10000 используйте хост и порт из строки подключения к нужному инстансу Redis в панели управления.
Авторизация после подключения:
AUTH login "password"
Вместо login и password используйте данные пользователя Redis. Если логин не указывать, авторизация будет под пользователем по умолчанию.
Для хостинга Если Redis заказан как дополнительная услуга, для подключения нужно использовать Unix-сокет:
redis-cli -s ~/.system/redis.sock
Использование
Управление данными
Вывести все записанные ключи:
keys '*'
Вывести все записанные ключи с key_ в названии:
keys key_*
В паттерне можно использовать символы:
*— любое количество любых символов.?— один любой символ.
Записать данные example_data с ключом key_example:
set key_example "example_data"
Получить данные, записанные ранее с ключом key_example:
get key_example
Получить тип данных, сохранённых в ключе key_example:
type key_example
Переименовать ключ с key_example на key_another_example:
rename key_example key_another_example
Проверить существование ключа key_example:
exists key_example
Если ключ существует, будет выведено 1, если нет — 0.
Удалить данные и ключ key_example:
del key_example
Получить время жизни ключа key_example:
ttl key_example
По умолчанию выводится -1, что означает отсутствие ограничения времени жизни.
Установить время жизни ключа key_example и данных, записанных в нём, по истечению которого ключ будет удалён:
expire key_example
Очередь выполнения команд
Активировать режим записи команд в очередь:
multi
Этот режим полезен для поочерёдного выполнения множества команд.
Выполнить все команды, записанные в очередь после multi:
exec
Если во время указания команд возникла ошибка, то все записи в очереди будут сброшены.
Операции над числами
Инкремент, увеличение на единицу значения данных с ключом key_example:
incr key_example
Инкремент, увеличение значения данных с ключом key_example на число, указанное вместо increment:
incrby key_example increment
Декремент, уменьшение на единицу значения данных с ключом key_example:
decr key_example
Декремент, увеличение значения данных с ключом key_example на число, указанное вместо decrement:
decrby key_example decrement
Операции над строками
Дописать в конец строки данных текст 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