perevod na russkiy

docs/en/operations/utilities/clickhouse-format.md

@@ -11,7 +11,6 @@ Keys:
 
 - `--help` or`-h` — Produce help message.
 - `--query` — Format queries of any length and complexity.
-
 - `--hilite` — Add syntax highlight with ANSI terminal escape sequences.
 - `--oneline` — Format in single line.
 - `--quiet` or `-q` — Just check syntax, no output on success.

docs/ru/operations/utilities/clickhouse-format.md

@@ -10,6 +10,7 @@ toc_title: clickhouse-format
 Ключи:
 
 - `--help` или`-h` — выводит описание ключей.
+- `--query` — форматирует запрос любой длины и сложности.
 - `--hilite` — добавляет подсветку синтаксиса с экранированием символов.
 - `--oneline` — форматирование в одну строку.
 - `--quiet` или `-q` — проверяет синтаксис без вывода результата.
@@ -20,7 +21,22 @@ toc_title: clickhouse-format
 
 ## Примеры {#examples}
 
-1. Подсветка синтаксиса и форматирование в одну строку:
+1. Форматирование запроса:
+
+```bash
+$ clickhouse-format --query "select number from numbers(10) where number%2 order by number desc;"
+```
+
+Результат:
+
+```sql
+SELECT number
+FROM numbers(10)
+WHERE number % 2
+ORDER BY number DESC
+```
+
+2. Подсветка синтаксиса и форматирование в одну строку:
 
 ```bash
 $ clickhouse-format --oneline --hilite <<< "SELECT sum(number) FROM numbers(5);"
@@ -32,7 +48,7 @@ $ clickhouse-format --oneline --hilite <<< "SELECT sum(number) FROM numbers(5);"
 SELECT sum(number) FROM numbers(5)
 ```
 
-2. Несколько запросов в одной строке:
+3. Несколько запросов в одной строке:
 
 ```bash
 $ clickhouse-format -n <<< "SELECT * FROM (SELECT 1 AS x UNION ALL SELECT 1 UNION DISTINCT SELECT 3);"
@@ -53,7 +69,7 @@ FROM
 ;
 ```
 
-3. Обфускация:
+4. Обфускация:
 
 ```bash
 $ clickhouse-format --seed Hello --obfuscate <<< "SELECT cost_first_screen BETWEEN a AND b, CASE WHEN x >= 123 THEN y ELSE NULL END;"
@@ -77,7 +93,7 @@ $ clickhouse-format --seed World --obfuscate <<< "SELECT cost_first_screen BETWE
 SELECT horse_tape_summer BETWEEN folklore AND moccasins, CASE WHEN intestine >= 116 THEN nonconformist ELSE FORESTRY END;
 ```
 
-4. Добавление обратного слеша:
+5. Добавление обратного слеша:
 
 ```bash
 $ clickhouse-format --backslash <<< "SELECT * FROM (SELECT 1 AS x UNION ALL SELECT 1 UNION DISTINCT SELECT 3);"