Как безопасно удалить ключи в Redis по маске

Redis — одна из самых популярных in-memory баз данных, широко используемая для кэширования, хранения сессий, очередей и временных данных. Благодаря высокой скорости доступа к данным, она стала неотъемлемым компонентом современных веб-приложений. Однако при активной эксплуатации возникает необходимость управления ключами: очистка устаревших данных, удаление по маске, освобождение памяти. Прямое удаление ключей через команду `KEYS` с последующим `DEL` может привести к серьёзным проблемам — блокировке сервера, падению производительности и даже отказу сервиса.

Проблема массового удаления ключи в Redis

Команда `KEYS *session*` кажется простым решением для поиска и удаления всех ключей, связанных с сессиями. Но на практике это опасный подход. `KEYS` блокирует основной поток выполнения Redis до завершения поиска по всей базе данных. При наличии миллионов ключей эта операция может длиться десятки секунд, делая Redis полностью недоступным для других запросов.
Такое поведение недопустимо в production-средах, где каждая миллисекунда простоя влияет на пользовательский опыт и метрики бизнеса. Кроме того, комбинация `KEYS` + `DEL` усугубляет ситуацию: `DEL` тоже работает синхронно и может «подвесить» сервер при удалении тысяч ключей одновременно.

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

Безопасный способ удаления ключей по маске

Правильный подход — использовать команду `SCAN` с параметром `MATCH`. В отличие от `KEYS`, `SCAN` не блокирует сервер. Он проходит по базе итеративно, возвращая небольшие порции ключей за один вызов. Это позволяет поддерживать высокую доступность Redis даже во время массовых операций.
Алгоритм выглядит так:

• Выполняется `SCAN cursor MATCH pattern COUNT N` — получаем часть ключей по маске;
• Для каждого найденного ключа вызывается `UNLINK`, а не `DEL`;
• Процесс повторяется, пока `cursor` не вернёт 0 (сканирование завершено).

Команда `UNLINK` особенно важна. Она мгновенно удаляет ключ из индекса, но освобождение памяти происходит в фоновом потоке. Это исключает долгие паузы при удалении больших значений, таких как хэши или списки.

Как работает SCAN: детали

`SCAN` использует итераторы. Первый вызов начинается с `cursor = 0`, последующие — с возвращённого значения. Redis гарантирует, что при отсутствии изменений в наборе ключей `SCAN` обойдёт все элементы. При модификациях возможны дубли, но пропусков не будет.
Параметр `COUNT` указывает примерное количество возвращаемых элементов. На практике лучше задавать от 100 до 1000. Меньше — медленнее, больше — риск временной нагрузки.

Пошаговое руководство: как удалить ключи по маске

Ниже — проверенный алгоритм безопасного удаления ключей в Redis по маске. Подходит для автоматизации и интеграции в скрипты мониторинга.

1. Подключитесь к Redis: используйте redis-cli, Python (библиотека redis-py) или любой другой клиент.
2. Выберите базу данных: если используется не db0, переключитесь через SELECT.
3. Запустите цикл SCAN: начните с курсора 0, применяйте MATCH с нужной маской (например, *:cache).
4. Обрабатывайте порции ключей: для каждой порции вызывайте UNLINK по одному или пакетно (через pipeline).
5. Повторяйте, пока курсор не станет 0.
6. Проверьте результат: можно сравнить количество ключей до и после через DBSIZE.

Пример на Python

«`python
import redis
r = redis.Redis(host=’localhost’, port=6379, db=0)
def delete_keys_by_pattern(pattern, count=100):
cursor = 0
deleted_count = 0

while True:
cursor, keys = r.scan(cursor=cursor, match=pattern, count=count)
if keys:
r.unlink(*keys)
deleted_count += len(keys)

if cursor == 0:
break

print(f»Удалено {deleted_count} ключей по маске ‘{pattern}'»)
# Использование
delete_keys_by_pattern(«*:temp:*», count=500)
«`

Пример через redis-cli

