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