Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

format

View as MarkdownEdit this pageReport an issueSet up docs MCP

Analiza los datos de los argumentos según el formato de entrada especificado. Si no se especifica el argumento structure, este se extrae de los datos.

Sintaxis

format(format_name, [structure], data)

Argumentos

  • format_name — El formato de los datos.
  • structure - Estructura de la tabla. Opcional. Formato 'column1_name column1_type, column2_name column2_type, …'.
  • data — Literal de cadena o expresión constante que devuelve una cadena con datos en el formato especificado

Valor de retorno

Una tabla con datos interpretados a partir del argumento data según el formato especificado y la estructura especificada o extraída.

Ejemplos

Sin el argumento structure:

Querysql
SELECT * FROM format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
Responseresponse
┌───b─┬─a─────┐
│ 111 │ Hello │
│ 123 │ World │
│ 112 │ Hello │
│ 124 │ World │
└─────┴───────┘
Querysql
DESC format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
Responseresponse
┌─name─┬─type──────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ b    │ Nullable(Float64) │              │                    │         │                  │                │
│ a    │ Nullable(String)  │              │                    │         │                  │                │
└──────┴───────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘

Con el argumento structure:

Querysql
SELECT * FROM format(JSONEachRow, 'a String, b UInt32',
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
Responseresponse
┌─a─────┬───b─┐
│ Hello │ 111 │
│ World │ 123 │
│ Hello │ 112 │
│ World │ 124 │
└───────┴─────┘
Navigation