메인 콘텐츠로 건너뛰기
지정된 입력 형식에 따라 인수의 데이터를 파싱합니다. 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 │
└───────┴─────┘
마지막 수정일 2026년 6월 10일