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

# configurações de sessão de log_queries_*

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

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](/docs/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="log_queries">
  ## log\_queries
</div>

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

Configura o registro de consultas.

As consultas enviadas ao ClickHouse com essa configuração são registradas de acordo com as regras do parâmetro de configuração do servidor [query\_log](/docs/pt-BR/reference/settings/server-settings/settings#query_log).

Exemplo:

```text theme={null}
log_queries=1
```

<div id="log_queries_cut_to_length">
  ## log\_queries\_cut\_to\_length
</div>

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

Se o comprimento da consulta for maior que um limite especificado (em bytes), a consulta será truncada ao ser gravada no query log. O comprimento da consulta exibida no log de texto comum também será limitado.

<div id="log_queries_min_query_duration_ms">
  ## log\_queries\_min\_query\_duration\_ms
</div>

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

Se estiver ativada (valor diferente de zero), as consultas mais rápidas do que o valor dessa configuração não serão registradas (você pode pensar nisso como um `long_query_time` para o [MySQL Slow Query Log](https://dev.mysql.com/doc/refman/5.7/slow-query-log.html)), o que basicamente significa que você não as encontrará nas tabelas a seguir:

* `system.query_log`
* `system.query_thread_log`

Somente as consultas do tipo a seguir serão registradas no log:

* `QUERY_FINISH`

* `EXCEPTION_WHILE_PROCESSING`

* Tipo: milissegundos

* Valor padrão: 0 (qualquer consulta)

<div id="log_queries_min_type">
  ## log\_queries\_min\_type
</div>

<SettingsInfoBlock type="LogQueriesType" default_value="QUERY_START" />

Tipo mínimo do `query_log` a ser registrado.

Valores possíveis:

* `QUERY_START` (`=1`)
* `QUERY_FINISH` (`=2`)
* `EXCEPTION_BEFORE_START` (`=3`)
* `EXCEPTION_WHILE_PROCESSING` (`=4`)

Pode ser usado para limitar quais entidades serão enviadas para o `query_log`; por exemplo, se você estiver interessado apenas em erros, pode usar `EXCEPTION_WHILE_PROCESSING`:

```text theme={null}
log_queries_min_type='EXCEPTION_WHILE_PROCESSING'
```

<div id="log_queries_probability">
  ## log\_queries\_probability
</div>

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

Permite que apenas uma amostra das consultas, selecionadas aleatoriamente com a probabilidade especificada, seja gravada nas tabelas de sistema [query\_log](/docs/pt-BR/reference/system-tables/query_log), [query\_thread\_log](/docs/pt-BR/reference/system-tables/query_thread_log) e [query\_views\_log](/docs/pt-BR/reference/system-tables/query_views_log). Isso ajuda a reduzir a carga quando há um grande volume de consultas por segundo.

Valores possíveis:

* 0 — As consultas não são registradas nas tabelas de sistema.
* Número de ponto flutuante positivo no intervalo \[0..1]. Por exemplo, se o valor da configuração for `0.5`, cerca de metade das consultas será registrada nas tabelas de sistema.
* 1 — Todas as consultas são registradas nas tabelas de sistema.