http_* 세션 설정 | ClickHouse Docs

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

http_allow_database_as_path

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.8	0	HTTP 요청의 URL 경로에서 데이터베이스 이름을 인식하는 새로운 설정.

활성화하면 HTTP 인터페이스는 URL 경로의 /database/ 구성 요소를 인식하여 현재 데이터베이스로 사용합니다.

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

http_allow_filters_as_path

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.8	0	HTTP 요청의 URL 경로에서 Hive 스타일의 `name=value` 필터를 인식하는 새로운 설정입니다.

활성화하면 HTTP 인터페이스는 경로의 /name=value/ 구성 요소(Hive 파티셔닝 스타일)를 인식하고 AND로 결합된 필터로 변환합니다. 연산자 >, <, >=, <=, !=, <>도 인식합니다.

http_allow_database_as_path와 마찬가지로 사용자별 설정입니다. 경로 스타일 요청의 라우팅은 서버 수준의 http_allow_path_requests 구성 설정에 따라 전역적으로 제어됩니다(라우팅은 인증 전에 수행됨).

http_allow_filters_as_unrecognized_url_parameters

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.8	0	인식되지 않는 URL 매개변수를 HTTP 요청의 필터 표현식으로 처리하는 새로운 설정입니다.

활성화하면 알려진 매개변수, 설정 또는 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

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.8	0	HTTP 요청의 URL 경로에서 선택적 포맷/압축 확장자를 포함한 테이블 이름을 인식하는 새로운 설정입니다.

활성화하면 HTTP 인터페이스는 URL 경로의 마지막 구성 요소를 table, table.format 또는 table.format.compression 형식의 테이블 이름으로 인식합니다. 이 경로는 SELECT * FROM table로 해석됩니다.

http_allow_database_as_path와 마찬가지로 사용자별 설정입니다. 경로 스타일 요청의 라우팅은 서버 수준의 http_allow_path_requests 구성 설정으로 전역적으로 제어됩니다(라우팅은 인증 전에 수행됨).

http_connection_timeout

유형

Seconds

기본값

HTTP 연결 타임아웃(초)입니다.

가능한 값:

양의 정수이면 모두 가능합니다.
0 - 비활성화됨(무한 타임아웃).

http_make_head_request

유형

Bool

기본값

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

http_native_compression_disable_checksumming_on_decompress

유형

Bool

기본값

클라이언트의 HTTP POST 데이터를 압축 해제할 때 체크섬 검증을 활성화하거나 비활성화합니다. ClickHouse 네이티브 압축 포맷에서만 사용되며, gzip 또는 deflate에는 적용되지 않습니다.

자세한 내용은 HTTP 인터페이스 설명을 참조하십시오.

가능한 값:

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

http_receive_timeout

유형

Seconds

기본값

버전 이력

버전	기본값	설명
23.6	30	http_send_timeout을 참조하십시오.

HTTP 수신 타임아웃(초 단위)입니다.

가능한 값:

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

http_send_timeout

유형

Seconds

기본값

버전 이력

버전	기본값	설명
23.6	30	3분은 터무니없이 길게 느껴집니다. 이는 전체 업로드 작업이 아니라 단일 네트워크 쓰기 호출에 대한 타임아웃이라는 점에 유의하십시오.

HTTP 전송 타임아웃(초)입니다.

가능한 값:

양의 정수(초). 0은 무한 타임아웃이 아니며 연결 설정 실패를 유발할 수 있습니다(POSIX 소켓 타임아웃에는 양의 인터벌이 필요합니다).

http_skip_not_found_url_for_globs

유형

Bool

기본값

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

http_wait_end_of_query

유형

Bool

기본값

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

http_write_exception_in_output_format

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.11	0	포맷 전반의 일관성을 위해 변경됨
23.9	1	HTTP streaming에서 예외 발생 시 유효한 JSON/XML을 출력합니다.

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

http_zlib_compression_level

유형

Int64

기본값

enable_http_compression = 1일 때 HTTP 요청에 대한 응답의 데이터 압축 수준을 설정합니다.

가능한 값: 1~~12의 숫자입니다. 9를 초과하는 수준은 libdeflate가 포함된 기본 빌드가 필요합니다. libdeflate가 없는 빌드는 1~~9 수준만 지원합니다.