> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# http_* 세션 설정

> http_* 생성 그룹에 속한 ClickHouse 세션 설정입니다.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["버전", "기본값", "설명"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        버전 이력
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이러한 설정은 [system.settings](/ko/reference/system-tables/settings)에서 확인할 수 있으며, [소스 코드](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)로부터 자동 생성됩니다.

<div id="http_allow_database_as_path">
  ## http\_allow\_database\_as\_path
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTP 요청의 URL 경로에서 데이터베이스 이름을 인식하는 새로운 설정."}]}]} />

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

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

<div id="http_allow_filters_as_path">
  ## http\_allow\_filters\_as\_path
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTP 요청의 URL 경로에서 Hive 스타일의 `name=value` 필터를 인식하는 새로운 설정입니다."}]}]} />

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

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

<div id="http_allow_filters_as_unrecognized_url_parameters">
  ## http\_allow\_filters\_as\_unrecognized\_url\_parameters
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "인식되지 않는 URL 매개변수를 HTTP 요청의 필터 표현식으로 처리하는 새로운 설정입니다."}]}]} />

활성화하면 알려진 매개변수, 설정 또는 `param_*` 접두사로 인식되지 않는 모든 URL 매개변수가 필터로 처리되며 AND로 결합됩니다. 다음 두 가지 형식을 사용할 수 있습니다:

* 일반적인 `name=value` 형식은 동등 비교 `` `name` = 'value' ``로 변환됩니다(식별자는 역따옴표로 묶고 값은 문자열 리터럴로 묶습니다).
* 비교 연산자(`!=`, `>`, `<`, `>=`, `<=`, `<>`)가 있으면 비교 표현식으로 처리됩니다. 매개변수에 걸쳐 분리해 작성하거나(`?a!=2`, `?a>=2`), URL에 분리할 `=`가 없을 때 인라인으로 작성할 수 있습니다(`?a<>2`, `?f(x)>3`). 이 경우 다시 조합된 `name[=value]`는 완전한 SQL 표현식으로 구문 분석됩니다.

<div id="http_allow_table_as_file">
  ## http\_allow\_table\_as\_file
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "HTTP 요청의 URL 경로에서 선택적 포맷\/압축 확장자를 포함한 테이블 이름을 인식하는 새로운 설정입니다."}]}]} />

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

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

<div id="http_connection_timeout">
  ## http\_connection\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="1" />

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

가능한 값:

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

<div id="http_make_head_request">
  ## http\_make\_head\_request
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="http_native_compression_disable_checksumming_on_decompress">
  ## http\_native\_compression\_disable\_checksumming\_on\_decompress
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

자세한 내용은 [HTTP 인터페이스 설명](/ko/concepts/features/interfaces/http)을 참조하십시오.

가능한 값:

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

<div id="http_receive_timeout">
  ## http\_receive\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.6"},{"label": "30"},{"label": "http_send_timeout을 참조하십시오."}]}]} />

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

가능한 값:

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

<div id="http_send_timeout">
  ## http\_send\_timeout
</div>

<SettingsInfoBlock type="Seconds" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "23.6"},{"label": "30"},{"label": "3분은 터무니없이 길게 느껴집니다. 이는 전체 업로드 작업이 아니라 단일 네트워크 쓰기 호출에 대한 타임아웃이라는 점에 유의하십시오."}]}]} />

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

가능한 값:

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

<Note>
  이는 default profile에만 적용됩니다. 변경 사항을 적용하려면 서버를 재부팅해야 합니다.
</Note>

<div id="http_skip_not_found_url_for_globs">
  ## http\_skip\_not\_found\_url\_for\_globs
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

HTTP\_NOT\_FOUND 오류가 발생한 글롭 패턴의 URL을 건너뜁니다

<div id="http_wait_end_of_query">
  ## http\_wait\_end\_of\_query
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="http_write_exception_in_output_format">
  ## http\_write\_exception\_in\_output\_format
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "0"},{"label": "포맷 전반의 일관성을 위해 변경됨"}]}, {"id": "row-2","items": [{"label": "23.9"},{"label": "1"},{"label": "HTTP streaming에서 예외 발생 시 유효한 JSON/XML을 출력합니다."}]}]} />

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

<div id="http_zlib_compression_level">
  ## http\_zlib\_compression\_level
</div>

<SettingsInfoBlock type="Int64" default_value="3" />

[enable\_http\_compression = 1](/ko/reference/settings/session-settings/enable#enable_http_compression)일 때 HTTP 요청에 대한 응답의 데이터 압축 수준을 설정합니다.

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