Doc. named connections

This commit is contained in:
Denny Crane 2022-03-14 00:31:20 -03:00
parent 7e5589fd78
commit 0b4c3e5be9
2 changed files with 29 additions and 5 deletions

View File

@ -9,13 +9,25 @@ Details for connecting to external sources (dictionaries, tables, table function
in configuration files and thus simplify the creation of objects and hide credentials
from users with only SQL access.
Parameters can be set in XML `<format>CSV</format>` and overridden in SQL `, format = 'TSV'`.
The parameters in SQL can be overridden using format `key` = `value`: `compression_method = 'gzip'`.
Named connections are stored in the `config.xml` file of the ClickHouse server in the `<named_collections>` section and are applied when ClickHouse starts.
Example of configuration:
```xml
$ cat /etc/clickhouse-server/config.d/named_collections.xml
<clickhouse>
<named_collections>
...
</named_collections>
</clickhouse>
```
## Named connections for accessing S3.
The description of parameters see [s3 Table Function](../sql-reference/table-functions/s3).
The description of parameters see [s3 Table Function](../sql-reference/table-functions/s3.md).
Example of configuration:
```xml
@ -63,7 +75,7 @@ SELECT * FROM s3_engine_table LIMIT 3;
## Named connections for accessing MySQL database.
The description of parameters see [mysql](../sql-reference/table-functions/mysql/).
The description of parameters see [mysql](../sql-reference/table-functions/mysql.md).
Example of configuration:
```xml

View File

@ -12,9 +12,21 @@ toc_title: "Именованные соединения"
Параметры можно задать в XML `<format>CSV</format>` и переопределить в SQL `, format = 'TSV'`.
При использовании именованных соединений, параметры в SQL задаются в формате `ключ` = `значение`: `compression_method = 'gzip'`.
Именованные соединения хранятся в файле `config.xml` сервера ClickHouse в секции `<named_collections>` и применяются при старте ClickHouse.
Пример конфигурации:
```xml
$ cat /etc/clickhouse-server/config.d/named_collections.xml
<clickhouse>
<named_collections>
...
</named_collections>
</clickhouse>
```
## Именованные соединения для доступа к S3.
Описание параметров смотри [Табличная Функция S3](../sql-reference/table-functions/s3).
Описание параметров смотри [Табличная Функция S3](../sql-reference/table-functions/s3.md).
Пример конфигурации:
```xml
@ -62,7 +74,7 @@ SELECT * FROM s3_engine_table LIMIT 3;
## Пример использования именованных соединений с базой данных MySQL.
Описание параметров смотри [mysql](../sql-reference/table-functions/mysql/).
Описание параметров смотри [mysql](../sql-reference/table-functions/mysql.md).
Пример конфигурации:
```xml