clickhouse-format

clickhouse-format

clickhouse-format은 입력 쿼리의 서식을 정리해 주는 도구예요. 구문 강조, 한 줄 포맷팅, 난독화 등 다양한 옵션을 지원합니다.

출처: 문서

본문

입력 쿼리의 서식을 정리할 수 있습니다.

키:

  • --help 또는 -h — 도움말 메시지를 출력합니다.
  • --query — 길이와 복잡도에 관계없이 쿼리의 서식을 정리합니다.
  • --hilite 또는 --highlight — ANSI 터미널 이스케이프 시퀀스로 구문 강조를 추가합니다.
  • --oneline — 한 줄로 서식을 정리합니다.
  • --max_line_length — 지정된 길이보다 짧은 쿼리를 한 줄로 서식을 정리합니다.
  • --comments — 출력에 주석을 유지합니다.
  • --quiet 또는 -q — 구문만 검사하고, 성공 시 출력하지 않습니다.
  • --multiquery 또는 -n — 같은 파일에 여러 쿼리를 허용합니다.
  • --obfuscate — 서식 정리 대신 난독화합니다.
  • --seed <string> — 난독화 결과를 결정하는 임의의 문자열 시드를 지정합니다.
  • --backslash — 서식이 정리된 쿼리의 각 줄 끝에 백슬래시를 추가합니다. 웹이나 다른 곳에서 여러 줄로 된 쿼리를 복사해서 명령줄에서 실행하려 할 때 유용합니다.
  • --semicolons_inline — multiquery 모드에서 세미콜론을 새 줄 대신 쿼리의 마지막 줄에 작성합니다.

예시 (Examples)

  1. 쿼리 서식 정리:

쿼리

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

응답

SELECT number
FROM numbers(10)
WHERE number % 2
ORDER BY number DESC
  1. 강조 및 한 줄:

쿼리

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

응답

SELECT sum(number) FROM numbers(5)
  1. 다중 쿼리:

쿼리

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

응답

SELECT min(number)
FROM numbers(5)
;

SELECT max(number)
FROM numbers(5)
;
  1. 난독화:

쿼리

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

응답

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

같은 쿼리에 다른 시드 문자열:

쿼리

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

응답

SELECT horse_tape_summer BETWEEN folklore AND moccasins, CASE WHEN intestine >= 116 THEN nonconformist ELSE FORESTRY END;
  1. 백슬래시 추가:

쿼리

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

응답

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

더 알아보기 (Learn more)