Изменение состояния потока
Пределы удаляют автоматически, но иногда нужно убрать ошибочную запись издателя или очистить данные перед новым тестом вручную.
Есть удаление одного сообщения и массовая очистка. Оба сохраняют конфигурацию, потребителей и нумерацию. Разберём поведение номеров.
Удаление одного сообщения
Укажите номер, полученный в PubAck:
- CLI
- C
#!/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
// Remove the message stored at sequence 2 from ORDERS. This marks
// it erased but leaves the stored bytes in place until they are
// later overwritten, which is cheap.
s = js_DeleteMsg(js, "ORDERS", 2, NULL, &jerr);
if (s == NATS_OK)
printf("Deleted message 2 from ORDERS\n");
// For a message that held data it shouldn't have, use js_EraseMsg
// instead: the server overwrites the stored bytes right away, the
// way `nats stream rmm` does, so the old contents can't be read
// back. It is slower for it.
//
// s = js_EraseMsg(js, "ORDERS", 2, NULL, &jerr);
rmm означает remove message. Команда спрашивает Really remove message 2 from Stream ORDERS; --force пропускает вопрос в скрипте.
CLI безопасно перезаписывает байты, чтобы прежнее содержимое, например случайно сохранённый номер карты, нельзя было прочитать.
Библиотеки дают выбор: DeleteMsg(seq) дёшево помечает удаление, оставляя байты до перезаписи; SecureDeleteMsg(seq) сразу перезаписывает и медленнее. Различие — no_erase запроса; см. справочник.
Очистка потока
Для всех сообщений:
- CLI
- C
#!/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
// Clear every message from ORDERS. The stream itself stays -- same
// config, same consumers, same name -- only the messages go.
s = js_PurgeStream(js, "ORDERS", NULL, &jerr);
if (s == NATS_OK)
printf("Purged ORDERS\n");
Вывод Purged N messages from ORDERS сообщает количество. Есть подтверждение и --force. Имя, конфигурация и потребители остаются. nats stream rm ORDERS, напротив, удаляет весь объект вместе с ними.
Три флага сужают очистку:
- CLI
- C
#!/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
// A bare purge removes everything. Three optional purge options
// narrow it.
jsOptions o;
// Remove only the shipped events, leave everything else.
jsOptions_Init(&o);
o.Stream.Purge.Subject = "orders.shipped";
s = js_PurgeStream(js, "ORDERS", &o, &jerr);
// Remove everything up to but not including sequence 100
// (keep 100 onward).
jsOptions_Init(&o);
o.Stream.Purge.Sequence = 100;
if (s == NATS_OK)
s = js_PurgeStream(js, "ORDERS", &o, &jerr);
// Keep only the most recent 50 messages.
jsOptions_Init(&o);
o.Stream.Purge.Keep = 50;
if (s == NATS_OK)
s = js_PurgeStream(js, "ORDERS", &o, &jerr);
--subject выбирает тему, --seq удаляет старше номера, --keep сохраняет заданное число последних. Последние два несовместимы друг с другом, но каждый сочетается с темой.
Номера не заполняют пробелы
Удалённый 2 оставляет 1 и 3 прежними. Перенумерации и повторного использования нет.
Как обещала публикация, номера только растут. После полной очистки следующий не 1, а прежний последний плюс один: первый номер пустого потока устанавливается за последним.
Потребители пропускают отсутствующие записи, не ждут и не повторяют удалённый 2.
Сохранённая ссылка «ord_8w2k по номеру 2» всегда указывает либо на тот же заказ, либо ни на что, но не на другой.
Ручное и автоматическое удаление
Здесь действия намеренно выполняет человек. Автоматические механизмы:
- Настройка потока — MaxAge, MaxBytes, MaxMsgs, Discard.
- TTL сообщений — индивидуальный срок.
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. Конфигурация и потребители прежние.
Что дальше
Содержимым одного сервера вы управляете. Теперь рассмотрим потерю самого сервера.
См. также
- Очистка потока — filter, seq, keep.
- Удаление сообщения — no_erase.
- Настройка потока — автоматические пределы.