diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md index ba54694faa9..c36887672c7 100644 --- a/docs/en/interfaces/cli.md +++ b/docs/en/interfaces/cli.md @@ -166,13 +166,13 @@ The connection string for clickhouse-client is presented in URI format: clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters] ``` -where user_info is: ```user[:password]``` -and hosts_and_ports is a list of values: ```[host][:port],[host][:port]``` Port is not mandatory. -and query_parameters is a list of parameter[=value]: ```param_name[=value]¶m_name[=value]...``` value may not be required for some of parameters. Parameter names are case sensitive. +where user_info is: `user[:password]` +and hosts_and_ports is a list of values: `[host][:port],[host][:port]` Port is not mandatory. +and query_parameters is a list of parameter[=value]: `param_name[=value]¶m_name[=value]...` value may not be required for some of the parameters. Parameter names are case sensitive. Allowed query_parameters keys: -- **secure** or shorthanded **s** - no value. If specified, client will connect to the server over a secure connection (TLS). See **secure** in [command-line-options](#command-line-options) +- `secure` or shorthanded `s` - no value. If specified, client will connect to the server over a secure connection (TLS). See `secure` in [command-line-options](#command-line-options) These examples illustrate valid connection strings for clickhouse-client: @@ -210,11 +210,11 @@ If more than one host is supplied, or if a single host name is translated to mor ### Percent encoding {#connection_string_uri_percent_encoding} -Hosts, user name, password, database and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain URI invalid characters. +Hosts, user name, password, database, and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain invalid URI characters. ### Examples {#connection_string_examples} -Connect to localhost using port 9000 and executes the query "SELECT 1". +Connect to localhost using port 9000 and execute the query "SELECT 1". ``` bash clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1" @@ -232,7 +232,7 @@ Connect to localhost using port 9000 in interactive mode with the user specified clickhouse-client "clickhouse://localhost:9000" --user default ``` -Connect to localhost using port 9000 in interactive mode to `my_database` database specified in command line option +Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the command line option. ``` bash clickhouse-client "clickhouse://localhost:9000" --database my_database @@ -250,7 +250,7 @@ Connect to localhost using port 9000 in interactive mode to `my_database` databa clickhouse-client "clickhouse://localhost/my_database?s" ``` -Connect to default host using the default port, default user, and default database. +Connect to default host using default port, default user, and default database. ``` bash clickhouse-client "clickhouse:" @@ -262,7 +262,7 @@ Connect to the default host using the default port, using user user_name and no clickhouse-client "clickhouse://user_name@" ``` -Connect to localhost using email user name. Symbol '@' is percent encoded to '%40'. +Connect to localhost using email as the user name. `@` symbol is percent encoded to `%40`. ``` bash clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000" diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md index 5f119ad9544..801a72e48ec 100644 --- a/docs/ru/interfaces/cli.md +++ b/docs/ru/interfaces/cli.md @@ -118,14 +118,14 @@ $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="numbe clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters] ``` -где user_info - это: ```user[:password]``` -hosts_and_ports - это список значений: ```[host][:port],[host][:port]```. Port может быть не задан. -query_parameters - это список пар ключ[=значение]: ```param_name[=value]¶m_name[=value]...```. Значение может быть пустым. +где user_info - это: `user[:password]` +hosts_and_ports - это список значений: `[host][:port],[host][:port]`. Port может быть не задан. +query_parameters - это список пар ключ[=значение]: `param_name[=value]¶m_name[=value]...`. Значение может быть пустым. Имена параметров чувствительны к регистру. Допустимые ключи query_parameters: -- **secure** или сокращенно **s** - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. **secure** в [command-line-options](#command-line-options). +- `secure` или сокращенно `s` - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. `secure` в [command-line-options](#command-line-options). Эти примеры иллюстрируют допустимые строки подключения для clickhouse-client: @@ -215,7 +215,7 @@ clickhouse-client "clickhouse:" clickhouse-client "clickhouse://user_name@" ``` -Подключиться к localhost, используя электронную почту, как имя пользователя. Символ '@' закодирован как '%40'. +Подключиться к localhost, используя электронную почту, как имя пользователя. Символ `@` закодирован как `%40`. ``` bash clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"