기타 포맷 설정

기타 포맷 설정 (other format settings)

이 페이지는 기타 그룹에 속한 자동 생성 포맷 설정을 다루는 문서예요. Enum 변환 검사, 스키마 추론 열 이름, 오류 출력 형식, 분산 삽입, 간격 출력 형식, float 파싱 정밀도 등을 설정하는 항목입니다.

출처: 문서

본문

이 설정들은 source에서 자동 생성됩니다.

allow_special_bool_values_inside_variant

Variant 타입 안의 Bool 값을 “on”, “off”, “enable”, “disable” 같은 특수 텍스트 bool 값에서 파싱할 수 있게 허용해요.

check_conversion_from_numbers_to_enum

Numbers를 Enum으로 변환할 때 값이 Enum에 없으면 예외를 던질지 여부예요. 가능한 값:

  • 0 — 비활성화.
  • 1 — 활성화.

Example

CREATE TABLE tab (
  val Enum('first' = 1, 'second' = 2, 'third' = 3)
) ENGINE = Memory;

INSERT INTO tab SETTINGS check_conversion_from_numbers_to_enum = 1 VALUES (4); -- returns an error

column_names_for_schema_inference

열 이름이 없는 포맷의 스키마 추론에 사용할 열 이름 목록이에요. 형식: ‘column1,column2,column3,…’.

errors_output_format

오류를 텍스트 출력에 기록하는 방법이에요.

insert_distributed_one_random_shard

분산 키가 없을 때 Distributed 테이블에 무작위 샤드 삽입을 허용할지 여부예요. 기본적으로 샤드가 둘 이상인 Distributed 테이블에 데이터를 삽입할 때 분산 키가 없으면 ClickHouse 서버는 삽입 요청을 거부해요. insert_distributed_one_random_shard = 1이면 삽입이 허용되고 데이터는 모든 샤드에 무작위로 전달됩니다. 가능한 값:

  • 0 — 샤드가 여러 개이고 분산 키가 주어지지 않으면 삽입이 거부돼요.
  • 1 — 분산 키가 주어지지 않으면 사용 가능한 모든 샤드에 무작위로 삽입돼요.

interval_output_format

간격 타입의 텍스트 표현에서 서로 다른 출력 형식을 선택할 수 있게 해줘요. 가능한 값:

  • kusto — KQL 스타일 출력 형식이에요. ClickHouse는 간격을 KQL 형식으로 출력해요. 예를 들어 toIntervalDay(2)는 2.00:00:00 으로 형식화돼요. 길이가 다양한 간격 타입(즉 IntervalMonth와 IntervalYear)의 경우 간격당 평균 초 수가 고려됩니다.
  • numeric — 숫자 출력 형식이에요. ClickHouse는 간격을 기본 숫자 표현으로 출력해요. 예를 들어 toIntervalDay(2)는 2 로 형식화돼요.

참고:

  • Interval

into_outfile_create_parent_directories

INTO OUTFILE 사용 시 상위 디렉터리가 아직 없으면 자동으로 생성할지 여부예요.

json_type_escape_dots_in_keys

활성화하면 파싱 중에 JSON 키의 점(dot)이 이스케이프돼요.

max_dynamic_subcolumns_in_json_type_parsing

JSON 열을 파싱할 때 매 열에서 만들 수 있는 동적 하위 열의 최대 개수예요. 데이터 타입에 지정된 동적 파라미터와 무관하게 파싱 중 동적 하위 열의 개수를 제어할 수 있게 해줍니다.

precise_float_parsing

항상 입력에 가장 가까운 표현 가능한 값을 반환하는 정밀 float 파싱 알고리즘을 사용할지 여부예요. 비활성화하면 더 빠르지만 덜 정확한 알고리즘을 사용하며, 최하위 비트에서 정밀한 결과와 다를 수 있어요.

validate_experimental_and_suspicious_types_inside_nested_types

Array/Map/Tuple 같은 중첩 타입 안에서 실험적이고 의심스러운 타입의 사용을 검증할지 여부예요.

더 알아보기 (Learn more)