Проектная лаборатория
Собственная Kafka
Этап 25 · Отправка сообщений
Запись в несколько разделов нескольких топиков
Русский перевод заданий CodeCrafters. Примеры подготовлены для Go. Выбор языка меняет команды и результаты, но не текст задания.
На этом этапе вы реализуете запись в несколько разделов нескольких топиков.
Запись в несколько разделов нескольких топиков
Получив запрос Produce для нескольких разделов нескольких топиков, брокер Kafka должен проверить существование всех топиков и разделов, независимо записать данные в файл журнала каждого раздела и вернуть ответ с результатами для всех топиков и разделов.
Мы создали интерактивный обозреватель структуры запросов и ответов Produce:
Тесты
Тестирующая система запустит вашу программу следующим образом:
$ ./your_program.sh /tmp/server.propertiesЗатем подключится к серверу на порту 9092 и отправит запрос Produce (v11) для нескольких разделов нескольких топиков. В запросе будет несколько RecordBatch — по одному для каждого раздела каждого топика. Каждый RecordBatch содержит одну запись.
Она проверит, что:
- Первые 4 байта ответа («длина сообщения») корректны.
- Идентификатор корреляции в заголовке ответа совпадает с идентификатором в заголовке запроса.
- Поле
throttle_time_msответа равно0. - Поле
topicsсодержит несколько элементов — по одному для каждого топика из запроса. В каждом элементе:- Поле
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 go2. Откройте папку в IDE
cd ./my-kafkaРеализуйте требования этапа в созданном проекте.
Запустите из папки проекта
node '/opt/graphlms/tools/project-lab/cli.mjs' submit --stage ov0Запускайте submit из папки проекта. Это локальные проверки, а не сертификаты или результаты аккаунта CodeCrafters.
Результат проверки
go / ЛОКАЛЬНОПодключение к локальной проверке…
Здесь появится результат
Запустите submit в терминале. Страница обновляет результаты каждые 8 секунд.