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

# настройки сеанса analyzer_compatibility_*

> Настройки сеанса ClickHouse в автоматически созданной группе analyzer_compatibility_*.

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](/docs/ru/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. Это настройка совместимости, поскольку она меняет результат запроса. Когда она отключена, `SELECT a.b.c FROM table ARRAY JOIN a` не работает, а `SELECT a FROM table` не включает столбец `a.b.c` в результат `Nested a`.

<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": "Новая настройка совместимости. Если она включена, анализатор имитирует прежнее преобразование `HAVING` в `WHERE` для неагрегатных AND-конъюнктов вместо выдачи `NOT_AN_AGGREGATE`."}]}]} />

Если параметр включен, анализатор имитирует прежнее поведение, при котором неагрегатные AND-конъюнкты переносятся из `HAVING` в предложение WHERE вместо выдачи `NOT_AN_AGGREGATE`. Отклонение в соответствии со стандартом используется по умолчанию; эта настройка помогает при миграции запросов, которые старый анализатор (`enable_analyzer = 0`) молча принимал. Конъюнкты, содержащие агрегатные функции, `grouping` или недетерминированные функции, остаются в `HAVING`. Если хотя бы один конъюнкт содержит window function или функцию с сохранением состояния (например, `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": "Исправлена ошибка в анализаторе, из-за которой FINAL для самой левой таблицы в JOIN ошибочно применялся также к другим таблицам в JOIN. previous_value=true, поэтому `compatibility` с версиями до 26.6 восстанавливает прежнее поведение."}]}, {"id": "row-3","items": [{"label": "26.4"},{"label": "1"},{"label": "Новая настройка совместимости, определяющая, применяется ли FINAL для самой левой таблицы в JOIN к другим таблицам в JOIN. Добавлена со значением true по умолчанию (прежнее поведение) для бэкпортов в версии до 26.6."}]}]} />

Восстанавливает поведение версий до 26.6, при котором модификатор `FINAL`, указанный для самой левой таблицы в JOIN, ошибочно применялся также ко всем остальным таблицам в JOIN (для движков, поддерживающих `FINAL`, например `ReplacingMergeTree`). По умолчанию `FINAL` применяется только к таблице, для которой он указан. Включите настройку для совместимости с запросами, зависящими от прежнего поведения; рекомендуется явно указывать `FINAL` для каждой таблицы, которой он требуется.

Возможные значения:

* 0 — `FINAL` применяется только к таблице, для которой он указан.
* 1 — `FINAL` для самой левой таблицы в JOIN применяется ко всем таблицам в JOIN.

<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": "Принудительно разрешать идентификатор в JOIN USING по проекции"}]}]} />

Принудительно разрешать идентификатор в JOIN USING по проекции (например, в `SELECT a + 1 AS b FROM t1 JOIN t2 USING (b)` JOIN будет выполняться по условию `t1.a + 1 = t2.b`, а не `t1.b = t2.b`). Также учитываются псевдонимы, определённые для подвыражений внутри списка SELECT (например, в `SELECT uniqExact(a + 1 AS b) FROM t1 JOIN t2 USING (b)` JOIN выполняется по условию `t1.a + 1 = t2.b`). Если соответствующий псевдоним определён для подвыражения внутри списка SELECT, а не как псевдоним верхнего уровня, для запроса отключаются параллельные реплики. Для запросов, отправляемых на удалённые серверы (таблицы `Distributed`, табличная функция `remote`), такой запрос отклоняется с исключением, только если идентификатор вообще не может быть разрешён на удалённом сервере; если псевдоним затеняет реальный столбец левой таблицы, удалённый сервер вместо этого выполняет JOIN по этому столбцу, поэтому результаты могут отличаться от локального выполнения.

<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": "Новая настройка совместимости. Если включена, анализатор воспроизводит квалифицированные имена результирующих столбцов, которые использовал старый анализатор для запросов, в предложении FROM которых есть два или более JOIN."}]}]} />

Если настройка включена и предложение `FROM` запроса содержит два или более `JOIN` (таблицы, перечисленные через запятую, учитываются; `ARRAY JOIN` — нет), анализатор присваивает результирующим столбцам имена так же, как это делало преобразование с несколькими JOIN в старом анализаторе:

* столбцы, полученные при раскрытии `*`, `<table>.*` или `COLUMNS('<regexp>')`, получают имена вида `<alias-or-table>.<column>` (квалификатором служит псевдоним табличного выражения, если он задан, иначе имя таблицы без указания базы данных, иначе имя CTE; столбцы присоединённого подзапроса без псевдонима остаются неквалифицированными). Два типа столбцов сохраняют имя без квалификатора, поскольку относятся к JOIN, а не к отдельному табличному выражению: столбец, полученный с помощью `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` создаёт столбец с именем `a.x`, даже если `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": "Новая настройка совместимости"}]}]} />

Если составной идентификатор, такой как `b.id`, может ссылаться либо на столбец `id` таблицы с псевдонимом `b`, либо на подстолбец `b.id` типа Tuple другого столбца, будет выбрана интерпретация с префиксом-псевдонимом (столбец `id` таблицы `b`). По умолчанию анализатор предпочитает подстолбец. Включите эту настройку, чтобы использовать правила разрешения имен старого анализатора.