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_* 설정과 달리 기본적으로 비활성화되어 있습니다. 이 설정은 /?query=... 엔드포인트를 포함한 HTTP 인터페이스의 모든 요청에 적용되므로, 활성화하면 클라이언트가 덧붙이는 인식되지 않는 URL 매개변수(요청 ID, 서명, 캐시 무효화 값 등)가 모두 쿼리의 필터로 변환됩니다. 이 경우 철자가 잘못된 설정 이름은 더 이상 UNKNOWN_SETTING으로 보고되지 않고 UNKNOWN_IDENTIFIER 오류로 실패하며(이름이 우연히 컬럼과 일치하면 아무런 알림 없이 결과가 필터링됩니다), 매개변수 값은 쿼리 텍스트에 포함되므로 로그의 Request URI와 달리 마스킹되지 않습니다.
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_x_clickhouse_format_overrides_output_format
X-ClickHouse-Format HTTP 헤더가 어떤 설정에 매핑될지를 제어합니다.
활성화하면(기본값) 헤더는 output_format 설정의 별칭이 됩니다. 즉, 응답 포맷을 명시적으로 재정의하며, 쿼리의 FORMAT 절과 URL 경로의 파일 확장자보다 우선합니다.
비활성화하면 헤더는 버전 26.8 이전과 마찬가지로 default_format 설정의 별칭이 됩니다. 즉, 쿼리에 FORMAT 절이 없고 다른 포맷 재정의도 적용되지 않을 때 사용할 포맷만 지정합니다.
어느 경우든 헤더는 같은 이름의 URL 매개변수(각각 output_format 또는 default_format)보다 우선하며, INSERT 요청 본문의 파싱 방식에는 영향을 주지 않습니다.
이 설정은 HTTP 인터페이스용 compatibility 설정입니다. 헤더는 쿼리가 파싱되기 전에 처리되므로, 쿼리 내 SETTINGS 절이 아니라 URL 매개변수나 사용자 프로필을 통해 지정해야 합니다. output_format 및 default_format과 마찬가지로 읽기 전용 모드(readonly = 1)에서도 언제든 변경할 수 있으므로, 읽기 전용 사용자도 URL 매개변수로 전달할 수 있습니다.
http_zlib_compression_level
enable_http_compression = 1일 때 HTTP 요청에 대한 응답의 데이터 압축 수준을 설정합니다. 가능한 값: 19를 초과하는 수준은 libdeflate가 포함된 기본 빌드가 필요합니다. libdeflate가 없는 빌드는 1