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

# configurações de sessão allow_experimental_*

> Configurações de sessão do ClickHouse no grupo allow_experimental_* gerado automaticamente.

export const ExperimentalBadge = () => {
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#experimental-features" 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>
            Recurso experimental
        </a>;
};

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["Versão", "Valor padrão", "Comentário"];
  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
  }}>
        Histórico de versões
      </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
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Essas configurações estão disponíveis em [system.settings](/pt-BR/reference/system-tables/settings) e são geradas automaticamente a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

## allow\_experimental\_analyzer

**Aliases**: `enable_analyzer`

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "1"},{"label": "A configuração está obsoleta: o analisador é obrigatório e a antiga análise de consultas não é mais compatível. Desabilitá-lo é recusado em vez de ignorado, e a `compatibility` com uma versão anterior à 24.3 não o reverte mais."}]}, {"id": "row-2","items": [{"label": "24.3"},{"label": "1"},{"label": "Habilita o analisador e o planner por padrão."}]}]} />

Obsoleto desde a v26.9: o analisador não pode mais ser desabilitado.

O analisador é a infraestrutura de análise e planejamento de consultas adotada por padrão desde a v24.3. Na v26.9, esta configuração foi congelada em seu único valor compatível, `1`: qualquer tentativa de defini-la como `0` é rejeitada, e a configuração `compatibility` não a reverte mais. Na v26.10, a análise de consultas para a qual ela alternava foi removida. Remova `enable_analyzer = 0` de consultas, configurações de sessão, settings profiles e configurações de client. Para comparar o comportamento ou o desempenho de uma consulta com a antiga análise de consultas, use uma versão do ClickHouse anterior à v26.9.

## allow\_experimental\_cleanup\_old\_data\_files\_compaction

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Permite a limpeza de arquivos de dados antigos durante a compactação do Iceberg.

## allow\_experimental\_database\_hms\_catalog

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "0"},{"label": "Permite o mecanismo de banco de dados experimental DataLakeCatalog com catalog_type = 'hive'"}]}]} />

Permite o mecanismo de banco de dados experimental DataLakeCatalog com catalog\_type = 'hms'

## allow\_experimental\_database\_materialized\_postgresql

<ExperimentalBadge />

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

Permite a criação de um database com Engine=MaterializedPostgreSQL(...).

## allow\_experimental\_database\_paimon\_rest\_catalog

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Permite usar o mecanismo de banco de dados experimental DataLakeCatalog com catalog\_type = 'paimon\_rest'

## allow\_experimental\_eval\_table\_function

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "Nova configuração para ativar a função de tabela experimental `eval`."}]}]} />

Ativa a função de tabela experimental `eval`.

## allow\_experimental\_expire\_snapshots

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Permite a execução do comando experimental do Iceberg `ALTER TABLE ... EXECUTE expire_snapshots`.

## allow\_experimental\_hash\_functions

<ExperimentalBadge />

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

Ativa funções de hash experimentais

## allow\_experimental\_iceberg\_compaction

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Permite usar explicitamente 'OPTIMIZE' em tabelas Iceberg.

## allow\_experimental\_kusto\_dialect

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Uma nova configuração"}]}]} />

Habilita o dialeto Kusto Query Language (KQL), uma alternativa ao SQL.

## allow\_experimental\_nlp\_functions

<ExperimentalBadge />

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

Ativa funções experimentais de processamento de linguagem natural.

## allow\_experimental\_object\_storage\_queue\_hive\_partitioning

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Permite usar o particionamento Hive com os motores S3Queue/AzureQueue

## allow\_experimental\_paimon\_storage\_engine

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Permite criar tabelas com os motores de tabela Paimon\*.

## allow\_experimental\_parallel\_reading\_from\_replicas

**Aliases**: `enable_parallel_replicas`

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

Use até `max_parallel_replicas` réplicas de cada shard para a execução de consultas SELECT. A leitura é paralelizada e coordenada dinamicamente. 0 - desabilitado, 1 - habilitado, desabilita silenciosamente em caso de falha, 2 - habilitado, gera uma exceção em caso de falha

## allow\_experimental\_polyglot\_dialect

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "Nova configuração para ativar o dialeto do transpilador SQL poliglota."}]}]} />

Ativa o transpilador SQL poliglota - transpila SQL de mais de 30 dialetos (MySQL, PostgreSQL, SQLite, Snowflake, DuckDB etc.) para ClickHouse SQL.

## allow\_experimental\_prql\_dialect

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Habilita o PRQL — uma alternativa ao SQL.

## allow\_experimental\_ytsaurus\_dictionary\_source

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Fonte de dicionário experimental para integração com o YTsaurus.

## allow\_experimental\_ytsaurus\_table\_engine

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Motor de tabela experimental para integração com o YTsaurus.

## allow\_experimental\_ytsaurus\_table\_function

<ExperimentalBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "Nova configuração."}]}]} />

Motor de tabela experimental para integração com YTsaurus.