RowBinary

Вход	Выход	Псевдоним
✔	✔

Описание

Формат RowBinary обрабатывает данные построчно в двоичном формате. Строки и значения перечислены последовательно, без разделителей. Поскольку данные находятся в двоичном формате, разделитель после FORMAT RowBinary строго указан следующим образом:

• Любое количество пробелов:
  • ' ' (пробел - код 0x20)
  • '\t' (табуляция - код 0x09)
  • '\f' (первая страница - код 0x0C)
• За которым следует ровно одна последовательность новой строки:
  • Стиль Windows "\r\n"
  • или стиль Unix '\n'
• Сразу за которым следуют двоичные данные.

примечание

Этот формат менее эффективен, чем формат Native, поскольку он основан на строках.

Для следующих типов данных важно отметить, что:

• Целые числа используют представление фиксированной длины little-endian. Например, UInt64 использует 8 байт.
• DateTime представлен как UInt32, содержащий значение Unix timestamp.
• Дата представлена как объект UInt16, который содержит количество дней с даты 1970-01-01.
• Строка представлена как целое число переменной длины (varint) (без знака LEB128), за которым следуют байты строки.
• FixedString представлена просто как последовательность байтов.
• Массивы представлены как целое число переменной длины (varint) (без знака LEB128), за которым следуют последовательные элементы массива.

Для поддержки NULL перед каждым значением Nullable добавляется дополнительный байт, содержащий 1 или 0.

• Если 1, тогда значение является NULL, и этот байт интерпретируется как отдельное значение.
• Если 0, тогда значение после байта не является NULL.

Для сравнения формата RowBinary и формата RawBlob смотрите: Сравнение сырых форматов

Пример использования

Настройки формата

Следующие настройки общие для всех форматов типа RowBinary.

Настройка	Описание	По умолчанию
format_binary_max_string_size	Максимально допустимый размер для строки в формате RowBinary.	1GiB
output_format_binary_encode_types_in_binary_format	Позволяет записывать типы в заголовке, используя binary encoding вместо строк с именами типов в формате вывода RowBinaryWithNamesAndTypes.	false
input_format_binary_decode_types_in_binary_format	Позволяет читать типы в заголовке, используя binary encoding вместо строк с именами типов в формате ввода RowBinaryWithNamesAndTypes.	false
output_format_binary_write_json_as_string	Позволяет записывать значения типа JSON как JSON String в формате вывода RowBinary.	false
input_format_binary_read_json_as_string	Позволяет читать значения типа JSON как JSON String в формате ввода RowBinary.	false