> ## 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.

# preferred_* 세션 설정

> 자동 생성된 preferred_* 그룹의 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>;
};

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

<div id="preferred_block_size_bytes">
  ## preferred\_block\_size\_bytes
</div>

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

이 설정은 쿼리 처리 시 데이터 블록 크기를 조정하며, 비교적 대략적인 `max_block_size` 설정을 추가로 세밀하게 조정하는 데 사용됩니다. 컬럼이 크고 `max_block_size` 행을 기준으로 하면 블록 크기가 지정된 바이트 수를 초과할 가능성이 있는 경우, 더 나은 CPU 캐시 지역성을 위해 블록 크기를 더 작게 조정합니다.

<div id="preferred_max_column_in_block_size_bytes">
  ## preferred\_max\_column\_in\_block\_size\_bytes
</div>

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

읽는 동안 블록 내 최대 컬럼 크기를 제한합니다. 캐시 미스 횟수를 줄이는 데 도움이 됩니다. L2 cache 크기에 가깝게 설정해야 합니다.

<div id="preferred_optimize_projection_name">
  ## preferred\_optimize\_projection\_name
</div>

비어 있지 않은 문자열로 설정하면 ClickHouse는 쿼리에서 지정된 projection을 적용하려고 시도합니다.

가능한 값:

* string: 선호하는 projection의 이름