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
```

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

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

Внимание!

Встроенная документация

Использование

Команды

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

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

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

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

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

Содержание