Merge pull request #17863 from qianmoQ/fix-docs

Fix docs

docs/zh/interfaces/cli.md

-# 命令行客户端 {#ming-ling-xing-ke-hu-duan}
+---
+toc_priority: 17
+toc_title: 命令行客户端
+---
 
-通过命令行来访问 ClickHouse，您可以使用 `clickhouse-client`
+# 命令行客户端 {#command-line-client}
+
+ClickHouse提供了一个原生命令行客户端`clickhouse-client`客户端支持命令行支持的更多信息详见[Configuring](#interfaces_cli_configuration)。
+
+[安装部署](../getting-started/index.md)后，系统默认会安装`clickhouse-client`(同时它属于`clickhouse-client`安装包中)。
 
 ``` bash
 $ clickhouse-client
-ClickHouse client version 0.0.26176.
-Connecting to localhost:9000.
-Connected to ClickHouse server version 0.0.26176.:)
+ClickHouse client version 19.17.1.1579 (official build).
+Connecting to localhost:9000 as user default.
+Connected to ClickHouse server version 19.17.1 revision 54428.
+
+:)
 ```
 
-该客户端支持命令行参数以及配置文件。查看更多，请看 «[配置](#interfaces_cli_configuration)»
+不同的客户端和服务器版本彼此兼容，但是一些特性可能在旧客户机中不可用。我们建议使用与服务器应用相同版本的客户端。当你尝试使用旧版本的客户端时，服务器上的`clickhouse-client`会显示如下信息:
 
-## 使用方式 {#shi-yong-fang-shi}
+      ClickHouse client version is older than ClickHouse server. It may lack support for new features.
 
-这个客户端可以选择使用交互式与非交互式（批量）两种模式。
-使用批量模式，要指定 `query` 参数，或者发送数据到 `stdin`（它会检查 `stdin` 是否是 Terminal），或者两种同时使用。
-它与 HTTP 接口很相似，当使用 `query` 参数发送数据到 `stdin` 时，客户端请求就是一行一行的 `stdin` 输入作为 `query` 的参数。这种方式在大规模的插入请求中非常方便。
+## 使用方式 {#cli_usage}
 
-使用这个客户端插入数据的示例：
+客户端可以在交互和非交互(批处理)模式下使用。要使用批处理模式，请指定`query`参数，或将数据发送到`stdin`(它会验证`stdin`是否是终端)，或两者同时进行。与HTTP接口类似，当使用`query`参数并向`stdin`发送数据时，客户端请求就是一行一行的`stdin`输入作为`query`的参数。这种方式在大规模的插入请求中非常方便。
+
+使用客户端插入数据的示例：
 
 ``` bash
-echo -ne "1, 'some text', '2016-08-14 00:00:00'\n2, 'some more text', '2016-08-14 00:00:01'" | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
+$ echo -ne "1, 'some text', '2016-08-14 00:00:00'\n2, 'some more text', '2016-08-14 00:00:01'" | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
 
-cat <<_EOF | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
+$ cat <<_EOF | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
 3, 'some text', '2016-08-14 00:00:00'
 4, 'some more text', '2016-08-14 00:00:01'
 _EOF
 
-cat file.csv | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
+$ cat file.csv | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
 ```
 
-在批量模式中，默认的数据格式是 `TabSeparated` 分隔的。您可以根据查询来灵活设置 FORMAT 格式。
+在批量模式中，默认的数据格式是`TabSeparated`分隔的。您可以根据查询来灵活设置FORMAT格式。
 
-默认情况下，在批量模式中只能执行单个查询。为了从一个 Script 中执行多个查询，可以使用 `--multiquery` 参数。除了 INSERT 请求外，这种方式在任何地方都有用。查询的结果会连续且不含分隔符地输出。
-同样的，为了执行大规模的查询，您可以为每个查询执行一次 `clickhouse-client`。但注意到每次启动 `clickhouse-client` 程序都需要消耗几十毫秒时间。
+默认情况下，在批量模式中只能执行单个查询。为了从一个Script中执行多个查询，可以使用`--multiquery`参数。除了INSERT请求外，这种方式在任何地方都有用。查询的结果会连续且不含分隔符地输出。
+同样的，为了执行大规模的查询，您可以为每个查询执行一次`clickhouse-client`。但注意到每次启动`clickhouse-client`程序都需要消耗几十毫秒时间。
 
 在交互模式下，每条查询过后，你可以直接输入下一条查询命令。
 
-如果 `multiline` 没有指定（默认没指定）：为了执行查询，按下 Enter 即可。查询语句不是必须使用分号结尾。如果需要写一个多行的查询语句，可以在换行之前输入一个反斜杠`\`，然后在您按下 Enter 键后，您就可以输入当前语句的下一行查询了。
+如果`multiline`没有指定（默认没指定）：为了执行查询，按下Enter即可。查询语句不是必须使用分号结尾。如果需要写一个多行的查询语句，可以在换行之前输入一个反斜杠`\`，然后在您按下Enter键后，您就可以输入当前语句的下一行查询了。
 
-如果 `multiline` 指定了：为了执行查询，需要以分号结尾并且按下 Enter 键。如果行末没有分号，将认为当前语句并没有输入完而要求继续输入下一行。
+如果指定了`multiline`：为了执行查询，需要以分号结尾并且按下Enter键。如果行末没有分号，将认为当前语句并没有输入完而要求继续输入下一行。
 
 若只运行单个查询，分号后面的所有内容都会被忽略。
 
-您可以指定 `\G` 来替代分号或者在分号后面，这表示 `Vertical` 的格式。在这种格式下，每一个值都会打印在不同的行中，这种方式对于宽表来说很方便。这个不常见的特性是为了兼容 MySQL 命令而加的。
+您可以指定`\G`来替代分号或者在分号后面，这表示使用`Vertical`的格式。在这种格式下，每一个值都会打印在不同的行中，这种方式对于宽表来说很方便。这个不常见的特性是为了兼容MySQL命令而加的。
 
-命令行客户端是基于 `replxx`。换句话说，它可以使用我们熟悉的快捷键方式来操作以及保留历史命令。
-历史命令会写入在 `~/.clickhouse-client-history` 中。
+命令行客户端是基于`replxx`(类似于`readline`)。换句话说，它可以使用我们熟悉的快捷键方式来操作以及保留历史命令。
+历史命令会写入在`~/.clickhouse-client-history`中。
 
-默认情况下，输出的格式是 `PrettyCompact`。您可以通过 FORMAT 设置根据不同查询来修改格式，或者通过在查询末尾指定 `\G` 字符，或通过在命令行中使用 `--format` 或 `--vertical` 参数，或使用客户端的配置文件。
+默认情况下，输出的格式是`PrettyCompact`。您可以通过FORMAT设置根据不同查询来修改格式，或者通过在查询末尾指定`\G`字符，或通过在命令行中使用`--format`或`--vertical`参数，或使用客户端的配置文件。
 
-若要退出客户端，使用 Ctrl+D （或 Ctrl+C），或者输入以下其中一个命令：`exit`, `quit`, `logout`, `учше`, `йгше`, `дщпщге`, `exit;`, `quit;`, `logout;`, `учшеж`, `йгшеж`, `дщпщгеж`, `q`, `й`, `q`, `Q`, `:q`, `й`, `Й`, `Жй`
+若要退出客户端，使用Ctrl+D（或Ctrl+C），或者输入以下其中一个命令：`exit`, `quit`, `logout`, `учше`, `йгше`, `дщпщге`, `exit;`, `quit;`, `logout;`, `q`, `Q`, `:q`
 
 当执行一个查询的时候，客户端会显示：
 
-1.  进度, 进度会每秒更新十次 （默认情况下）。 对于很快的查询，进度可能没有时间显示。
+1.  进度, 进度会每秒更新十次（默认情况下）。对于很快的查询，进度可能没有时间显示。
 2.  为了调试会显示解析且格式化后的查询语句。
 3.  指定格式的输出结果。
 4.  输出结果的行数的行数，经过的时间，以及查询处理的速度。
 
-您可以通过 Ctrl+C 来取消一个长时间的查询。然而，您依然需要等待服务端来中止请求。在某个阶段去取消查询是不可能的。如果您不等待并再次按下 Ctrl + C，客户端将会退出。
+您可以通过Ctrl+C来取消一个长时间的查询。然而，您依然需要等待服务端来中止请求。在某个阶段去取消查询是不可能的。如果您不等待并再次按下Ctrl + C,客户端将会退出。
+
+命令行客户端允许通过外部数据（外部临时表）来查询。更多相关信息，请参考 «[外部数据查询处理](../engines/table-engines/special/external-data.md)».
+
+### 查询参数 {#cli-queries-with-parameters}
+
+您可以创建带有参数的查询，并将值从客户端传递给服务器。这允许避免在客户端使用特定的动态值格式化查询。例如:
+
+``` bash
+$ clickhouse-client --param_parName="[1, 2]"  -q "SELECT * FROM table WHERE a = {parName:Array(UInt16)}"
+```
+
+#### 查询语法 {#cli-queries-with-parameters-syntax}
+
+像平常一样格式化一个查询，然后把你想要从app参数传递到查询的值用大括号格式化，格式如下:
+
+``` sql
+{<name>:<data type>}
+```
 
-命令行客户端允许通过外部数据 （外部临时表） 来查询。更多相关信息，请参考 «[外部数据查询处理](../engines/table-engines/special/external-data.md)».
+-   `name` — 占位符标识符。在控制台客户端，使用`--param_<name> = value`来指定
+-   `data type` — [数据类型](../sql-reference/data-types/index.md)参数值。例如，一个数据结构`(integer, ('string', integer))`拥有`Tuple(UInt8, Tuple(String, UInt8))`数据类型(你也可以用另一个[integer](../sql-reference/data-types/int-uint.md)类型)。
+
+#### 示例 {#example}
+
+``` bash
+$ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" -q "SELECT * FROM table WHERE val = {tuple_in_tuple:Tuple(UInt8, Tuple(String, UInt8))}"
+```
 
 ## 配置 {#interfaces_cli_configuration}
 
-您可以通过以下方式传入参数到 `clickhouse-client` 中 （所有的参数都有默认值）：
+您可以通过以下方式传入参数到`clickhouse-client`中（所有的参数都有默认值）：
 
 -   通过命令行
 
@@ -75,29 +109,32 @@ cat file.csv | clickhouse-client --database=test --query="INSERT INTO test FORMA
 
     配置文件的配置会覆盖默认值
 
-### 命令行参数 {#ming-ling-xing-can-shu}
+### 命令行参数 {#command-line-options}
 
--   `--host, -h` -– 服务端的 host 名称, 默认是 ‘localhost’。 您可以选择使用 host 名称或者 IPv4 或 IPv6 地址。
--   `--port` – 连接的端口，默认值： 9000。注意 HTTP 接口以及 TCP 原生接口是使用不同端口的。
--   `--user, -u` – 用户名。 默认值： default。
--   `--password` – 密码。 默认值： 空字符串。
--   `--query, -q` – 非交互模式下的查询语句.
--   `--database, -d` – 默认当前操作的数据库. 默认值： 服务端默认的配置 （默认是 `default`）。
--   `--multiline, -m` – 如果指定，允许多行语句查询（Enter 仅代表换行，不代表查询语句完结）。
--   `--multiquery, -n` – 如果指定, 允许处理用逗号分隔的多个查询，只在非交互模式下生效。
+-   `--host, -h` -– 服务端的host名称, 默认是`localhost`。您可以选择使用host名称或者IPv4或IPv6地址。
+-   `--port` – 连接的端口，默认值：9000。注意HTTP接口以及TCP原生接口使用的是不同端口。
+-   `--user, -u` – 用户名。 默认值：`default`。
+-   `--password` – 密码。 默认值：空字符串。
+-   `--query, -q` – 使用非交互模式查询。
+-   `--database, -d` – 默认当前操作的数据库. 默认值：服务端默认的配置（默认是`default`）。
+-   `--multiline, -m` – 如果指定，允许多行语句查询（Enter仅代表换行，不代表查询语句完结）。
+-   `--multiquery, -n` – 如果指定, 允许处理用`;`号分隔的多个查询，只在非交互模式下生效。
 -   `--format, -f` – 使用指定的默认格式输出结果。
--   `--vertical, -E` – 如果指定，默认情况下使用垂直格式输出结果。这与 ‘–format=Vertical’ 相同。在这种格式中，每个值都在单独的行上打印，这种方式对显示宽表很有帮助。
--   `--time, -t` – 如果指定，非交互模式下会打印查询执行的时间到 ‘stderr’ 中。
+-   `--vertical, -E` – 如果指定，默认情况下使用垂直格式输出结果。这与`–format=Vertical`相同。在这种格式中，每个值都在单独的行上打印，这种方式对显示宽表很有帮助。
+-   `--time, -t` – 如果指定，非交互模式下会打印查询执行的时间到`stderr`中。
 -   `--stacktrace` – 如果指定，如果出现异常，会打印堆栈跟踪信息。
 -   `--config-file` – 配置文件的名称。
+-   `--secure` – 如果指定，将通过安全连接连接到服务器。
+-   `--history_file` — 存放命令历史的文件的路径。
+-   `--param_<name>` — 查询参数配置[查询参数](#cli-queries-with-parameters).
 
-### 配置文件 {#pei-zhi-wen-jian}
+### 配置文件 {#configuration_files}
 
-`clickhouse-client` 使用一下第一个存在的文件：
+`clickhouse-client`使用以下第一个配置文件：
 
--   通过 `--config-file` 参数指定的文件.
+-   通过`--config-file`参数指定。
 -   `./clickhouse-client.xml`
--   `\~/.clickhouse-client/config.xml`
+-   `~/.clickhouse-client/config.xml`
 -   `/etc/clickhouse-client/config.xml`
 
 配置文件示例:
@@ -106,6 +143,7 @@ cat file.csv | clickhouse-client --database=test --query="INSERT INTO test FORMA
 <config>
     <user>username</user>
     <password>password</password>
+    <secure>False</secure>
 </config>
 ```
 

docs/zh/interfaces/cpp.md

-# C ++客户端库 {#c-ke-hu-duan-ku}
+---
+toc_priority: 24
+toc_title: C++客户端库
+---
 
-请参阅以下网站的自述文件[ﾂ暗ｪﾂ氾环催ﾂ団](https://github.com/ClickHouse/clickhouse-cpp)资料库。
+# C++客户端库 {#c-client-library}
+
+请参考仓库的描述文件[clickhouse-cpp](https://github.com/ClickHouse/clickhouse-cpp)。
 
 [原始文章](https://clickhouse.tech/docs/zh/interfaces/cpp/) <!--hide-->

docs/zh/interfaces/jdbc.md

-# JDBC 驱动 {#jdbc-qu-dong}
+---
+toc_priority: 22
+toc_title: JDBC驱动
+---
 
--   **[官方JDBC 的驱动](https://github.com/ClickHouse/clickhouse-jdbc)**
--   三方提供的 JDBC 驱动:
-    -   [掳胫–禄脢鹿脷露胫鲁隆鹿–酶](https://github.com/housepower/ClickHouse-Native-JDBC)
+# JDBC驱动 {#jdbc-driver}
+
+-   **[官方驱动](https://github.com/ClickHouse/clickhouse-jdbc)**
+-   第三方驱动:
+    -   [ClickHouse-Native-JDBC](https://github.com/housepower/ClickHouse-Native-JDBC)
     -   [clickhouse4j](https://github.com/blynkkk/clickhouse4j)
 
 [来源文章](https://clickhouse.tech/docs/zh/interfaces/jdbc/) <!--hide-->

docs/zh/interfaces/mysql.md

 ---
-machine_translated: true
-machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
 toc_priority: 20
-toc_title: "MySQL\u63A5\u53E3"
+toc_title: MySQL接口
 ---
 
 # MySQL接口 {#mysql-interface}
 
-ClickHouse支持MySQL线协议。 它可以通过启用 [mysql_port](../operations/server-configuration-parameters/settings.md#server_configuration_parameters-mysql_port) 在配置文件中设置:
+ClickHouse支持MySQL协议。它可以通过[mysql_port](../operations/server-configuration-parameters/settings.md#server_configuration_parameters-mysql_port)在配置文件中设置:
 
 ``` xml
 <mysql_port>9004</mysql_port>
 ```
 
-使用命令行工具连接的示例 `mysql`:
+使用命令行工具连接`mysql`示例:
 
 ``` bash
 $ mysql --protocol tcp -u default -P 9004
@@ -37,8 +35,8 @@ Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
 mysql>
 ```
 
-为了与所有MySQL客户端兼容，建议使用以下命令指定用户密码 [双SHA1](../operations/settings/settings-users.md#password_double_sha1_hex) 在配置文件中。
-如果使用用户密码指定 [SHA256](../operations/settings/settings-users.md#password_sha256_hex)，一些客户端将无法进行身份验证（mysqljs和旧版本的命令行工具mysql）。
+为了与所有MySQL客户端兼容，建议在配置文件中使用[双SHA1](../operations/settings/settings-users.md#password_double_sha1_hex)指定用户密码。
+如果使用[SHA256](../operations/settings/settings-users.md#password_sha256_hex)指定用户密码，一些客户端将无法进行身份验证(mysqljs和旧版本的命令行工具mysql)。
 
 限制:
 

docs/zh/interfaces/odbc.md

-# ODBC 驱动 {#odbc-qu-dong}
+---
+toc_priority: 23
+toc_title: ODBC驱动
+---
 
--   ClickHouse官方有 ODBC 的驱动。 见 [这里](https://github.com/ClickHouse/clickhouse-odbc)。
+# ODBC驱动 {#odbc-driver}
+
+-   [官方驱动](https://github.com/ClickHouse/clickhouse-odbc)。
 
 [来源文章](https://clickhouse.tech/docs/zh/interfaces/odbc/) <!--hide-->

docs/zh/interfaces/tcp.md

-# 原生客户端接口（TCP） {#yuan-sheng-ke-hu-duan-jie-kou-tcp}
+---
+toc_priority: 18
+toc_title: 原生接口(TCP)
+---
 
-本机协议用于 [命令行客户端](cli.md)，用于分布式查询处理期间的服务器间通信，以及其他C ++程序。 不幸的是，本机ClickHouse协议还没有正式的规范，但它可以从ClickHouse源代码进行逆向工程 [从这里开始](https://github.com/ClickHouse/ClickHouse/tree/master/src/Client)）和/或拦截和分析TCP流量。
+# 原生接口（TCP）{#native-interface-tcp}
+
+原生接口用于[命令行客户端](cli.md)，用于分布式查询处理期间的服务器间通信，以及其他C++程序。可惜的是，原生的ClickHouse协议还没有正式的规范，但它可以从ClickHouse[源代码](https://github.com/ClickHouse/ClickHouse/tree/master/src/Client)通过拦截和分析TCP流量进行反向工程。
 
 [来源文章](https://clickhouse.tech/docs/zh/interfaces/tcp/) <!--hide-->