paramètres de session http_*

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

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.

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

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.

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

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

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.

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

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

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

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

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

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

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.