Массовые действия

функциональный

Удаляйте ключи или задавайте им срок действия по шаблону с предварительным пробным подсчётом (dry-run), а также импортируйте файлы команд.

Массовые действия чистят сразу много ключей, не жертвуя надёжностью диалогов для отдельных ключей. Щёлкните правой кнопкой мыши по базе данных Redis или папке ключей в проводнике (у базы данных пункты удаления и изменения TTL находятся в меню Массовое редактирование а файлы команд — в Импорт / Экспорт):

  • Удалить ключи по шаблону… (база данных) или Удалить ключи в папке… (папка)
  • Установить TTL по шаблону… или Установить TTL в папке… - установите срок действия для каждого совпавшего ключа или отметьте Вместо этого удалить срок действия (PERSIST) чтобы его очистить
  • Импорт файла команд… (база данных) - запустите файл команд Redis, по одной на строку
  • Экспорт в командный файл… (база данных) или Экспорт папки в командный файл… (папка) - запишите совпавшие ключи в файл, который затем можно выполнить командой «Импорт файла команд…»

Меню одной клавиши добавляет Переименовать… (RENAMENX, или RENAME когда вы разрешаете перезапись) и, под Копировать в, Копировать в базу данных… (COPY key key DB n, Redis 6.2 и позже) и Копировать в подключение… (DUMP на этом соединении, RESTORE на том, который вы выбираете, включая срок годности). Каждый показывает точную команду перед её выполнением, отключён на соединениях только для чтения и заблокированных производственных соединениях (Копирование в соединение также проверяет цель соединение), и требует повторного щелчка везде, где его потребовала бы вкладка запроса. Установка флажка Заменить перезаписывает ключ, который уже существует в месте назначения; без него копирование отказывается и сообщает об этом.

Сначала пробный прогон

Удаление и TTL никогда не выполняют запись первыми. Диалог начинается с префикса папки или текущего фильтра ключей базы данных, и Подсчитать совпадающие ключи обходит пространство ключей тем же ограниченным SCAN обозреватель ключей (до 25 000 ключей), поэтому подсчёт ничего не меняет. Подсчёт идёт по странице за раз, с бегущим итогом и кнопкой Стоп кнопка; остановленный или достигший предела подсчёт помечается как частичный, а шаг применения касается только тех ключей, которые были перечислены при пробном запуске, никогда не затрагивая остальные. Вы видите, сколько ключей соответствует критериям перед применением любых действий. Массовое удаление требует от вас ввести количество соответствующих ключей перед активацией кнопки, затем выполняет пакетные UNLINK команды с индикатором прогресса и Стоп кнопка; пакеты начинаются с 500 ключей и уменьшаются (до 50), когда один из них занимает больше секунды, так что «Остановить» никогда не ждёт долго текущий пакет. Изменение TTL запускает один EXPIRE или PERSIST по ключу, пакетами в том же темпе; поле секунд и Вместо этого удалить срок действия (PERSIST) поле остаются доступными для правки после подсчёта. Имена бинарных ключей сохраняются побайтово.

SQLly
Массовое удаление в Redis: количество совпадений при пробном запуске для шаблона папки перед подтверждённым пакетным UNLINK.Массовое удаление в Redis: количество совпадений при пробном запуске для шаблона папки перед подтверждённым пакетным UNLINK.
Массовое удаление в Redis: количество совпадений при пробном запуске для шаблона папки перед подтверждённым пакетным UNLINK.

Действия над выбранными вами ключами

