본문으로 바로가기
본문으로 바로가기

JSON 포맷을 위한 포맷 설정

이 페이지에서는 모든 JSON 포맷에 공통으로 사용되는 포맷 설정을 확인할 수 있습니다.

설정설명기본값비고
input_format_import_nested_json중첩 JSON 데이터를 중첩 테이블에 매핑합니다(JSONEachRow 포맷에서 동작합니다).false
input_format_json_read_bools_as_numbersJSON 입력 포맷에서 bool 값을 숫자로 파싱하는 것을 허용합니다.true
input_format_json_read_bools_as_stringsJSON 입력 포맷에서 bool 값을 문자열로 파싱하는 것을 허용합니다.true
input_format_json_read_numbers_as_stringsJSON 입력 포맷에서 숫자를 문자열로 파싱하는 것을 허용합니다.true
input_format_json_read_arrays_as_stringsJSON 입력 포맷에서 JSON 배열을 문자열로 파싱하는 것을 허용합니다.true
input_format_json_read_objects_as_stringsJSON 입력 포맷에서 JSON 객체를 문자열로 파싱하는 것을 허용합니다.true
input_format_json_named_tuples_as_objects이름이 있는 튜플 컬럼을 JSON 객체로 파싱합니다.true
input_format_json_try_infer_numbers_from_strings스키마 추론 시 문자열 필드에서 숫자 타입을 추론하려고 시도합니다.false
input_format_json_try_infer_named_tuples_from_objects스키마 추론 시 JSON 객체에서 이름이 있는 튜플을 추론하려고 시도합니다.true
input_format_json_infer_incomplete_types_as_stringsJSON 입력 포맷에서 스키마 추론 시 Null 또는 비어 있는 객체/배열만 포함하는 키에 대해 String 타입을 사용합니다.true
input_format_json_defaults_for_missing_elements_in_named_tuple이름이 있는 튜플을 파싱할 때 JSON 객체에서 누락된 요소에 기본값을 삽입합니다.true
input_format_json_ignore_unknown_keys_in_named_tuple이름이 있는 튜플의 경우 JSON 객체에서 알 수 없는 키를 무시합니다.false
input_format_json_compact_allow_variable_number_of_columnsJSONCompact/JSONCompactEachRow 포맷에서 컬럼 개수를 가변적으로 허용하며, 초과 컬럼은 무시하고 누락된 컬럼에는 기본값을 사용합니다.false
input_format_json_throw_on_bad_escape_sequenceJSON 문자열에 잘못된 이스케이프 시퀀스가 포함된 경우 예외를 발생시킵니다. 비활성화된 경우, 잘못된 이스케이프 시퀀스는 데이터에서 그대로 유지됩니다.true
input_format_json_empty_as_defaultJSON 입력에서 비어 있는 필드를 기본값으로 처리합니다.false복잡한 기본값 표현식을 사용하려면 input_format_defaults_for_omitted_fields 설정도 함께 활성화해야 합니다.
output_format_json_quote_64bit_integersJSON 출력 포맷에서 64비트 정수의 따옴표 처리 방식을 제어합니다.true
output_format_json_quote_64bit_floatsJSON 출력 포맷에서 64비트 부동소수점 수의 따옴표 처리 방식을 제어합니다.false
output_format_json_quote_denormalsJSON 출력 포맷에서 '+nan', '-nan', '+inf', '-inf' 출력이 가능하도록 활성화합니다.false
output_format_json_quote_decimalsJSON 출력 포맷에서 Decimal 값의 따옴표 처리 방식을 제어합니다.false
output_format_json_escape_forward_slashesJSON 출력 포맷에서 문자열 출력 시 슬래시(/) 이스케이프 처리 방식을 제어합니다.true
output_format_json_named_tuples_as_objects이름이 있는 튜플 컬럼을 JSON 객체로 직렬화합니다.true
output_format_json_array_of_rowsJSONEachRow(Compact) 포맷에서 모든 행을 하나의 JSON 배열로 출력합니다.false
output_format_json_validate_utf8JSON 출력 포맷에서 UTF-8 시퀀스 검증을 활성화합니다.false이 설정은 JSON/JSONCompact/JSONColumnsWithMetadata 포맷에는 영향을 주지 않으며, 이들 포맷은 항상 UTF-8을 검증합니다.