format 포맷 설정

format 포맷 설정 (format format settings)

이 페이지는 format_* 그룹의 자동 생성 설정을 다루는 문서예요. 시크릿 표시, GeoJSON 지오메트리 검증, 행 구분자, 객체 이름 열, 자동 생성 스키마, NULL 표현 등을 설정하는 항목입니다.

출처: 문서

본문

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

format_display_secrets_in_show_and_select

테이블, 데이터베이스, 테이블 함수, 딕셔너리에 대한 SHOW 및 SELECT 쿼리에서 시크릿을 표시할지 여부를 제어해요. 또한 설정 값에 포함된 시크릿(예: format_avro_schema_registry_url의 비밀번호)이 system.settings, system.processes, system.settings_profile_elements와 SHOW CREATE USER / SHOW CREATE SETTINGS PROFILE에 표시되는지도 제어합니다. 시크릿을 보려는 사용자는 display_secrets_in_show_and_select 서버 설정이 켜져 있고 displaySecretsInShowAndSelect 권한도 있어야 해요. 가능한 값:

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

format_geojson_validate_geometry

GeoJSON 포맷이 양방향으로 RFC 7946 지오메트리 유효성을 강제하는지 여부를 제어해요. 활성화되면(기본), GeoJSON 모양 규칙을 위반하는 지오메트리는 거부됩니다: 두 점보다 적은 LineString(또는 MultiLineString의 한 선); 네 점보다 적거나 첫 점과 끝 점이 다른 Polygon 또는 MultiPolygon 링(닫히지 않은 링); 또는 빈 MultiLineString, Polygon, MultiPolygon. 이는 읽을 때(그런 문서는 거부됨)와 쓸 때(입력 포맷이 거부할 문서를 만드는 대신 ClickHouse 값을 거부) 모두 적용됩니다. 비활성화되면 이런 모양 규칙이 적용되지 않아요. 그런 지오메트리는 그대로 읽고 그대로 쓰므로, 퇴화된 지오메트리도 왕복되지만 작성된 문서는 유효한 GeoJSON이 아닐 수 있어요. 검증은 구조적일 뿐입니다. 점 개수와 링 폐쇄를 확인해요. 모양의 기하학적 정확성은 검사하지 않습니다 — 링 방향(오른손 규칙/감는 순서)은 강제되지 않고, 구조적으로 유효하지만 기하학적으로 퇴화된 지오메트리(예: 면적 0인 폴리곤, 자기 교차 링, 구멍이 바깥 링 밖에 있는 폴리곤)는 허용됩니다. NaN, Inf 같은 유한하지 않은 좌표는 JSON 숫자로 표현할 수 없으므로 이 설정과 무관하게 항상 거부됩니다.

format_hive_text_rows_delimiter

Hive Text 출력 포맷에서 각 행의 끝에 오는 구분자예요.

format_json_object_each_row_column_for_object_name

JSONObjectEachRow 포맷에서 객체 이름을 저장/기록하는 데 사용할 열의 이름이에요. 열 타입은 String이어야 해요. 값이 비어 있으면 객체 이름에 기본 이름 row_{i}가 사용됩니다.

format_protobuf_use_autogenerated_schema

format_schema가 설정되지 않았을 때 자동 생성된 Protobuf를 사용할지 여부예요.

format_tsv_null_representation

TSV 포맷에서의 사용자 정의 NULL 표현이에요.

format 포맷 설정