Skip to main content
Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du source.

http_allow_database_as_path

Lorsqu’elle est activée, l’interface HTTP reconnaît le composant /database/ dans le chemin d’URL et l’utilise comme base de données courante. Ce paramètre, défini par utilisateur, détermine si une requête de type chemin routée est interprétée. Le routage lui-même est contrôlé globalement par le paramètre de configuration http_allow_path_requests au niveau du serveur (désactivé par défaut). Celui-ci doit être activé pour que l’interface HTTP route une requête de type chemin (telle que /my_db/my_table.csv) vers le gestionnaire de requêtes. Cette décision de routage étant prise avant l’authentification de la requête, elle ne peut pas dépendre d’un paramètre par utilisateur. Lorsque http_allow_path_requests est désactivé, les chemins inconnus renvoient simplement un 404. Après le routage, ce paramètre est vérifié à nouveau au regard des paramètres effectifs de l’utilisateur authentifié, ce qui permet de l’activer de manière sélective pour un utilisateur, un rôle ou un profil.

http_allow_filters_as_path

Lorsqu’elle est activée, l’interface HTTP reconnaît les composants /name=value/ dans le chemin (style de partitionnement Hive) et les traduit en filtres combinés par AND. Les opérateurs >, <, >=, <=, !=, <> sont également reconnus. Comme http_allow_database_as_path, il s’agit d’un paramètre par utilisateur ; le routage des requêtes avec chemin est contrôlé globalement par le paramètre de configuration http_allow_path_requests au niveau du serveur (le routage a lieu avant l’authentification).

http_allow_filters_as_unrecognized_url_parameters

Si cette option est activée, tout paramètre d’URL non reconnu comme paramètre, réglage ou préfixe param_* connu est traité comme un filtre et combiné avec AND. Deux formes sont acceptées :
  • Un simple name=value devient une expression d’égalité : `name` = 'value' (l’identifiant est entouré d’accents graves et la valeur est entre guillemets en tant que littéral de chaîne).
  • Un opérateur de comparaison (!=, >, <, >=, <=, <>) en fait une comparaison : soit séparé dans le paramètre (?a!=2, ?a>=2), soit écrit directement lorsque l’URL ne contient aucun = permettant de le séparer (?a<>2, ?f(x)>3) ; dans ce cas, le name[=value] reconstitué est analysé comme une expression SQL complète.

http_allow_table_as_file

Lorsqu’elle est activée, l’interface HTTP interprète le dernier composant du chemin d’URL comme un nom de table sous la forme table, table.format ou table.format.compression. Le chemin est interprété comme SELECT * FROM table. Comme http_allow_database_as_path, il s’agit d’un paramètre par utilisateur ; le routage des requêtes avec un chemin d’URL est contrôlé globalement par le paramètre de configuration http_allow_path_requests au niveau du serveur (le routage s’effectue avant l’authentification).

http_connection_timeout

Délai d’expiration d’une connexion HTTP (en secondes). Valeurs possibles :
  • N’importe quel entier positif.
  • 0 - Désactivé (délai d’expiration infini).

http_make_head_request

Le paramètre http_make_head_request permet d’exécuter une requête HEAD lors de la lecture de données via HTTP afin de récupérer des informations sur le fichier à lire, telles que sa taille. Comme il est activé par défaut, il peut être utile de désactiver ce paramètre lorsque le server ne prend pas en charge les requêtes HEAD.

http_native_compression_disable_checksumming_on_decompress

Active ou désactive la vérification de la somme de contrôle lors de la décompression des données de requête HTTP POST envoyées par le client. Utilisé uniquement avec le format de compression natif de ClickHouse (pas avec gzip ou deflate). Pour plus d’informations, consultez la description de l’interface HTTP. Valeurs possibles :
  • 0 — Désactivé.
  • 1 — Activé.

http_receive_timeout

Délai d’expiration pour la réception HTTP (en secondes). Valeurs possibles :
  • Tout entier positif (secondes). 0 n’est pas un délai d’expiration infini et peut entraîner des échecs lors de l’établissement de la connexion (les délais d’expiration des sockets POSIX nécessitent un intervalle positif).

http_send_timeout

Délai d’expiration d’envoi HTTP (en secondes). Valeurs possibles :
  • Tout entier positif (secondes). 0 n’est pas un délai d’expiration infini et peut entraîner des échecs d’établissement de connexion (les délais d’expiration des sockets POSIX nécessitent un intervalle positif).
Cela s’applique uniquement au profil par défaut. Un redémarrage du serveur est nécessaire pour que les modifications prennent effet.

http_skip_not_found_url_for_globs

Ignorer les URL correspondant à des globs en cas d’erreur HTTP_NOT_FOUND

http_wait_end_of_query

Active la mise en mémoire tampon des réponses HTTP côté serveur.

http_write_exception_in_output_format

Écrit l’exception dans le format de sortie pour produire une sortie valide. Fonctionne avec les formats JSON et XML.

http_zlib_compression_level

Définit le niveau de compression des données dans la réponse à une requête HTTP si enable_http_compression = 1. Valeurs possibles : nombres de 1 à 12. Les niveaux supérieurs à 9 nécessitent le build par défaut avec libdeflate ; un build sans libdeflate prend en charge les niveaux de 1 à 9.
Dernière modification le 18 août 2026