format

Разбирает данные из аргументов согласно указанному входному формату. Если аргумент structure не указан, структура извлекается из данных.

Разбирает данные из аргументов согласно указанному входному формату. Если аргумент structure не указан, структура извлекается из данных.

​

Синтаксис

format(format_name, [structure], data)

​

Аргументы

• format_name — формат данных.
• structure - Структура таблицы. Необязательный параметр. Формат: ‘column1_name column1_type, column2_name column2_type, …’.
• data — Строковый литерал или константное выражение, возвращающее строку с данными в указанном формате

​

Возвращаемое значение

Таблица с данными, полученными при разборе аргумента data в соответствии с указанным форматом и указанной или извлечённой структурой.

​

Примеры

Без аргумента structure:

Query

SELECT * FROM format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)

Response

┌───b─┬─a─────┐
│ 111 │ Hello │
│ 123 │ World │
│ 112 │ Hello │
│ 124 │ World │
└─────┴───────┘

Query

DESC format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)

Response

┌─name─┬─type──────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ b    │ Nullable(Float64) │              │                    │         │                  │                │
│ a    │ Nullable(String)  │              │                    │         │                  │                │
└──────┴───────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘

С аргументом structure:

Query

SELECT * FROM format(JSONEachRow, 'a String, b UInt32',
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)

Response

┌─a─────┬───b─┐
│ Hello │ 111 │
│ World │ 123 │
│ Hello │ 112 │
│ World │ 124 │
└───────┴─────┘

​

См. также

• Форматы