Базы и ключи Redis: как посмотреть, найти и удалить ключи
Внутри одного Redis — 16 пронумерованных баз, и сайт может хранить ключи не в нулевой. Здесь — как узнать, где лежат данные, найти нужные ключи, посмотреть, что в них, и удалить лишнее так, чтобы Redis в это время продолжал отвечать сайту.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, в каких базах есть ключи:
redis-cli INFO keyspaceЕсли на Redis стоит пароль, пишите
redis-cli --askpassвместоredis-cli. - Сравните ответ с примером:
# Keyspace db0:keys=15234,expires=15100,avg_ttl=3412345 db1:keys=210,expires=210,avg_ttl=86012345Ключи есть в базах 0 и 1. Пустые базы Redis здесь не показывает. Если ниже
# Keyspaceничего нет — Redis пуст. - Чтобы работать с базой 1, добавляйте к redis-cli
-n 1:redis-cli -n 1 DBSIZE. - Нужные ключи ищите через
--scan— как найти ключи.
Что значат строки INFO keyspace
| Часть строки | Что значит |
|---|---|
db0 | номер базы |
keys=15234 | сколько ключей в базе |
expires=15100 | у скольких ключей задано время жизни — они удалятся сами |
avg_ttl=3412345 | сколько в среднем осталось жить этим ключам, в миллисекундах: 3 412 345 мс — около 57 минут |
Если expires намного меньше keys, большая часть ключей сама не удалится и будет лежать, пока её не удалят или пока Redis не упрётся в лимит памяти. Как задать время жизни — TTL и EXPIRE, что будет при нехватке памяти — maxmemory.
Число ключей только в одной базе покажет redis-cli -n 1 DBSIZE, ответ (integer) 210.
Что такое базы в Redis
В Ubuntu Redis создаёт 16 баз с номерами от 0 до 15: строка databases 16 в /etc/redis/redis.conf.
- Каждое новое подключение попадает в базу 0.
- В окне redis-cli базу меняют командой
SELECT 1. Номер базы виден в строке ввода:127.0.0.1:6379[1]>. - В одной команде — ключ
-n:redis-cli -n 1 …. - В разных базах могут быть ключи с одинаковыми именами, это разные ключи.
- Все базы хранятся в одном файле снимка dump.rdb и делят общий лимит памяти maxmemory.
Документация Redis советует разносить по базам ключи одного приложения, а не держать в одном Redis разные несвязанные приложения. Если на сервере два сайта, у каждого должна быть своя база или свой префикс ключей, иначе сайты будут читать и затирать данные друг друга.
Какую базу берут популярные движки:
| Что на сайте | Какая база | Где поменять |
|---|---|---|
| WordPress с плагином Redis Object Cache | 0 | wp-config.php: define( 'WP_REDIS_DATABASE', 1 );, префикс — WP_REDIS_PREFIX |
| Laravel | 0 для данных, 1 для кэша | файл .env: REDIS_DB и REDIS_CACHE_DB, префикс — REDIS_PREFIX |
Префикс ключей Laravel по умолчанию собирается из имени приложения: при APP_NAME=Laravel ключи начинаются с laravel-database-.
Как найти ключи
Все ключи, которые начинаются с sess::
redis-cli --scan --pattern 'sess:*'В другой базе — с -n:
redis-cli -n 1 --scan --pattern 'sess:*'Сколько их:
redis-cli --scan --pattern 'sess:*' | wc -lЧто можно писать в шаблоне:
| Шаблон | Что найдёт |
|---|---|
sess:* | ключи, которые начинаются с sess: |
*:user:* | ключи, в которых есть :user: |
cache:? | cache: и ровно один любой символ |
cache:[ab]* | ключи, которые начинаются с cache:a или cache:b |
Шаблон берите в одинарные кавычки, чтобы звёздочку не раскрыл bash.
--scan перебирает ключи порциями и между порциями отвечает сайту. Один и тот же ключ может попасться дважды: так устроен перебор. Поэтому число через wc -l может оказаться больше настоящего — точное число ключей во всей базе покажет DBSIZE. Удалению повторы не мешают.
KEYS * на рабочем сервере. Она перебирает всю базу за один раз, и пока не закончит, Redis не отвечает сайту. Документация Redis предупреждает: на большой базе KEYS может уронить скорость. Такие вызовы видно в журнале медленных команд — SLOWLOG.Внутри окна redis-cli перебор выглядит так:
127.0.0.1:6379> SCAN 0 MATCH sess:* COUNT 100
1) "1792"
2) 1) "sess:a81f"
2) "sess:09c2"Первая строка ответа — номер, с которого продолжать: SCAN 1792 MATCH sess:* COUNT 100. Перебор закончен, когда Redis вернёт "0". Порция может прийти пустой — это не конец, продолжайте, пока не вернётся "0". Руками так перебирать долго, --scan делает это сам. Зато в SCAN можно искать ключи одного вида, например только хеши: SCAN 0 TYPE hash COUNT 100.
Что лежит в ключе
Сначала узнайте вид ключа:
redis-cli TYPE sess:a81fОтвет — одно слово. По нему видно, какой командой читать:
| Ответ TYPE | Что это | Как посмотреть |
|---|---|---|
string | строка | GET ключ |
hash | набор полей и значений | HSCAN ключ 0 или HGET ключ поле |
list | список | LRANGE ключ 0 9 — первые 10 элементов |
set | множество | SSCAN ключ 0 |
zset | упорядоченное множество | ZRANGE ключ 0 9 WITHSCORES |
stream | поток событий | XRANGE ключ - + COUNT 10 |
none | такого ключа нет | проверьте имя и номер базы |
Большие ключи не читайте целиком через HGETALL, SMEMBERS или LRANGE ключ 0 -1: на время чтения Redis остановится — медленные команды. Сколько памяти занимает ключ — MEMORY USAGE, сколько ему осталось жить — TTL ключ, подробно — TTL и EXPIRE.
Как удалить ключи
Один ключ или несколько:
redis-cli UNLINK sess:a81f sess:09c2Ответ — сколько ключей удалено: (integer) 2. Ключ пропадает сразу, а память Redis освобождает в отдельном потоке. DEL делает то же, но освобождает память сразу и на большом ключе задерживает Redis. Берите UNLINK.
Все ключи по шаблону:
- Посчитайте, сколько их, и посмотрите несколько:
redis-cli --scan --pattern 'sess:*' | wc -l redis-cli --scan --pattern 'sess:*' | head - Если это те ключи, удалите:
redis-cli --scan --pattern 'sess:*' | xargs -r -d '\n' redis-cli UNLINKxargs передаёт ключи в redis-cli порциями, и на каждую порцию redis-cli пишет, сколько удалил.
- Проверьте, что ключей не осталось: первая команда должна вывести
0.
Если на Redis стоит пароль, --askpass в такой цепочке не подойдёт: пароль пришлось бы вводить и для --scan, и для каждой порции. Передайте пароль через переменную REDISCLI_AUTH:
read -rs REDISCLI_AUTH
export REDISCLI_AUTH
redis-cli --scan --pattern 'sess:*' | xargs -r -d '\n' redis-cli UNLINK
unset REDISCLI_AUTHПосле read -rs REDISCLI_AUTH введите пароль и нажмите Enter — на экране он не появится. unset в конце убирает пароль из переменной. Подробнее о REDISCLI_AUTH — redis-cli.
'*' удалит все ключи базы. Перед удалением ключей, которых нет больше нигде — сессий, очередей, — сделайте копию: резервная копия Redis.Как очистить базу целиком
| Команда | Что удаляет |
|---|---|
redis-cli FLUSHDB ASYNC | все ключи базы 0. Другая база — с -n: redis-cli -n 1 FLUSHDB ASYNC |
redis-cli FLUSHALL ASYNC | все ключи во всех 16 базах |
С ASYNC ключи пропадают сразу, а память освобождается в отдельном потоке, и Redis продолжает отвечать сайту. Без ASYNC в Ubuntu очистка идёт за один раз: строка lazyfree-lazy-user-flush no в redis.conf. Ответ в обоих случаях — OK.
Если чистите только кэш сайта, а в Redis лежит что-то ещё — сессии, очереди, — не берите FLUSHALL: очистите только базу кэша через FLUSHDB или ключи кэша по шаблону.
FLUSHALL и KEYS входят в категорию @dangerous. Если для сайта заведён отдельный пользователь, как в разделе пароль и пользователи, FLUSHALL ему запрещён, а FLUSHDB разрешён.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
(error) ERR DB index is out of range | номер базы больше 15 | в Ubuntu базы с 0 по 15 |
--scan ничего не выводит, а сайт пишет в Redis | ключи в другой базе | посмотрите redis-cli INFO keyspace и добавьте -n с номером базы |
(error) WRONGTYPE Operation against a key holding the wrong kind of value | команда не для этого вида ключа, например GET для хеша | узнайте вид: redis-cli TYPE ключ и возьмите команду из таблицы что лежит в ключе |
(nil) на GET | ключа нет или истекло время жизни | проверьте имя ключа и номер базы |
(error) NOPERM this user has no permissions to run the 'flushall' command | пользователю сайта запрещён FLUSHALL | войдите пользователем default или очистите базу через FLUSHDB |
(error) NOAUTH Authentication required. | на Redis стоит пароль | redis-cli --askpass — разбор |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: SELECT — на английском: новое подключение в базе 0, базы в одном файле RDB и AOF, базы — для ключей одного приложения.
- Документация Redis: SCAN — на английском: перебор по номеру до 0, повторы ключей, пустые порции, MATCH, COUNT, TYPE.
- Документация Redis: KEYS — на английском: предупреждение о рабочем сервере, шаблоны
?,*,[ae]. - Документация Redis: UNLINK — на английском: память освобождается в другом потоке.
- Документация Redis: FLUSHDB и FLUSHALL — на английском: ASYNC и SYNC, lazyfree-lazy-user-flush с Redis 6.2.
- Файл redis.conf в Ubuntu 24.04 — databases 16, lazyfree-lazy-user-flush no.
- Исходный код Redis 7.0.15: db.c — FLUSHALL записывает снимок при включённом расписании save, ответы TYPE, текст DB index is out of range.
- Исходный код Redis 7.0.15: server.c — строка INFO keyspace, пустые базы не показываются, текст WRONGTYPE.
- Описания команд Redis 7.0.15 — KEYS и FLUSHALL в категориях keyspace и dangerous.
- Redis Object Cache 3.0.0: README — WP_REDIS_DATABASE по умолчанию 0, WP_REDIS_PREFIX.
- Laravel 12: config/database.php — REDIS_DB 0, REDIS_CACHE_DB 1, префикс из APP_NAME.
Сверено 5 ноября 2026 года.
Что почитать дальше
- redis-cliкак подключиться и какие ключи самые большие.
- Память Redis: INFO memoryсколько памяти занимают ключи.
- Резервная копия Redisкак сохранить данные перед удалением.