CapnProto — это формат бинарных сообщений, похожий на Protocol Buffers и Thrift, но не на JSON или MessagePack.
Сообщения CapnProto строго типизированы и не являются самоописываемыми, то есть требуют внешнего описания схемы. Схема применяется на лету и кэшируется для каждого запроса.
См. также Format Schema.
В таблице ниже показаны поддерживаемые типы данных и их соответствие типам данных ClickHouse в запросах INSERT и SELECT.
- Целочисленные типы можно преобразовывать друг в друга при вводе и выводе.
- Для работы с
Enumв формате CapnProto используйте настройку format_capn_proto_enum_comparising_mode. - Массивы могут быть вложенными и принимать в качестве аргумента значение типа
Nullable. ТипыTupleиMapтакже могут быть вложенными.
schema.capnp выглядит так:
CapnProto с помощью следующей команды:
CapnProto для ваших данных, вы всё равно можете выполнять вывод и ввод данных в формате CapnProto, используя автоматически сгенерированную схему.
Например:
format_capn_proto_use_autogenerated_schema включен по умолчанию и используется, если format_schema не задан.
Вы также можете сохранить автоматически сгенерированную схему в файл при вводе/выводе с помощью параметра output_format_schema.
Например:
CapnProto будет сохранена в файле path/to/schema/schema.capnp.