BGREWRITEAOF

BGREWRITEAOF

BGREWRITEAOF

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

1.0.0

Сложность вычислений:

O(1)

Категории ACL:

@admin, @slow, @dangerous,

Инструктирует Redis начать процесс переписывания файла журнала добавления (Append Only File). Переписывание создаст оптимизированную версию текущего файла журнала добавления.

Если BGREWRITEAOF завершится неудачно, данные не потеряются, так как старый файл AOF останется без изменений.

Переписывание будет инициировано Redis только в том случае, если в данный момент другой фоновый процесс не выполняет сохранение.

Более конкретно:

• Если дочерний процесс Redis создает снимок на диске, переписывание файла AOF планируется, но не запускается до завершения сохранения дочернего процесса, генерирующего файл RDB. В этом случае команда BGREWRITEAOF всё равно вернёт положительный ответ, но с соответствующим сообщением. Проверить, запланировано ли переписывание AOF, можно с помощью команды INFO начиная с Redis 2.6 или более поздних версий.
• Если переписывание AOF уже выполняется, команда возвращает ошибку, и переписывание AOF не будет запланировано на более позднее время.
• Если переписывание AOF может начаться, но попытка его запуска завершается ошибкой (например, из-за ошибки при создании дочернего процесса), вызывающей стороне возвращается ошибка.

Начиная с Redis 2.4 переписывание AOF автоматически запускается Redis, однако команду BGREWRITEAOF можно использовать для запуска переписывания в любое время.

Для получения подробной информации обратитесь к документации по сохранению.

Возвращаемое значение

Простой строковый ответ: Простая строка, указывающая, что переписывание началось или начнётся как можно скорее после выполнения вызова при успешном исполнении.

В некоторых случаях команда может вернуть ошибку, как описано выше.