> ## 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 s3_*
> Configurações de sessão do ClickHouse no grupo gerado s3_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Tipo
{type}
Padrão
{default_value}
{changeable_without_restart &&
Pode ser alterado sem reiniciar
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são autogeradas a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## s3\_check\_objects\_after\_upload
Verifique cada objeto enviado ao S3 com uma requisição HEAD para garantir que o upload foi concluído com sucesso
## s3\_connect\_timeout\_ms
Timeout de conexão com o host para disks S3.
## s3\_create\_new\_file\_on\_insert
Habilita ou desabilita a criação de um novo arquivo a cada inserção em tabelas com o motor S3. Se estiver habilitado, a cada inserção será criado um novo objeto no S3 com a respectiva chave, seguindo um padrão como este:
inicial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, etc.
Valores possíveis:
* 0 — a consulta `INSERT` cria um novo arquivo ou falha se o arquivo já existir e `s3_truncate_on_insert` não estiver definido.
* 1 — a consulta `INSERT` cria um novo arquivo a cada inserção, usando um sufixo (a partir do segundo), se `s3_truncate_on_insert` não estiver definido.
Veja mais detalhes [aqui](/docs/pt-BR/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_disable\_checksum
Não calcule um checksum ao enviar um arquivo para o S3. Isso acelera as gravações ao evitar processamento excessivo no arquivo. Em geral, isso é seguro, pois os dados das tabelas MergeTree já recebem checksums do ClickHouse, e, quando o S3 é acessado via HTTPS, a camada TLS já fornece integridade durante a transferência pela rede. Ainda assim, checksums adicionais no S3 oferecem uma camada extra de proteção.
## s3\_ignore\_file\_doesnt\_exist
Ignora a ausência do arquivo ao ler determinadas chaves, caso ele não exista.
Valores possíveis:
* 1 — `SELECT` retorna resultado vazio.
* 0 — `SELECT` lança uma exceção.
## s3\_list\_object\_keys\_size
Número máximo de arquivos que podem ser retornados em lote pela requisição ListObject
## s3\_min\_upload\_part\_size
O tamanho mínimo da parte a ser enviada durante um upload multipart para o S3.
## s3\_path\_filter\_limit
Número máximo de valores de `_path` que podem ser extraídos dos filtros da consulta para serem usados na iteração de arquivos
em vez da listagem via glob. 0 significa desativado.
## s3\_request\_timeout\_ms
Tempo limite de inatividade para enviar e receber dados de/para o S3. A operação falha se uma única chamada TCP de leitura ou gravação ficar bloqueada por esse tempo.
## s3\_skip\_empty\_files
Habilita ou desabilita a opção de ignorar arquivos vazios em tabelas com o motor [S3](/docs/pt-BR/reference/engines/table-engines/integrations/s3).
Valores possíveis:
* 0 — `SELECT` lança uma exceção se o arquivo vazio não for compatível com o formato solicitado.
* 1 — `SELECT` retorna um resultado vazio para um arquivo vazio.
## s3\_slow\_all\_threads\_after\_network\_error
Quando definido como `true`, todas as threads que executam requisições ao S3 para o mesmo endpoint de backup ficam mais lentas
depois que uma única requisição ao S3 encontra um erro de rede passível de nova tentativa, como timeout de socket.
Quando definido como `false`, cada thread lida com o backoff das requisições ao S3 de forma independente das demais.
## s3\_strict\_upload\_part\_size
O tamanho exato da parte a ser enviada durante o upload multipart para o S3 (algumas implementações não oferecem suporte a partes com tamanho variável).
## s3\_throw\_on\_zero\_files\_match
Gerar um erro quando a requisição ListObjects não encontrar nenhum arquivo
## s3\_truncate\_on\_insert
Ativa ou desativa o truncamento antes de inserções em tabelas com o motor S3. Se estiver desativado, uma exceção será lançada ao tentar inserir caso um objeto S3 já exista.
Valores possíveis:
* 0 — a consulta `INSERT` cria um novo arquivo ou falha se o arquivo já existir e `s3_create_new_file_on_insert` não estiver definido.
* 1 — a consulta `INSERT` substitui o conteúdo existente do arquivo pelos novos dados.
Veja mais detalhes [aqui](/docs/pt-BR/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_uri\_style
Força o uso do estilo de endpoint do S3. Valores possíveis: auto, virtual\_hosted, path.
## s3\_use\_adaptive\_timeouts
Quando definido como `true`, nas duas primeiras tentativas de todas as requisições ao S3 são usados timeouts baixos de envio e recebimento.
Quando definido como `false`, todas as tentativas são feitas com os mesmos timeouts.