> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.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 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>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="/docs/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>Funcionalidade Beta</span>
        </a>;
};

export const ExperimentalBadge = () => {
  return <a href="/docs/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>;
};

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

<div id="allow_experimental_ai_functions">
  ## allow\_experimental\_ai\_functions
</div>

<ExperimentalBadge />

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

Ativa funções de IA experimentais (por exemplo, `aiGenerateContent`). Essas funções fazem chamadas HTTP externas para provedores de IA.

<div id="allow_experimental_analyzer">
  ## allow\_experimental\_analyzer
</div>

**Aliases**: `enable_analyzer`

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

Ativa o analisador.

<div id="allow_experimental_cleanup_old_data_files_compaction">
  ## allow\_experimental\_cleanup\_old\_data\_files\_compaction
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_codecs">
  ## allow\_experimental\_codecs
</div>

<ExperimentalBadge />

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

Se estiver definido como true, permite especificar codecs de compressão experimentais (mas ainda não temos nenhum, e essa opção não faz nada).

<div id="allow_experimental_correlated_subqueries">
  ## allow\_experimental\_correlated\_subqueries
</div>

<BetaBadge />

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

Permite executar subconsultas correlacionadas.

<div id="allow_experimental_database_glue_catalog">
  ## allow\_experimental\_database\_glue\_catalog
</div>

<BetaBadge />

**Aliases**: `allow_database_glue_catalog`

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

Permite o uso experimental do mecanismo de banco de dados DataLakeCatalog com catalog\_type = 'glue'

Valor padrão no Cloud: `1`.

<div id="allow_experimental_database_hms_catalog">
  ## allow\_experimental\_database\_hms\_catalog
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_database_iceberg">
  ## allow\_experimental\_database\_iceberg
</div>

<BetaBadge />

**Aliases**: `allow_database_iceberg`

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

Permite o uso do mecanismo de banco de dados experimental DataLakeCatalog com catalog\_type = 'iceberg'

Valor padrão no Cloud: `1`.

<div id="allow_experimental_database_materialized_postgresql">
  ## allow\_experimental\_database\_materialized\_postgresql
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_database_paimon_rest_catalog">
  ## allow\_experimental\_database\_paimon\_rest\_catalog
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_database_unity_catalog">
  ## allow\_experimental\_database\_unity\_catalog
</div>

<BetaBadge />

**Aliases**: `allow_database_unity_catalog`

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

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

Valor padrão no Cloud: `1`.

<div id="allow_experimental_delta_kernel_rs">
  ## allow\_experimental\_delta\_kernel\_rs
</div>

<BetaBadge />

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

Permite a implementação experimental do delta-kernel-rs.

<div id="allow_experimental_delta_lake_writes">
  ## allow\_experimental\_delta\_lake\_writes
</div>

<BetaBadge />

**Aliases**: `allow_delta_lake_writes`

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

Habilita o recurso de gravação do delta-kernel.

<div id="allow_experimental_eval_table_function">
  ## allow\_experimental\_eval\_table\_function
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_expire_snapshots">
  ## allow\_experimental\_expire\_snapshots
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_funnel_functions">
  ## allow\_experimental\_funnel\_functions
</div>

<ExperimentalBadge />

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

Ativa funções experimentais de análise de funil.

<div id="allow_experimental_geo_types_in_iceberg">
  ## allow\_experimental\_geo\_types\_in\_iceberg
</div>

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

Permite interpretar os tipos de campo `geometry` e `geography` do Iceberg como o tipo `Geometry` (Variant) do ClickHouse.

<div id="allow_experimental_hash_functions">
  ## allow\_experimental\_hash\_functions
</div>

<ExperimentalBadge />

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

Ativa funções de hash experimentais

<div id="allow_experimental_iceberg_compaction">
  ## allow\_experimental\_iceberg\_compaction
</div>

<ExperimentalBadge />

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

Permite usar explicitamente 'OPTIMIZE' em tabelas Iceberg.

<div id="allow_experimental_join_right_table_sorting">
  ## allow\_experimental\_join\_right\_table\_sorting
</div>

<ExperimentalBadge />

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

Se estiver definido como true e as condições de `join_to_sort_minimum_perkey_rows` e `join_to_sort_maximum_table_rows` forem atendidas, a tabela da direita será reordenada pela chave para melhorar o desempenho em left hash join ou inner hash join.

<div id="allow_experimental_json_lazy_type_hints">
  ## allow\_experimental\_json\_lazy\_type\_hints
</div>

<ExperimentalBadge />

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

Ativa as Lazy Type Hints experimentais para o tipo JSON. Esse recurso permite otimizar as conversões de tipo de JSON ao adiar a avaliação das type hints.

