Перейти к основному содержимому

Изменение состояния потока

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

Есть удаление одного сообщения и массовая очистка. Оба сохраняют конфигурацию, потребителей и нумерацию. Разберём поведение номеров.

Удаление одного сообщения​

Укажите номер, полученный в PubAck:

#!/bin/bash
# Remove one stored message by its sequence number. `nats stream rmm` securely
# erases it: the server overwrites the stored bytes so the old contents can't
# be read back. It asks for confirmation first; add --force to skip the prompt.
nats stream rmm ORDERS 2

rmm означает remove message. Команда спрашивает Really remove message 2 from Stream ORDERS; --force пропускает вопрос в скрипте.

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

Библиотеки дают выбор: DeleteMsg(seq) дёшево помечает удаление, оставляя байты до перезаписи; SecureDeleteMsg(seq) сразу перезаписывает и медленнее. Различие — no_erase запроса; см. справочник.

Очистка потока​

Для всех сообщений:

#!/bin/bash
# Clear every message from ORDERS. The stream itself stays — same config, same
# consumers, same name — only the messages go. It asks for confirmation first;
# add --force to skip the prompt in a script.
nats stream purge ORDERS

Вывод Purged N messages from ORDERS сообщает количество. Есть подтверждение и --force. Имя, конфигурация и потребители остаются. nats stream rm ORDERS, напротив, удаляет весь объект вместе с ними.

Три флага сужают очистку:

#!/bin/bash
# A bare purge removes everything. Three optional flags narrow it.

# Remove only the shipped events, leave everything else.
nats stream purge ORDERS --subject orders.shipped

# Remove everything up to but not including sequence 100 (keep 100 onward).
nats stream purge ORDERS --seq 100

# Keep only the most recent 50 messages.
nats stream purge ORDERS --keep 50

--subject выбирает тему, --seq удаляет старше номера, --keep сохраняет заданное число последних. Последние два несовместимы друг с другом, но каждый сочетается с темой.

Номера не заполняют пробелы​

Удалённый 2 оставляет 1 и 3 прежними. Перенумерации и повторного использования нет.

Как обещала публикация, номера только растут. После полной очистки следующий не 1, а прежний последний плюс один: первый номер пустого потока устанавливается за последним.

Потребители пропускают отсутствующие записи, не ждут и не повторяют удалённый 2.

Сохранённая ссылка «ord_8w2k по номеру 2» всегда указывает либо на тот же заказ, либо ни на что, но не на другой.

Ручное и автоматическое удаление​

Здесь действия намеренно выполняет человек. Автоматические механизмы:

Delete и purge — разовые операции; ограничения и TTL — постоянная политика.

Типичные ошибки​

Ошибки ручных действий:

Purge очищает, rm уничтожает. Первая оставляет готовый поток, вторая удаляет конфигурацию и всех потребителей. Проверяйте вопрос подтверждения.

Удаление не перенумеровывает. Не предполагайте непрерывные 1..N, не вычисляйте следующий как count + 1 и не приравнивайте количество к максимальному номеру. Номер — стабильный адрес с возможным отсутствием данных.

Очистку нельзя отменить. Для важных данных включите DenyPurge и сохраняйте зеркало. DenyPurge необратим: отключение отвергается, для очистки потребуется пересоздание. Проверяйте на временном потоке, не ORDERS.

# Guard a stream so purge requests are refused
nats stream add GUARDED --subjects "guarded.>" --defaults
nats stream edit GUARDED --deny-purge

# A purge now fails instead of silently emptying the stream
nats stream purge GUARDED

Что уже готово​

Вы умеете удалять через nats stream rmm и nats stream purge с --subject, --seq, --keep. Номера растут, пробелы не заполняются.

После полной очистки заново опубликуйте заказы для следующей страницы. Они получат новые большие номера вместо 1, 2, 3. Конфигурация и потребители прежние.

Что дальше​

Содержимым одного сервера вы управляете. Теперь рассмотрим потерю самого сервера.

См. также​