跳转到主内容
跳转到主内容

format

根据指定的输入格式从参数中解析数据。如果未指定 structure 参数，则从数据中提取该结构。

语法​

format(format_name, [structure], data)

参数​

  • format_name — 数据的格式。
  • structure - 表结构。可选。格式为 'column1_name column1_type, column2_name column2_type, ...'。
  • data — 字符串字面量或返回一个按指定格式组织的数据字符串的常量表达式。

返回值​

一个数据表，包含根据指定格式和指定或提取的结构从 data 参数中解析得到的数据。

示例​

不带 structure 参数：

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

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

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

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

使用 structure 参数：

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

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