<div id="allow_experimental_kafka_offsets_storage_in_keeper">
  ## allow\_experimental\_kafka\_offsets\_storage\_in\_keeper
</div>

<ExperimentalBadge />

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

Permite o uso do recurso experimental para armazenar offsets do Kafka no ClickHouse Keeper. Quando habilitado, um caminho do ClickHouse Keeper e o nome da réplica podem ser especificados para o mecanismo de tabela Kafka. Como resultado, em vez do mecanismo Kafka padrão, será usado um novo tipo de motor de armazenamento que armazena os offsets confirmados principalmente no ClickHouse Keeper

<div id="allow_experimental_kusto_dialect">
  ## allow\_experimental\_kusto\_dialect
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_materialized_postgresql_table">
  ## allow\_experimental\_materialized\_postgresql\_table
</div>

<ExperimentalBadge />

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

Permite o uso do motor de tabela MaterializedPostgreSQL. Desabilitado por padrão, pois esse recurso é experimental

<div id="allow_experimental_nlp_functions">
  ## allow\_experimental\_nlp\_functions
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_nullable_tuple_type">
  ## allow\_experimental\_nullable\_tuple\_type
</div>

<BetaBadge />

**Aliases**: `enable_nullable_tuple_type`

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

Permite criar colunas [Nullable](/pt-BR/reference/data-types/nullable) [Tuple](/pt-BR/reference/data-types/tuple) em tabelas.

Essa configuração não controla se as subcolunas de tuple extraídas podem ser `Nullable` (por exemplo, de colunas Dynamic, Variant, JSON ou Tuple).
Use `allow_nullable_tuple_in_extracted_subcolumns` para controlar se as subcolunas de tuple extraídas podem ser `Nullable`.

<div id="allow_experimental_object_storage_queue_hive_partitioning">
  ## allow\_experimental\_object\_storage\_queue\_hive\_partitioning
</div>

<ExperimentalBadge />

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

Permite usar o particionamento Hive com os motores S3Queue/AzureQueue

<div id="allow_experimental_paimon_storage_engine">
  ## allow\_experimental\_paimon\_storage\_engine
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_parallel_reading_from_replicas">
  ## allow\_experimental\_parallel\_reading\_from\_replicas
</div>

**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

<div id="allow_experimental_polyglot_dialect">
  ## allow\_experimental\_polyglot\_dialect
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_prql_dialect">
  ## allow\_experimental\_prql\_dialect
</div>

<ExperimentalBadge />

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

Habilita o PRQL — uma alternativa ao SQL.

<div id="allow_experimental_time_series_aggregate_functions">
  ## allow\_experimental\_time\_series\_aggregate\_functions
</div>

<ExperimentalBadge />

**Aliases**: `allow_experimental_ts_to_grid_aggregate_function`

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

Funções de agregação experimentais timeSeries\* para reamostragem de séries temporais no estilo do Prometheus e para cálculo de taxa e delta.

<div id="allow_experimental_time_series_table">
  ## allow\_experimental\_time\_series\_table
</div>

<ExperimentalBadge />

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

Permite criar tabelas com o motor de tabela [TimeSeries](/pt-BR/reference/engines/table-engines/integrations/time-series). Valores possíveis:

* 0 — o motor de tabela [TimeSeries](/pt-BR/reference/engines/table-engines/integrations/time-series) está desabilitado.
* 1 — o motor de tabela [TimeSeries](/pt-BR/reference/engines/table-engines/integrations/time-series) está habilitado.

<div id="allow_experimental_unique_key">
  ## allow\_experimental\_unique\_key
</div>

<ExperimentalBadge />

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

Permite criar tabelas com a cláusula `UNIQUE KEY` em motores da família MergeTree.

<div id="allow_experimental_url_wildcard_from_index_pages">
  ## allow\_experimental\_url\_wildcard\_from\_index\_pages
</div>

<ExperimentalBadge />

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

Permite a expansão experimental de curingas para `url()` e `ENGINE = URL` por meio de páginas de índice HTTP.

<div id="allow_experimental_window_view">
  ## allow\_experimental\_window\_view
</div>

<ExperimentalBadge />

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

Habilita WINDOW VIEW. Ainda não está suficientemente maduro.

<div id="allow_experimental_ytsaurus_dictionary_source">
  ## allow\_experimental\_ytsaurus\_dictionary\_source
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_ytsaurus_table_engine">
  ## allow\_experimental\_ytsaurus\_table\_engine
</div>

<ExperimentalBadge />

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

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

<div id="allow_experimental_ytsaurus_table_function">
  ## allow\_experimental\_ytsaurus\_table\_function
</div>

<ExperimentalBadge />

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

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