Явная договорённость между источником и потребителем: какие поля, каких типов и с какими гарантиями.
Ключевые тезисы
- Контракт описывает схему, семантику полей, SLA по свежести и правила изменения.
- Обратно совместимые изменения (добавление поля) разрешены, ломающие — только через версию.
- Реестр схем (Schema Registry) делает контракт исполняемым, а не документом на вики.
Подробный разбор
2 подтем — раскройте любую, чтобы увидеть объяснение, формулы, примеры и интерактивные графики.
1Что входит в контракт
Договорённость, которую можно проверить автоматически.
- Схема: поля, типы, обязательность, допустимые значения.
- Семантика: что именно означает поле и в каких единицах.
- SLA: частота обновления, максимальная задержка, ожидаемый объём.
- Правила изменения: что считается обратно совместимым, а что требует новой версии.
- Владелец: кто отвечает за источник и кому писать при поломке.
2Как заставить контракт работать
Документ на вики контрактом не является.
- Схема описывается машиночитаемо (Avro/Protobuf/JSON Schema) и лежит в реестре.
- Продюсер валидирует данные при записи, а не потребитель при чтении.
- CI источника падает при ломающем изменении схемы.
- Нарушения контракта видны на дашборде и имеют владельца.
Для ML контракт особенно важен: модель зависит от распределения признаков, а не только от их наличия. Поэтому в контракт полезно включать и ожидаемые статистики.
Связанные темы
Надёжность данных · Безопасность и приватность ML
Data Quality85%
Качество данных · Инженерия данныхАвтоматические проверки, которые ловят поломку источника раньше, чем она попадёт в модель.
Idempotency & Exactly-once85%
Идемпотентность и гарантии доставки · Инженерия данныхЧто происходит при повторной обработке события и как не задвоить данные.
Change Data Capture85%
Захват изменений (CDC) · Инженерия данныхЧтение журнала изменений базы вместо периодических полных выгрузок.
Feature Stores85%
Хранилища признаков · MLOpsЦентрализованное хранилище признаков, единое для обучения и онлайн-инференса.
Data leakage85%
Утечка данных · ДанныеСитуация, когда в обучении присутствует информация, недоступная в момент реального предсказания. Главная причина «слишком хороших» метрик.
Data leakage85%
Утечка данных · Практика MLСамая дорогая ошибка в ML: модель отлично работает офлайн и разваливается в проде.
Data preprocessing85%
Предобработка данных · ДанныеПриведение сырых данных к виду, пригодному для обучения: типы, форматы, дубликаты, согласованность единиц измерения.
Privacy and Security70%
Приватность и безопасность · Системный дизайн ML-сервисовПерсональные данные, доступы и специфические для ML риски.
Agents70%
Агенты · Генеративный ИИLLM, которая планирует, вызывает инструменты и итеративно движется к цели.
Prompting70%
Промптинг · Генеративный ИИУправление поведением модели через формулировку запроса, без изменения весов.
Monitoring70%
Мониторинг · MLOpsНаблюдение за инфраструктурой, данными и качеством предсказаний после релиза.