Хранилище объектов
NATS предоставляет место для хранения файлов без отдельного сервиса. Объект — сохранённый файл: PDF счёта, этикетка отправления, упаковочный лист — всё слишком крупное или двоичное для обычного сообщения. Бакет — именованное хранилище таких объектов. Оба находятся в одном потоке JetStream с именем OBJ_<bucket>, на том же слое долговременного хранения из углублённого курса JetStream.
Помните об этом с самого начала. При put хранилище разбивает байты на фрагменты, записывает каждый сообщением, затем добавляет одно сообщение метаданных всего объекта. При get оно читает метаданные, воспроизводит фрагменты по порядку и проверяет их перед возвратом байтов. В повседневной работе вы используете удобное API (put, get, list, watch, link), а работу обеспечивает базовый поток.
Сначала глава объясняет абстракцию объекта, а в конце раскрывает поток. Первые четыре страницы знакомят с API хранилища без необходимости заново изучать внутренности JetStream. Страница Внутреннее устройство показывает поток OBJ_INVOICES, существовавший всё время.
Сравните его с соседним хранилищем. Хранилище ключей и значений сохраняет небольшие структурированные значения и историю ревизий каждого ключа. Хранилище объектов предназначено для крупных файлов из фрагментов и сохраняет лишь последние метаданные объекта, то есть текущую версию, а не историю. KV подходит для множества небольших значений, которые нужно читать, перезаписывать и проверять по истории; объекты — для целых файлов, которые записывают и получают.
Что получится к концу главы
- Бакет
INVOICESс описанием «Invoice PDFs», куда сервисorder-svcпомещает счета после подтверждения оплаты. - Сохранённый и прочитанный обратно счёт
invoice-ord_8w2k.pdf, для которого хранилище вычисляет и проверяет хеш SHA-256, подтверждая совпадение записанных и полученных байтов. - Счёт размером 3 МБ,
invoice-ord_9x3m.pdf, разбитый на множество фрагментов и собранный при чтении; понимание размера фрагмента, ограничивающего каждое сообщение. - Счёт с описанием, заголовком
content-typeи произвольными метаданными, а также объектlabel-ord_8w2k.png, связанный с ним ссылкой, прозрачно разрешаемой при get. - Сервис
analytics, получающий список объектов как снимок и наблюдающий за новыми объектами в реальном времени. - Понимание потока
OBJ_INVOICES: темы фрагментов и метаданных, свёртка для хранения только последних метаданных и смысл мягкого удаления.
Для кого эта глава
Вы прочитали углублённый курс JetStream или введение Основные концепции → JetStream и уже понимаете, что поток хранит сообщения. Здесь не объясняются заново потоки, позиции потребителей и подтверждения. При необходимости глава обозначает нужный механизм и ссылается на JetStream.
Специальные знания о хранилище объектов не требуются. Начнём с того, что такое бакет и зачем он нужен.
Как читать главу
Каждая страница вводит не более двух новых понятий и опирается на предыдущую. Один бакет INVOICES используется всю главу; можно держать один терминал открытым без сброса состояния. На странице Первый объект вы создадите бакет и сохраните счёт, в разделе Разбиение на фрагменты запишете крупный счёт, в разделе Метаданные и ссылки добавите метаданные и ссылку, в разделе Наблюдение и список объектов перечислите объекты и начнёте наблюдение, затем изучите внутреннее устройство.
У хранилища много настроек: размер фрагментов, реплики, сжатие и все поля протокола. При длинном списке страница объясняет лишь необходимое для понимания. Полный перечень находится в справочнике; здесь важно поведение.
Содержание
| Страница | Что вы узнаете |
|---|---|
| Первый объект | Создание INVOICES, запись invoice-ord_8w2k.pdf и чтение с проверкой хеша |
| Разбиение на фрагменты | Хранение счёта на 3 МБ во множестве фрагментов и просмотр их числа |
| Метаданные и ссылки | Описание, заголовки, произвольные метаданные и ссылка одного объекта на другой |
| Наблюдение и список объектов | Список как снимок и текущие обновления объектов |
| Внутреннее устройство | Поток OBJ_INVOICES, темы фрагментов и метаданных, свёртка и мягкое удаление |
| Куда двигаться дальше | Возможности за пределами объектов и проверки перед эксплуатацией |
Предварительные требования
Вам понадобятся:
- Работающий
nats-serverс включённым JetStream, на котором построено хранилище объектов. Проще всего запуститьnats-server -js. - Установленный CLI
nats, подключённый к вашему серверу. Большинство операций выполняется через него; некоторые, например создание ссылки, доступны лишь через клиентские библиотеки.
Откройте терминал, выполните nats-server -js и переходите к следующей странице.