Если нужно выполнить удаление вручную:
«`bash
# Запуск scan и unlink через Lua-скрипт (чтобы избежать множества round-trip)
redis-cli —eval script_scan_unlink.lua , ‘pattern*:to:delete’ 100
«`
Где `script_scan_unlink.lua`:
«`lua
local pattern = ARGV[1]
local count = tonumber(ARGV[2]) or 100
local cursor = 0
local deleted = 0
repeat
local result = redis.call(‘SCAN’, cursor, ‘MATCH’, pattern, ‘COUNT’, count)
cursor = tonumber(result[1])
local keys = result[2]
if #keys > 0 then
redis.call(‘UNLINK’, unpack(keys))
deleted = deleted + #keys
end
until cursor == 0
return deleted
«`
Запуск:
«`bash
redis-cli —eval script_scan_unlink.lua , ‘*:old:*’ 500
«`

Распространённые ошибки и как их избежать

Ошибки при работе с Redis часто связаны с непониманием его внутреннего устройства. Ниже — типичные проблемы и пути их решения.

Ошибка 1: Использование KEYS вместо SCAN

Как уже говорилось, `KEYS` блокирует сервер. В Redis 7.0+ команда помечена как deprecated для использования в продакшене. Альтернатива — только `SCAN`.

Ошибка 2: DEL вместо UNLINK

`DEL` синхронно освобождает память. При удалении большого хэша (например, 100 МБ) это может занять сотни миллисекунд. `UNLINK` делегирует работу фоновому потоку, сохраняя отзывчивость.

Ошибка 3: Слишком большой COUNT в SCAN

Значение `COUNT=10000` может вернуть тысячи ключей за раз, создавая нагрузку на сеть и клиент. Оптимально — 100–1000.

Ошибка 4: Отсутствие лимита времени выполнения

Даже безопасный `SCAN` может работать долго при миллионах ключей. В скриптах добавляйте контроль времени или ограничение итераций.

Инструменты и скрипты для автоматизации

Ручное управление ключами неэффективно. Лучше использовать готовые решения или написать собственные скрипты.

Redis CLI с Lua

Lua-скрипты выполняются на стороне сервера, что снижает задержку. Пример выше — идеален для регулярной очистки.

Python + redis-py

Библиотека `redis-py` поддерживает `scan_iter()` — удобный генератор для обхода ключей.
«`python
for key in r.scan_iter(match=’*:junk:*’, count=500):
r.unlink(key)
«`
Автоматически обрабатывает курсоры, остаётся только вызвать `UNLINK`.

Go и другие языки

В Go есть библиотека `go-redis`, в Java — `Jedis`, в Node.js — `ioredis`. Все поддерживают `SCAN` и `UNLINK`.

Готовые утилиты

• redex — CLI-инструмент для массовых операций над ключами;
• redis-gui — графические интерфейсы, но они не всегда используют безопасные методы;
• Custom cron-задачи — например, ежедневная очистка старых ключей через Python-скрипт.

Экспертная практика: советы от разработчиков

Опытные специалисты выработали ряд принципов, которые помогают избежать проблем с Redis.

• Не храните то, что можно не хранить. Чем меньше ключей — тем проще управление. Используйте TTL по умолчанию.
• Структурируйте ключи. Используйте разделители: service:type:id. Это упрощает поиск и удаление по маске.
• Тестируйте на снимках данных. Перед запуском скрипта — сделайте RDB-дамп и проверьте на нём.
• Мониторьте производительность. Следите за latency, blocked_clients, used_memory.
• Используйте namespace-ключи. Например, v1:users:* — чтобы легко управлять версиями.

Вопросы и ответы

Заключение

Удаление ключей в Redis по маске — обычная, но потенциально опасная операция. Прямое использование `KEYS` и `DEL` может вывести систему из строя. Безопасная альтернатива — комбинация `SCAN` + `MATCH` + `UNLINK`, которая обеспечивает стабильность и производительность даже при работе с миллионами ключей.

• Используйте `SCAN`, а не `KEYS`, для поиска ключей.
• Применяйте `UNLINK` вместо `DEL` при массовом удалении.
• Тестируйте скрипты в staging-среде перед запуском в продакшене.
• Автоматизируйте очистку, но с контролем и логированием.
• Структурируйте ключи и используйте TTL для упрощения управления.