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

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

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

Этап 24 · Отправка сообщений

Запись в несколько разделов

Русский перевод заданий CodeCrafters. Примеры подготовлены для Go. Выбор языка меняет команды и результаты, но не текст задания.

На этом этапе вы реализуете запись в несколько разделов одного топика.

Запись в несколько разделов

Получив запрос Produce для нескольких разделов одного топика, брокер Kafka должен проверить существование топика и всех разделов, независимо записать данные в файл журнала каждого раздела и вернуть ответ с результатами для всех разделов.

Мы создали интерактивный обозреватель структуры запросов и ответов Produce:

Тесты

Тестирующая система запустит вашу программу следующим образом:

$ ./your_program.sh /tmp/server.properties

Затем подключится к серверу на порту 9092 и отправит запрос Produce (v11) для нескольких разделов одного топика. В запросе будет несколько RecordBatch — по одному для каждого раздела. Каждый RecordBatch содержит одну запись.

Она проверит, что:

  • Первые 4 байта ответа («длина сообщения») корректны.
  • Идентификатор корреляции в заголовке ответа совпадает с идентификатором в заголовке запроса.
  • Поле throttle_time_ms ответа равно 0.
  • Поле topics содержит 1 элемент, в котором:
    • Поле name совпадает с именем топика в запросе.
    • Поле partitions содержит несколько элементов — по одному для каждого раздела из запроса. В каждом элементе:
      • Поле 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 ct4

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

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

go / ЛОКАЛЬНО

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

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

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

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