Когда ключи, которые вам нужны, проще выбрать, чем описать шаблоном, перечислите их на вкладке запроса с SQLLY.KEYS <pattern> <limit>, сортировать или фильтровать сетку (по ttl_seconds, например), выделите строки, щёлкните правой кнопкой мыши и выберите Инструменты › Ключи Redis › Удалить выбранные ключи…, Установить TTL для выбранных ключей… или Снять срок действия с выбранных ключей…. Ждать пробного прогона не нужно: выбранное — и есть список, поэтому диалог открывается сразу на подтверждении с показанными ключами. Удаление всё равно попросит ввести количество ключей, а ключи в кластере удаляются пакетами, не выходящими за пределы одного хеш-слота. Действие использует подключение и базу данных той вкладки, которой принадлежит сетка. См. обозреватель ключей чтобы узнать, для каких результатов доступно меню.

Импорт файла команд

Выберите текстовый файл UTF-8 с одной командой на строку (SET, HSET, EXPIRE…; пустые строки и # комментарии пропускаются). Записывайте двоичные значения в кавычках "\xHH" escape-последовательности. SQLly читает и разбирает весь файл перед выполнением и отклоняет файл, который не является исполняемым скриптом команд, указывая строку: несбалансированная кавычка, некорректная JSON-строка или байты, не являющиеся допустимым UTF-8. Затем выполнение пытается выполнить каждую строку не более одного раза, ведя подсчёт обработанных команд. Неудачная строка не останавливает импорт: каждая ошибка перечисляется с номером строки, командой и ошибкой сервера, а в сводке подсчитывается, что прошло успешно, а что нет. SELECT внутри файла действует и на строки после неё.

Файл выполняется пакетами примерно по 200 строк, каждый пакет на своём подключении, так что MULTI … EXEC блок никогда не разрезается на два пакета. Если строка внутри транзакции падает с ошибкой, транзакция отбрасывается: остаток блока пропускается, а не выполняется вне транзакции, и в итоговом отчёте пропущенные строки посчитаны.

Экспорт папки как командного файла

Экспорт записывает каждый ключ, который соответствует префиксу папки (или фильтру ключей базы данных), как команды, которые его восстанавливают: SET для строк, HSET, RPUSH, SADD и ZADD в строках до 500 элементов, один XADD на запись потока с её оригинальным идентификатором, JSON.SET для JSON-документов, затем PEXPIRE для ключа со временем жизни (отсчитывается от момента импорта). Двоичные имена и значения ключей записываются как "\xHH" экранирования, поэтому импорт файла в пустую базу данных возвращает те же самые байты и то же количество ключей. Он только читает: на сервере ничего не меняется, поэтому работает и для подключений только для чтения.

Экспорт останавливается на выбранном вами лимите ключей (по умолчанию 10 000) и на 8 МБ, что является лимитом файла для импорта, поэтому каждый экспорт можно импортировать снова. Прекращённый экспорт заканчивается строкой # partial строки, а типы, которые импорт не может восстановить (другие типы модулей), перечисляются как # skipped комментарии, а не пропускаются молча. Группы потребителей потоков не экспортируются, экспортируются только записи. Импорт поверх существующих ключей добавляет в списки и потоки. Экспортируйте в пустую базу данных или сначала удалите папку.

Проверка безопасности

Перед запуском импорта каждая строка проверяется по тому же списку команд Redis, которым пользуется редактор запросов. Диалог показывает, сколько строк пишут данные, и перечисляет по номерам строк каждую найденную деструктивную или серверно-административную команду, например FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN, DEBUG, SCRIPT, MODULE и ACL. Когда такие команды есть, или когда настройки безопасности подключения требуют подтверждения от редактора, нужно ввести RUN ALL прежде чем файл можно будет выполнить.

Массовые операции записи и импорт отключены на подключениях только для чтения, а также на рабочих подключениях с заблокированной записью. Пункты в проводнике показаны серым, а диалоги объясняют причину, но по-прежнему позволяют проверить количество или файл. Сначала снимите блокировку записи через чип в строке состояния. При подтверждении блокировка проверяется ещё раз, поэтому разблокировка, срок которой истёк, пока диалог был открыт, всё равно принимается. Если закрыть диалог во время выполнения, операция остановится после текущего пакета, а краткая сводка появится в строке состояния.