CONFIG

CONFIG REWRITE

CONFIG REWRITE

Доступно с версии:

2.8.0

Сложность:

O(1)

Категории ACL:

@admin, @slow, @dangerous,

Команда CONFIG REWRITE перезаписывает файл redis.conf с конфигурацией сервера, применяя минимальные изменения, необходимые для отражения текущих настроек сервера, которые могут отличаться от исходных из-за использования команды CONFIG SET.

Перезапись выполняется очень консервативным способом:

• Комментарии и общая структура исходного файла redis.conf сохраняются по возможности.
• Если опция уже существует в старом файле redis.conf, она будет перезаписана в той же позиции (номер строки).
• Если опция отсутствует, но установлена по умолчанию, она не добавляется в процессе перезаписи.
• Если опция отсутствует, но установлена не по умолчанию, она добавляется в конец файла.
• Неиспользуемые строки оставляются пустыми. Например, если раньше были указаны несколько директив save, но в текущей конфигурации их меньше или нет (например, отключена RDB персистенция), все строки будут очищены.

CONFIG REWRITE также может перезаписать файл конфигурации с нуля, если исходный файл по какой-то причине больше не существует. Однако, если сервер был запущен без файла конфигурации вообще, CONFIG REWRITE вернет ошибку.

Атомарный процесс перезаписи

Для обеспечения согласованности файла redis.conf, то есть при ошибках или сбоях, вы всегда возвращаетесь к старому файлу или новому, перезапись выполняется с одним write(2) вызовом, содержащим достаточно данных, чтобы быть по крайней мере так же большим, как старый файл. Иногда добавляется дополнительное заполнение в виде комментариев, чтобы убедиться, что результирующий файл достаточно большой, а затем файл усекается, чтобы удалить заполнение в конце.

Возврат

Простой строковый ответ: OK при правильной перезаписи конфигурации. В противном случае возвращается ошибка.