Политики проверки совместимости
Политика проверки совместимости — это совокупность правил, по которым Yandex Schema Registry проверяет совместимость новой схемы с предыдущими на уровне пространства имен.
Вы можете выбрать политику проверки совместимости схем при создании или изменении пространства имен. Политики проверки совместимости доступны для схем Protobuf и JSON Schema.
Политики совместимости Protobuf-схем
Для Protobuf-схем доступны следующие политики:
-
Confluent — основывается на рекомендованных методах эволюции схем Protobuf. Подробнее об эволюции схем см. в документации Protobuf.
-
buf — основывается на стандартах Buf v1. Подробнее о применяемых проверках см. в спецификации.
Политики совместимости JSON-схем
Для JSON-схем доступны следующие политики:
-
Confluent — основывается на стандартах Confluent Schema Registry и реализует математически точную проверку совместимости. Такая политика не позволяет добавлять и удалять опциональные параметры в полях типа
object. В отдельных случаях, например при работе с очередями, это ограничение может быть избыточным. -
Optional Friendly — основывается на решении с использованием разных контентных моделей для производителя и потребителя. В данном случае регистрируется только схема для производителя. Для проверки совместимости схема потребителя конвертируется из открытой контентной модели в закрытую и сравнивается с зарегистрированными схемами производителя. Это позволяет поддерживать добавление и удаление опциональных параметров, сохраняя полную транзитивную совместимость.