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

Хранилище ключей и значений

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 и переходите к первой странице.