Поиск
Справочник

Базы и ключи Redis: как посмотреть, найти и удалить ключи

Внутри одного Redis — 16 пронумерованных баз, и сайт может хранить ключи не в нулевой. Здесь — как узнать, где лежат данные, найти нужные ключи, посмотреть, что в них, и удалить лишнее так, чтобы Redis в это время продолжал отвечать сайту.

≈ 10 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, в каких базах есть ключи:
    redis-cli INFO keyspace

    Если на Redis стоит пароль, пишите redis-cli --askpass вместо redis-cli.

  3. Сравните ответ с примером:
    # Keyspace
    db0:keys=15234,expires=15100,avg_ttl=3412345
    db1:keys=210,expires=210,avg_ttl=86012345

    Ключи есть в базах 0 и 1. Пустые базы Redis здесь не показывает. Если ниже # Keyspace ничего нет — Redis пуст.

  4. Чтобы работать с базой 1, добавляйте к redis-cli -n 1: redis-cli -n 1 DBSIZE.
  5. Нужные ключи ищите через --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 Cache0wp-config.php: define( 'WP_REDIS_DATABASE', 1 );, префикс — WP_REDIS_PREFIX
Laravel0 для данных, 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.

Все ключи по шаблону:

  1. Посчитайте, сколько их, и посмотрите несколько:
    redis-cli --scan --pattern 'sess:*' | wc -l
    redis-cli --scan --pattern 'sess:*' | head
  2. Если это те ключи, удалите:
    redis-cli --scan --pattern 'sess:*' | xargs -r -d '\n' redis-cli UNLINK

    xargs передаёт ключи в redis-cli порциями, и на каждую порцию redis-cli пишет, сколько удалил.

  3. Проверьте, что ключей не осталось: первая команда должна вывести 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.

FLUSHALL сразу перезаписывает dump.rdb снимком без данных, если включены снимки по расписанию, — а в Ubuntu они включены. Вернуть данные из dump.rdb после FLUSHALL уже не получится. Если данные могут понадобиться, сначала скопируйте снимок: резервная копия Redis.

Если чистите только кэш сайта, а в 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.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше