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

# analyzer_compatibility_* 세션 설정

> analyzer_compatibility_* 생성 그룹에 속한 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="analyzer_compatibility_allow_compound_identifiers_in_unflatten_nested">
  ## analyzer\_compatibility\_allow\_compound\_identifiers\_in\_unflatten\_nested
</div>

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

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

Nested에 복합 식별자를 추가할 수 있도록 합니다. 이 설정을 사용하면 쿼리 결과가 변경되므로 compatibility 설정입니다. 비활성화되면 `SELECT a.b.c FROM table ARRAY JOIN a`는 동작하지 않으며, `SELECT a FROM table`의 `Nested a` 결과에 `a.b.c` 컬럼이 포함되지 않습니다.

<div id="analyzer_compatibility_allow_non_aggregate_in_having">
  ## analyzer\_compatibility\_allow\_non\_aggregate\_in\_having
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "새 compatibility 설정입니다. 활성화하면 분석기는 `NOT_AN_AGGREGATE`를 발생시키는 대신 비집계 AND 조건에 대해 기존 `HAVING`-to-`WHERE` 재작성을 모방합니다."}]}]} />

활성화하면 분석기는 `NOT_AN_AGGREGATE`를 발생시키는 대신 비집계 AND 조건을 `HAVING`에서 `WHERE`로 이동시키는 기존 동작을 모방합니다. SQL 표준을 따르는 거부 동작이 기본값이며, 이는 이전 분석기(`enable_analyzer = 0`)에서 별다른 오류 없이 허용되던 쿼리를 위한 마이그레이션 보조 수단입니다. 집계, `grouping` 또는 비결정적 함수를 포함한 조건은 `HAVING`에 그대로 유지됩니다. 어떤 조건이든 윈도 함수 또는 상태 저장 함수(예: `rowNumberInBlock`)를 포함하면 전체 `HAVING`에 대해 재작성이 비활성화되며, 이는 기존 `PredicateExpressionsOptimizer` 동작과 일치합니다. 또한 `GROUP BY`에서 `WITH CUBE`, `WITH ROLLUP`, `WITH TOTALS` 또는 `GROUPING SETS`를 사용하는 경우 이 설정은 무시됩니다.

<div id="analyzer_compatibility_apply_final_to_all_joined_tables">
  ## analyzer\_compatibility\_apply\_final\_to\_all\_joined\_tables
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "master에 새 설정이 추가되었습니다(기본값 false = 수정된 동작). 동작 변경 자체는 26.6에 기록되어 있으며, 이전 릴리스 브랜치에 대한 백포트(기본값 true)는 26.4에 기록되어 있습니다."}]}, {"id": "row-2","items": [{"label": "26.6"},{"label": "0"},{"label": "JOIN의 가장 왼쪽 테이블에 지정된 FINAL이 다른 조인 테이블에도 잘못 적용되던 분석기 버그를 수정했습니다. previous_value=true이므로 26.6 이전 버전의 `compatibility`를 사용하면 이전 동작이 복원됩니다."}]}, {"id": "row-3","items": [{"label": "26.4"},{"label": "1"},{"label": "JOIN의 가장 왼쪽 테이블에 지정된 FINAL을 다른 조인 테이블에도 적용할지 제어하는 새로운 compatibility 설정입니다. 26.6 이전 버전에 대한 백포트를 위해 기본값 true(이전 동작)로 도입되었습니다."}]}]} />

26.6 이전 버전의 동작을 복원합니다. 이 동작에서는 JOIN의 가장 왼쪽 테이블에 지정된 `FINAL` 수정자가 다른 모든 조인 테이블에도 잘못 적용되었습니다(`FINAL`을 지원하는 엔진(예: `ReplacingMergeTree`)에 한함). 기본적으로 `FINAL`은 지정된 테이블에만 적용됩니다. 이전 동작에 의존하는 쿼리와의 호환성을 위해 활성화하십시오. 권장되는 해결 방법은 필요한 모든 테이블에 `FINAL`을 명시적으로 지정하는 것입니다.

가능한 값:

* 0 - `FINAL`은 지정된 테이블에만 적용됩니다.
* 1 - JOIN의 가장 왼쪽 테이블에 지정된 `FINAL`이 모든 조인 테이블에 적용됩니다.

<div id="analyzer_compatibility_join_using_top_level_identifier">
  ## analyzer\_compatibility\_join\_using\_top\_level\_identifier
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "0"},{"label": "projection에서 JOIN USING의 식별자를 해석하도록 강제합니다"}]}]} />

projection에서 JOIN USING의 식별자를 해석하도록 강제합니다(예: `SELECT a + 1 AS b FROM t1 JOIN t2 USING (b)`에서는 `t1.b = t2.b`가 아니라 `t1.a + 1 = t2.b`를 기준으로 조인이 수행됩니다). SELECT 목록 내 하위 표현식에 정의된 별칭도 고려됩니다(예: `SELECT uniqExact(a + 1 AS b) FROM t1 JOIN t2 USING (b)`에서는 `t1.a + 1 = t2.b`를 기준으로 조인이 수행됩니다). 일치하는 별칭이 최상위 별칭이 아니라 SELECT 목록 내 하위 표현식에 정의된 경우, 해당 쿼리에서는 병렬 레플리카가 비활성화됩니다. 원격 서버로 전송되는 쿼리(`Distributed` 테이블, `remote` 테이블 함수)는 원격 서버에서 식별자를 전혀 해석할 수 없는 경우에만 예외와 함께 거부됩니다. 별칭이 왼쪽 테이블의 실제 컬럼을 가리는 경우 원격 서버는 대신 해당 컬럼을 기준으로 조인하므로, 결과가 로컬 실행과 다를 수 있습니다.

<div id="analyzer_compatibility_multiple_joins_qualify_column_names">
  ## analyzer\_compatibility\_multiple\_joins\_qualify\_column\_names
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "새 compatibility 설정입니다. 활성화하면 분석기는 FROM 절에 2개 이상의 JOIN이 있는 쿼리에서 이전 분석기의 한정된 결과 컬럼명을 모방합니다."}]}]} />

활성화되어 있고 쿼리의 `FROM` 절에 2개 이상의 `JOIN`이 포함된 경우(쉼표로 구분된 테이블도 포함되지만 `ARRAY JOIN`은 제외됨), 분석기는 이전 분석기의 다중 조인 재작성 방식에 따라 결과 컬럼의 이름을 지정합니다.

* `*`, `<table>.*` 또는 `COLUMNS('<regexp>')`를 확장해 생성된 컬럼은 `<alias-or-table>.<column>` 형식의 이름을 갖습니다(한정자는 테이블 표현식에 별칭이 있으면 해당 별칭, 없으면 데이터베이스명을 제외한 테이블명, 그 외에는 CTE 이름입니다. 별칭이 없는 조인된 하위 쿼리의 컬럼에는 한정자가 붙지 않습니다). 단일 테이블 표현식이 아니라 조인 자체에 속하는 두 종류의 컬럼은 한정자 없이 이름을 유지합니다. `ARRAY JOIN`으로 생성된 컬럼과 `JOIN ... USING`으로 머지된 키가 이에 해당합니다. 따라서 `SELECT ll.arr` 또는 `SELECT ll.k`와 같은 외부 참조는 이 두 경우에 해석되지 않습니다.
* 식별자 목록 형식인 `COLUMNS(col1, col2)`는 매처 확장이 아닙니다. 각 컬럼은 식별자를 작성한 그대로의 이름을 유지하므로 `COLUMNS(x)`는 `x`를, `COLUMNS(a.x)`는 `a.x`를 생성합니다.
* `SELECT` 목록에서 별칭이 없는 컬럼 참조는 작성한 그대로의 이름을 유지합니다(예: `SELECT a.x`는 `x`가 모호하지 않은 경우에도 `a.x`라는 이름의 컬럼을 생성합니다).

이렇게 하면 예를 들어 한정된 이름으로 이러한 컬럼을 참조하는 외부 쿼리가 작동합니다.

```sql theme={null}
SELECT ll.Date FROM (SELECT * FROM t AS ll LEFT JOIN t1 ON ll.k = t1.k LEFT JOIN t2 ON ll.k = t2.k);
```

분석기가 활성화된 경우에만 적용됩니다(`enable_analyzer = 1`).

<div id="analyzer_compatibility_prefer_alias_over_subcolumn">
  ## analyzer\_compatibility\_prefer\_alias\_over\_subcolumn
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "새로운 compatibility 설정"}]}]} />

`b.id`와 같은 다중 부분 식별자가 별칭이 `b`인 테이블의 컬럼 `id`를 가리킬 수도 있고 다른 컬럼의 Tuple subcolumn `b.id`를 가리킬 수도 있는 경우, 별칭 접두사로 해석하는 방식(`b`의 컬럼 `id`)을 우선합니다. 기본적으로 분석기는 subcolumn을 우선합니다. 이전 분석기의 해석 방식과 일치시키려면 이 설정을 활성화하십시오.
