> ## 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.
# paramètres de session s3_*
> Paramètres de session ClickHouse du groupe généré s3_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Type
{type}
Par défaut
{default_value}
{changeable_without_restart &&
Modifiable sans redémarrage
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
Ces paramètres sont disponibles dans [system.settings](/docs/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [code source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## s3\_check\_objects\_after\_upload
Vérifiez chaque objet téléversé vers S3 à l’aide d’une requête head pour vous assurer que le téléversement a bien réussi
## s3\_connect\_timeout\_ms
Délai d’expiration de connexion à l’hôte pour les disques S3.
## s3\_create\_new\_file\_on\_insert
Active ou désactive la création d’un nouveau fichier à chaque insertion dans les tables du moteur S3. Si cette option est activée, un nouvel objet S3 est créé à chaque insertion avec cette clé, selon un schéma comme celui-ci :
initial : `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, etc.
Valeurs possibles :
* 0 — la requête `INSERT` crée un nouveau fichier, ou échoue si le fichier existe et que s3\_truncate\_on\_insert n’est pas défini.
* 1 — la requête `INSERT` crée un nouveau fichier à chaque insertion en utilisant un suffixe (à partir du deuxième) si s3\_truncate\_on\_insert n’est pas défini.
Voir plus de détails [ici](/docs/fr/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_disable\_checksum
Ne calcule pas de somme de contrôle lors de l’envoi d’un fichier vers S3. Cela accélère les écritures en évitant des traitements excessifs sur le fichier. C’est généralement sûr, car les données des tables MergeTree sont de toute façon protégées par des sommes de contrôle calculées par ClickHouse et, lorsque S3 est accessible via HTTPS, la couche TLS garantit déjà l’intégrité pendant le transfert sur le réseau. Des sommes de contrôle supplémentaires sur S3 ajoutent toutefois une défense en profondeur.
## s3\_ignore\_file\_doesnt\_exist
Ignorer l'absence d'un fichier lors de la lecture de certaines clés.
Valeurs possibles :
* 1 — `SELECT` renvoie un résultat vide.
* 0 — `SELECT` lève une exception.
## s3\_list\_object\_keys\_size
Nombre maximal de fichiers pouvant être renvoyés en lot par la requête ListObject
## s3\_min\_upload\_part\_size
La taille minimale de la partie à téléverser lors d’un téléversement multipartite vers S3.
## s3\_path\_filter\_limit
Nombre maximal de valeurs `_path` pouvant être extraites des filtres de requête pour parcourir les fichiers
au lieu d’utiliser un listage par glob. 0 signifie désactivé.
## s3\_request\_timeout\_ms
Délai d’expiration d’inactivité pour l’envoi et la réception de données vers/depuis S3. L’opération échoue si un seul appel TCP de lecture ou d’écriture reste bloqué aussi longtemps.
## s3\_skip\_empty\_files
Active ou désactive l’ignorance des fichiers vides dans les tables utilisant le moteur [S3](/docs/fr/reference/engines/table-engines/integrations/s3).
Valeurs possibles :
* 0 — `SELECT` lève une exception si le fichier vide n’est pas compatible avec le format demandé.
* 1 — `SELECT` renvoie un résultat vide pour un fichier vide.
## s3\_slow\_all\_threads\_after\_network\_error
Lorsque cette option est définie sur `true`, tous les threads exécutant des requêtes S3 vers le même endpoint de sauvegarde sont ralentis
dès qu’une seule requête S3 rencontre une erreur réseau pouvant donner lieu à un réessai, comme un timeout de socket.
Lorsque cette option est définie sur `false`, chaque thread gère le backoff des requêtes S3 indépendamment des autres.
## s3\_strict\_upload\_part\_size
La taille exacte de la partie à téléverser lors d'un téléversement multipartite vers S3 (certaines implémentations ne prennent pas en charge les parties de taille variable).
## s3\_throw\_on\_zero\_files\_match
Déclenche une erreur lorsque la requête ListObjects ne correspond à aucun fichier
## s3\_truncate\_on\_insert
Active ou désactive la troncature avant les insertions dans les tables utilisant le moteur S3. Si cette option est désactivée, une exception sera levée lors d’une tentative d’insertion si un objet S3 existe déjà.
Valeurs possibles :
* 0 — la requête `INSERT` crée un nouveau fichier, ou échoue si le fichier existe et que s3\_create\_new\_file\_on\_insert n’est pas défini.
* 1 — la requête `INSERT` remplace le contenu existant du fichier par les nouvelles données.
Voir plus de détails [ici](/docs/fr/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## s3\_uri\_style
Force le style de l’endpoint S3. Valeurs possibles : auto, virtual\_hosted, path.
## s3\_use\_adaptive\_timeouts
Lorsque ce paramètre est défini sur `true`, les deux premières tentatives de toutes les requêtes S3 utilisent des délais d'envoi et de réception courts.
Lorsque ce paramètre est défini sur `false`, toutes les tentatives utilisent des délais identiques.