> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# reader_executor_* 세션 설정

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

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>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            실험 기능입니다. <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">자세히 알아보세요.</a></u>
        </div>;
};

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

<div id="reader_executor_max_tail_for_drain">
  ## reader\_executor\_max\_tail\_for\_drain
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="UInt64" default_value="1048576" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1048576"},{"label": "새로운 실험적 ReaderExecutor 설정: 끊어진 장기 연결을 완료하기 위한 drain 한계값입니다."}]}]} />

실험적 `ReaderExecutor`의 drain 한계값입니다. 장기 유지된 소스 연결이 우측 경계에서 이 바이트 수 이내 지점에서 끊어지면, 먼저 해당 경계까지 모두 읽어 연결을 완료하므로 불완전한 연결로 계산되지 않고 재사용 가능한 상태로 연결 풀에 반환됩니다.

<div id="reader_executor_min_bytes_for_seek">
  ## reader\_executor\_min\_bytes\_for\_seek
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="UInt64" default_value="2097152" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "2097152"},{"label": "새로운 실험적 ReaderExecutor 설정: 유지 중인 소스 연결에서 브리징할 때의 전방 gap 한계값"}]}]} />

실험적 `ReaderExecutor`의 전방 gap 한계값입니다. 이 값 이하의 gap은 별도의 소스 읽기를 요청하거나 다시 열지 않고, 열려 있는 소스 연결에서 건너뛰어(브리징/연속 읽기) 처리합니다. 브리징이 비용 면에서 이득이 되도록 bandwidth와 request 비용의 손익분기점에 가깝게 설정하십시오.

<div id="reader_executor_use_long_connections">
  ## reader\_executor\_use\_long\_connections
</div>

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "새로운 실험적 ReaderExecutor 설정(기본값: 비활성화): 순차적인 윈도우 전반에서 유지 중인 소스 연결을 재사용합니다."}]}]} />

실험적 `ReaderExecutor`에서 윈도우 전반에 걸쳐 범위가 제한된 장기 소스 연결을 재사용합니다. 장기 연결은 범위가 현재 읽기 윈도우를 초과하는 연결을 의미합니다. 이 기능을 비활성화하면 실행기는 연결 풀 예산을 전혀 사용하지 않으며, 각 윈도우는 수명이 짧은 일회성 연결을 엽니다(상태 비저장 경로).
