> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# join_runtime_* 세션 설정

> join_runtime_* 생성 그룹에 속한 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)에서 자동으로 생성됩니다.

## join\_runtime\_bloom\_filter\_bytes

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "524288"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "524288"},{"label": "새로운 설정"}]}]} />

JOIN 런타임 필터에 사용되는 블룸 필터의 크기(바이트)입니다(enable\_join\_runtime\_filters 설정 참조).

## join\_runtime\_bloom\_filter\_hash\_functions

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "3"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "3"},{"label": "새로운 설정"}]}]} />

JOIN 런타임 필터에 사용되는 블룸 필터의 해시 함수 개수입니다(enable\_join\_runtime\_filters 설정 참조).

## join\_runtime\_bloom\_filter\_max\_ratio\_of\_set\_bits

<SettingsInfoBlock type="Double" default_value="0.7" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "0.7"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "26.1"},{"label": "0.7"},{"label": "새로운 설정"}]}]} />

런타임 블룸 필터에서 1로 설정된 비트 수가 이 비율을 초과하면, 오버헤드를 줄이기 위해 필터가 완전히 비활성화됩니다.

## join\_runtime\_filter\_blocks\_to\_skip\_before\_reenabling

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "30"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "26.1"},{"label": "30"},{"label": "새로운 설정"}]}]} />

이전에 필터링 비율이 낮아 비활성화된 런타임 필터를 동적으로 다시 활성화하기 전에 건너뛸 블록 수입니다.

## join\_runtime\_filter\_exact\_values\_limit

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "10000"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "10000"},{"label": "새로운 설정"}]}]} />

런타임 필터에서 원소를 집합에 그대로 저장할 수 있는 최대 개수이며, 이 임계값을 초과하면 블룸 필터로 전환됩니다.

## join\_runtime\_filter\_from\_fixed\_hash\_table

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "새 설정입니다."}]}]} />

해시 조인의 빌드 측이 FixedHashMap으로 변환되면(`enable_join_fixed_hash_table_conversion` 참조) 해당 해시 맵을 런타임 필터로 직접 사용합니다.

## join\_runtime\_filter\_min\_probe\_rows

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "1000"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "26.8"},{"label": "1000"},{"label": "JOIN 런타임 필터를 설치하기 위한 probe 측의 최소 크기를 제어하는 새로운 설정입니다. 이전에는 제한이 없었으므로, 이전 값인 0은 항상 설치함을 의미합니다."}]}]} />

쿼리 계획 수립 시 JOIN의 probe 측에서 생성될 것으로 추정되는 행 수가 이 값 이하이면 JOIN 런타임 필터를 생성하지 않습니다. 아주 작은 probe 측에 런타임 필터를 생성하고 적용하는 비용이 절감 효과보다 큽니다. 추정된 probe 크기와 관계없이 항상 런타임 필터를 생성하려면 0으로 설정하십시오.

## join\_runtime\_filter\_pass\_ratio\_threshold\_for\_disabling

<SettingsInfoBlock type="Double" default_value="0.7" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "0.7"},{"label": "JOIN 런타임 필터가 Production 티어 기능이 되었습니다."}]}, {"id": "row-2","items": [{"label": "26.1"},{"label": "0.7"},{"label": "새로운 설정"}]}]} />

검사된 행 대비 통과한 행의 비율이 이 임계값을 초과하면 런타임 필터의 성능이 좋지 않은 것으로 간주되며, 오버헤드를 줄이기 위해 다음 `join_runtime_filter_blocks_to_skip_before_reenabling` 블록 동안 비활성화됩니다.

## join\_runtime\_filter\_size\_from\_hash\_table\_stats

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "이전 실행에서 수집한 해시 테이블 크기 통계를 사용해 JOIN 런타임 필터의 크기를 결정합니다. 비활성화하면 고정된 `join_runtime_bloom_filter_bytes`로 폴백됩니다."}]}]} />

이전 실행에서 수집한 해시 테이블 크기 통계를 사용해 JOIN 런타임 필터의 크기를 결정합니다. 비활성화하면 고정된 `join_runtime_bloom_filter_bytes`로 폴백됩니다.