Хранилище ключей и значений
NATS предоставляет хранилище ключей и значений. Это не отдельная база данных: бакет — поток JetStream с именем KV_<bucket> и темами $KV.<bucket>.>; ключ — последний токен темы, а значение — сообщение в ней. Всё в этой главе представляет этот единственный поток через API ключей и значений.
Помните об этом с самого начала. Операция put добавляет сообщение, get читает последнее сообщение темы, а watch бакета открывает потребителя. В повседневной работе вы используете API (put, get, watch, create, update, TTL), а его работу обеспечивает лежащий в основе поток.
Сначала глава знакомит с абстракцией, а в конце раскрывает устройство потока. Первые четыре страницы объясняют API ключей и значений, чтобы вы могли работать без запоминания внутренностей JetStream. Страница Внутреннее устройство показывает поток, который API использовал всё это время.
Что получится к концу главы
- Бакет
INVENTORYс артикулами в качестве ключей (widget-blue,widget-red,gadget-pro) и остатками товара в качестве значений, которые сервис inventory читает и уменьшает. - Складская панель, наблюдающая за бакетом: сначала она получает снимок текущих значений всех ключей, затем изменения в реальном времени.
- Безопасное уменьшение
widget-blueс 41 до 40 через сравнение с заменой, чтобы одновременные продажи не теряли записи. - Ключ
flash-saleс собственным TTL, удаляющийся по истечении срока, и понимание общих лимитов бакета. - Ясное представление о потоке
KV_INVENTORY: темы, прямое чтение и различие удаления и очистки.
Для кого эта глава
Вы прочитали углублённый курс JetStream или введение Основные концепции → JetStream и уже понимаете, что поток хранит сообщения. Здесь не объясняются заново поток, позиция потребителя и подтверждения. Там, где нужны эти знания, глава указывает на них и ссылается на JetStream.
Специальные знания о хранилищах ключей и значений не требуются. Начнём с того, что такое бакет и зачем он нужен.
Как читать главу
Каждая страница вводит не более двух новых понятий и опирается на предыдущую. Один бакет INVENTORY используется на протяжении всей главы, поэтому можно держать один терминал открытым, не сбрасывая состояние. На странице Первый бакет вы создадите бакет, на странице Наблюдение добавите наблюдателя, в разделе История и ревизии безопасно уменьшите значение, в разделе TTL и лимиты зададите срок жизни ключа, а затем изучите внутреннее устройство.
У хранилища ключей и значений много настроек: лимиты бакета, параметры наблюдения и сетевые заголовки. При длинном списке страница объясняет лишь необходимое для понимания. Бакет создаётся как поток, поэтому полный набор параметров приведён в разделе Справочник → Создание потока.
Содержание
| Страница | Что вы узнаете |
|---|---|
| Первый бакет | Создание INVENTORY, запись и чтение widget-blue, просмотр состояния |
| Наблюдение | Получение снимка всех ключей и последующих изменений |
| История и ревизии | Ревизии, история и безопасное уменьшение через сравнение с заменой |
| TTL и лимиты | Автоматическое удаление ключа по TTL и общие ограничения бакета |
| Внутреннее устройство | Поток KV_INVENTORY, прямое чтение, удаление и очистка |
| Куда двигаться дальше | Возможности за пределами KV и проверки перед эксплуатацией |
Предварительные требования
Вам понадобятся:
- Работающий
nats-serverс включённым JetStream: хранилище ключей и значений построено на нём. Проще всего запуститьnats-server -js. - Установленный CLI
nats, подключённый к вашему серверу. Первая страница использует только CLI. Позднее появятся примеры тех же операций на JavaScript, Go, Python, Java, Rust и C#.
Откройте терминал, выполните nats-server -js и переходите к первой странице.