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