Проектная лаборатория
Собственная Kafka
Этап 23 · Отправка сообщений
Запись нескольких записей
Русский перевод заданий CodeCrafters. Примеры подготовлены для Go. Выбор языка меняет команды и результаты, но не текст задания.
На этом этапе вы реализуете сохранение нескольких записей в одном запросе.
Сохранение нескольких записей
Получив запрос Produce с RecordBatch, содержащим несколько записей, брокер Kafka должен проверить существование топика и раздела, назначить последовательные смещения каждой записи пакета и сохранить весь пакет в файл журнала. RecordBatch с несколькими записями должен быть сохранён как единое целое в файл журнала топика <log-dir>/<topic-name>-<partition-index>/00000000000000000000.log.
Мы создали интерактивный обозреватель структуры запросов и ответов Produce:
Тесты
Тестирующая система запустит вашу программу следующим образом:
$ ./your_program.sh /tmp/server.propertiesЗатем подключится к серверу на порту 9092 и отправит запрос Produce (v11) с RecordBatch, содержащим несколько записей.
Она проверит, что:
- Первые 4 байта ответа («длина сообщения») корректны.
- Идентификатор корреляции в заголовке ответа совпадает с идентификатором в заголовке запроса.
- Поле
throttle_time_msответа равно0. - Поле
topicsсодержит 1 элемент, в котором:- Поле
nameсовпадает с именем топика в запросе. - Поле
partitionsсодержит 1 элемент, в котором:- Поле
error_codeравно0(NO_ERROR). - Поле
indexсовпадает с разделом в запросе. - Поле
base_offsetравно 0 — базовому смещению пакета. - Поле
log_append_time_msравно-1, обозначая последнюю временную метку. - Поле
log_start_offsetравно0.
- Поле
- Поле
- Отправленный в запросе RecordBatch записан в
<log-dir>/<topic-name>-<partition-index>/00000000000000000000.log.
Примечания
- Файлы журнала на диске должны храниться в формате RecordBatch. Каждый
RecordBatchиз запроса нужно записать непосредственно в файл журнала соответствующего раздела топика. - Официальная документация API
Produceнаходится здесь. Прокрутите до раздела «(Version: 11)».
Проверка в вашей IDE
Нужны Node.js, Git, Go 1.24+ для тестеров и инструменты выбранного языка. Тестеры загружаются и запускаются локально; отдельным проектам нужны дополнительные системные зависимости.
Настройка проекта и IDE
1. Создайте проект один раз
node '/opt/graphlms/tools/project-lab/cli.mjs' init kafka ./my-kafka --language go2. Откройте папку в IDE
cd ./my-kafkaРеализуйте требования этапа в созданном проекте.
Запустите из папки проекта
node '/opt/graphlms/tools/project-lab/cli.mjs' submit --stage yd8Запускайте submit из папки проекта. Это локальные проверки, а не сертификаты или результаты аккаунта CodeCrafters.
Результат проверки
go / ЛОКАЛЬНОПодключение к локальной проверке…
Здесь появится результат
Запустите submit в терминале. Страница обновляет результаты каждые 8 секунд.