Skip to main content
이러한 설정은 system.settings에서 확인할 수 있으며, 소스 코드로부터 자동 생성됩니다.

http_allow_database_as_path

활성화하면 HTTP 인터페이스는 URL 경로의 /database/ 구성 요소를 인식하여 현재 데이터베이스로 사용합니다. 이 설정은 경로 스타일로 라우팅된 요청을 해석할지 여부를 제어하는 사용자별 설정입니다. 라우팅 자체는 서버 수준의 http_allow_path_requests 구성 설정(기본적으로 비활성화됨)에 의해 전역적으로 제어됩니다. HTTP 인터페이스가 경로 스타일 요청(예: /my_db/my_table.csv)을 쿼리 핸들러로 라우팅하려면 이 설정을 활성화해야 합니다. 라우팅 여부는 요청 인증 전에 결정되므로 사용자별 설정에 따라 달라질 수 없습니다. http_allow_path_requests가 비활성화되어 있으면 알 수 없는 경로는 일반 404를 반환합니다. 라우팅 후에는 인증된 사용자의 유효 설정을 기준으로 이 설정을 다시 확인하므로 사용자, 역할 또는 프로필별로 선택적으로 활성화할 수 있습니다.

http_allow_filters_as_path

활성화하면 HTTP 인터페이스는 경로의 /name=value/ 구성 요소(Hive 파티셔닝 스타일)를 인식하고 AND로 결합된 필터로 변환합니다. 연산자 >, <, >=, <=, !=, <>도 인식합니다. http_allow_database_as_path와 마찬가지로 사용자별 설정입니다. 경로 스타일 요청의 라우팅은 서버 수준의 http_allow_path_requests 구성 설정에 따라 전역적으로 제어됩니다(라우팅은 인증 전에 수행됨).

http_allow_filters_as_unrecognized_url_parameters

활성화하면 알려진 매개변수, 설정 또는 param_* 접두사로 인식되지 않는 모든 URL 매개변수가 필터로 처리되며 AND로 결합됩니다. 다음 두 가지 형식을 사용할 수 있습니다:
  • 일반적인 name=value 형식은 동등 비교 `name` = 'value'로 변환됩니다(식별자는 역따옴표로 묶고 값은 문자열 리터럴로 묶습니다).
  • 비교 연산자(!=, >, <, >=, <=, <>)가 있으면 비교 표현식으로 처리됩니다. 매개변수에 걸쳐 분리해 작성하거나(?a!=2, ?a>=2), URL에 분리할 =가 없을 때 인라인으로 작성할 수 있습니다(?a<>2, ?f(x)>3). 이 경우 다시 조합된 name[=value]는 완전한 SQL 표현식으로 구문 분석됩니다.

http_allow_table_as_file

활성화하면 HTTP 인터페이스는 URL 경로의 마지막 구성 요소를 table, table.format 또는 table.format.compression 형식의 테이블 이름으로 인식합니다. 이 경로는 SELECT * FROM table로 해석됩니다. http_allow_database_as_path와 마찬가지로 사용자별 설정입니다. 경로 스타일 요청의 라우팅은 서버 수준의 http_allow_path_requests 구성 설정으로 전역적으로 제어됩니다(라우팅은 인증 전에 수행됨).

http_connection_timeout

HTTP 연결 타임아웃(초)입니다. 가능한 값:
  • 양의 정수이면 모두 가능합니다.
  • 0 - 비활성화됨(무한 타임아웃).

http_make_head_request

http_make_head_request 설정을 사용하면 HTTP에서 데이터를 읽는 동안 HEAD 요청을 실행하여 크기와 같은 읽을 파일 정보를 가져올 수 있습니다. 이 설정은 기본적으로 활성화되어 있으므로, server가 HEAD 요청을 지원하지 않는 경우에는 이 설정을 비활성화하는 것이 좋습니다.

http_native_compression_disable_checksumming_on_decompress

클라이언트의 HTTP POST 데이터를 압축 해제할 때 체크섬 검증을 활성화하거나 비활성화합니다. ClickHouse 네이티브 압축 포맷에서만 사용되며, gzip 또는 deflate에는 적용되지 않습니다. 자세한 내용은 HTTP 인터페이스 설명을 참조하십시오. 가능한 값:
  • 0 — 비활성화됨.
  • 1 — 활성화됨.

http_receive_timeout

HTTP 수신 타임아웃(초 단위)입니다. 가능한 값:
  • 양의 정수(초 단위). 0무한 타임아웃이 아니며 연결 설정 실패를 유발할 수 있습니다(POSIX 소켓 타임아웃에는 양의 인터벌이 필요합니다).

http_send_timeout

HTTP 전송 타임아웃(초)입니다. 가능한 값:
  • 양의 정수(초). 0무한 타임아웃이 아니며 연결 설정 실패를 유발할 수 있습니다(POSIX 소켓 타임아웃에는 양의 인터벌이 필요합니다).
이는 default profile에만 적용됩니다. 변경 사항을 적용하려면 서버를 재부팅해야 합니다.

http_skip_not_found_url_for_globs

HTTP_NOT_FOUND 오류가 발생한 글롭 패턴의 URL을 건너뜁니다

http_wait_end_of_query

서버 측 HTTP 응답 버퍼링을 활성화합니다.

http_write_exception_in_output_format

유효한 출력을 생성할 수 있도록 예외를 출력 형식으로 기록합니다. JSON 및 XML 포맷에서 작동합니다.

http_zlib_compression_level

enable_http_compression = 1일 때 HTTP 요청에 대한 응답의 데이터 압축 수준을 설정합니다. 가능한 값: 112의 숫자입니다. 9를 초과하는 수준은 libdeflate가 포함된 기본 빌드가 필요합니다. libdeflate가 없는 빌드는 19 수준만 지원합니다.
마지막 수정일 2026년 8월 18일