clickhouse-format - ClickHouse Documentation

Permet de formater les requêtes d’entrée. Options :

--help ou -h — Affiche le message d’aide.
--query — Formate des requêtes de toute longueur et complexité.
--hilite ou --highlight — Ajoute une coloration syntaxique avec des séquences d’échappement ANSI du terminal.
--oneline — Formate sur une seule ligne.
--max_line_length — Formate sur une seule ligne les requêtes dont la longueur est inférieure à la valeur spécifiée.
--comments — Conserve les commentaires dans la sortie.
--quiet ou -q — Vérifie uniquement la syntaxe, sans sortie en cas de succès.
--multiquery ou -n — Autorise plusieurs requêtes dans le même fichier.
--obfuscate — Obfusque au lieu de formater.
--seed <string> — Chaîne arbitraire servant de graine et déterminant le résultat de l’obfuscation.
--backslash — Ajoute une barre oblique inverse à la fin de chaque ligne de la requête formatée. Cela peut être utile lorsque vous copiez une requête depuis le Web ou ailleurs sur plusieurs lignes et souhaitez l’exécuter en ligne de commande.
--semicolons_inline — En mode multiquery, écrit les points-virgules sur la dernière ligne de la requête plutôt que sur une nouvelle ligne.

Exemples

Query

$ clickhouse-format --query "select number from numbers(10) where number%2 order by number desc;"

Response

SELECT number
FROM numbers(10)
WHERE number % 2
ORDER BY number DESC

Query

$ clickhouse-format --oneline --hilite <<< "SELECT sum(number) FROM numbers(5);"

Response

SELECT sum(number) FROM numbers(5)

Query

$ clickhouse-format -n <<< "SELECT min(number) FROM numbers(5); SELECT max(number) FROM numbers(5);"

Response

SELECT min(number)
FROM numbers(5)
;

SELECT max(number)
FROM numbers(5)
;

Query

$ clickhouse-format --seed Hello --obfuscate <<< "SELECT cost_first_screen BETWEEN a AND b, CASE WHEN x >= 123 THEN y ELSE NULL END;"

Response

SELECT treasury_mammoth_hazelnut BETWEEN nutmeg AND span, CASE WHEN chive >= 116 THEN switching ELSE ANYTHING END;

Même requête, avec une autre chaîne d’initialisation :

Query

$ clickhouse-format --seed World --obfuscate <<< "SELECT cost_first_screen BETWEEN a AND b, CASE WHEN x >= 123 THEN y ELSE NULL END;"

Response

SELECT horse_tape_summer BETWEEN folklore AND moccasins, CASE WHEN intestine >= 116 THEN nonconformist ELSE FORESTRY END;

Query

$ clickhouse-format --backslash <<< "SELECT * FROM (SELECT 1 AS x UNION ALL SELECT 1 UNION DISTINCT SELECT 3);"

Response

SELECT * \
FROM  \
( \
    SELECT 1 AS x \
    UNION ALL \
    SELECT 1 \
    UNION DISTINCT \
    SELECT 3 \
)