# Политики потоков и потребителей

**Политика** — поле с выбором из фиксированного списка, отвечающее за один аспект поведения. Соберём девять политик, встречавшихся в ORDERS.

У всех есть пригодное для начала значение по умолчанию. Пять фиксируются при создании: смена требует пересоздания. Таблицы ниже показывают какие.

## Политики потока

Их пять.

**Retention** — причины удаления. limits оставляет до пределов, interest и workqueue удаляют после ack. ORDERS — limits, FULFILLMENT — workqueue. См. [Политики хранения](/learn/jetstream/retention-policies.md).

**Discard** — действие при заполнении: old удаляет старое, new отклоняет новое. ORDERS использует old; см. [Настройка потока](/learn/jetstream/shaping-the-stream.md).

**Storage** — file на диске с переживанием рестарта, memory в RAM, быстрее и без сохранения после рестарта. Одинакова для всех реплик; см. [Отказ узла](/learn/jetstream/surviving-node-loss.md).

**Compression** здесь не требовалась. s2 вместо none сжимает файловые блоки за CPU. JSON сжимается хорошо, изображения обычно уже сжаты. `--compression s2` задаётся при создании. Изменение разрешено, но вступает после перезапуска хранилища или смены лидера; старые блоки прежние.

**Persist mode** — момент PubAck относительно записи. По умолчанию сначала сброс в хранилище, затем ответ. async подтверждает до фоновой записи, повышая скорость с риском потери подтверждённого хвоста. Подходит метрикам, не заказам. Разрешён только File с одной репликой и несовместим с [атомарными пакетами](/learn/jetstream/advanced-publishing.md).

Все поля — в [Конфигурации потока](/reference/jetstream/api/stream/create.md).

## Политики потребителя

Их четыре.

**Deliver policy** — начало при создании. all, стандарт billing, начинает с первого. last — с последнего и далее живые. new — только поступившие после создания. by\_start\_sequence и by\_start\_time задают номер и время (`--deliver 1000`, `--deliver 1h`). last\_per\_subject начинает с последнего каждой подходящей темы и лежит в основе [KV watch](/learn/key-value/.md). Это не одноимённый флаг разового [Direct Get](/learn/jetstream/get-direct.md).

**Ack policy** — критерий обработки: explicit у shipping, также none, all, flow\_control. См. [Виды подтверждений](/learn/jetstream/acknowledgment.md).

**Replay policy** — скорость. instant отдаёт по готовности читателя, original сохраняет исходные интервалы, включая долгое молчание. См. [Чтение потока](/learn/jetstream/reading-back.md).

**Priority policy** — выбор клиента. none обслуживает поступившие pull, overflow, pinned\_client и prioritized задают предпочтения. См. [Группы приоритетов](/learn/jetstream/priority-groups.md).

Поля и начала чтения — в [Конфигурации потребителя](/reference/jetstream/api/consumer/create.md).

## Что можно изменить

Пять политик фиксируются при создании:

| Политика потока | Изменение                                                         |
| --------------- | ----------------------------------------------------------------- |
| Retention       | limits ↔ interest с воздействием на историю; workqueue неизменяем |
| Discard         | разрешено                                                         |
| Storage         | запрещено                                                         |
| Compression     | после рестарта хранилища или лидера                               |
| Persist mode    | запрещено                                                         |

| Политика потребителя | Изменение                                   |
| -------------------- | ------------------------------------------- |
| Deliver              | запрещено                                   |
| Ack                  | запрещено                                   |
| Replay               | запрещено                                   |
| Priority             | через `--config`, отдельного флага edit нет |

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

**Смена фиксированной политики требует пересоздания.** Ошибки: `stream configuration update can not change storage type`, `deliver policy can not be updated`. Потоку потребуется перенос данных; [зеркало](/learn/jetstream/mirrors-and-sources.md) только читает и для превращения в основной нужны отдельные шаги. Потребитель потеряет прежнюю позицию и начнёт по новой Deliver policy. Решайте заранее.

**New не пропускает очередь при каждом рестарте.** Начало определяется один раз. Долговременный потребитель затем возобновляет сохранённую позицию с накопленным, не прыгает к живому трафику.

**Два last per subject.** Политика задаёт начало продолжающегося чтения; Direct Get делает один снимок без потребителя. Проверяйте контекст.

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

ORDERS и потребители прежние. Вы знаете:

* Девять политик и страницы применения.
* Compression и Persist mode, не понадобившиеся ORDERS.
* Пять фиксированных и ошибки попытки изменения.

## Что дальше

[Куда двигаться дальше](/learn/jetstream/where-next.md) подводит итоги модели.

## См. также

* [Конфигурация потока](/reference/jetstream/api/stream/create.md) — поля и значения.
* [Конфигурация потребителя](/reference/jetstream/api/consumer/create.md) — поля и значения.
