Проектная лаборатория

Собственная Kafka

0 / 25этапов пройдено

Этап 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 go

2. Откройте папку в IDE

cd ./my-kafka

Реализуйте требования этапа в созданном проекте.

Запустите из папки проекта

node '/opt/graphlms/tools/project-lab/cli.mjs' submit --stage yd8

Запускайте submit из папки проекта. Это локальные проверки, а не сертификаты или результаты аккаунта CodeCrafters.

Результат проверки

go / ЛОКАЛЬНО

Подключение к локальной проверке…

Здесь появится результат

Запустите submit в терминале. Страница обновляет результаты каждые 8 секунд.

GraphLMS — инженерная лаборатория роста