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 (activé 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 le désactiver 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, paramètre de configuration ou préfixeparam_* connu est traité comme un filtre et combiné avec AND. Deux formes sont acceptées :
- Un simple
name=valuedevient 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, lename[=value]reconstitué est analysé comme une expression SQL complète.
http_allow_* : il s’applique à toutes les requêtes de l’interface HTTP, y compris l’endpoint /?query=.... Son activation transforme donc tout paramètre d’URL non reconnu ajouté par un client (un identifiant de requête, une signature, un paramètre anti-cache) en filtre de la requête. Un nom de paramètre mal orthographié n’est alors plus signalé par UNKNOWN_SETTING, mais provoque une erreur UNKNOWN_IDENTIFIER (ou, si le nom correspond par hasard à une colonne, filtre silencieusement le résultat), et la valeur du paramètre est intégrée au texte de la requête, où elle n’est pas masquée, contrairement au Request URI dans le journal.
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 formetable, 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ètrehttp_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 avecgzip 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).
0n’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).
0n’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_FOUNDhttp_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_x_clickhouse_format_overrides_output_format
Détermine à quel paramètre correspond l’en-tête HTTPX-ClickHouse-Format.
S’il est activé (valeur par défaut), l’en-tête est un alias du paramètre output_format : il constitue une surcharge explicite du format de réponse, qui prime sur la clause FORMAT de la requête et sur l’extension de fichier présente dans le chemin d’URL.
S’il est désactivé, l’en-tête est un alias du paramètre default_format, comme avant la version 26.8 : il se contente de sélectionner le format utilisé lorsque la requête ne comporte pas de clause FORMAT et qu’aucune autre surcharge de format n’est appliquée.
Dans les deux cas, l’en-tête prime sur le paramètre d’URL du même nom (respectivement output_format ou default_format) et ne modifie jamais la manière dont le corps de requête d’un INSERT est analysé.
Il s’agit d’un paramètre de compatibilité pour l’interface HTTP : l’en-tête étant traité avant l’analyse de la requête, ce paramètre doit être fourni via un paramètre d’URL ou un profil utilisateur, et non via une clause SETTINGS dans la requête. Comme output_format et default_format, il peut toujours être modifié en mode lecture seule (readonly = 1) : un utilisateur en lecture seule peut donc le transmettre comme paramètre d’URL.
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.