DOCAPI-6206: ODBC table engine description.

docs/en/operations/table_engines/jdbc.md

-# JDBC
+# JDBC {#table_engine-jdbc}
 
 Allows ClickHouse to connect to external databases via [JDBC](https://en.wikipedia.org/wiki/Java_Database_Connectivity).
 

docs/en/operations/table_engines/odbc.md

-# ODBC
+# ODBC {#table_engine-odbc}
 
 Allows ClickHouse to connect to external databases via [ODBC](https://en.wikipedia.org/wiki/Open_Database_Connectivity).
 
@@ -14,7 +14,7 @@ CREATE TABLE [IF NOT EXISTS] [db.]table_name  ENGINE = ODBC(connection_settings,
 
 **Engine Parameters**
 
-- `connection_settings` — Name of the sections with connection settings in the `odbc.ini` file.
+- `connection_settings` — Name of the section with connection settings in the `odbc.ini` file.
 - `external_database` — Database in an external DBMS.
 - `external_table` — A name of the table in `external_database`.
 

docs/en/query_language/table_functions/jdbc.md

-
-# jdbc
+# jdbc {#table_function-jdbc}
 
 `jdbc(jdbc_connection_uri, schema, table)` - returns table that is connected via JDBC driver.
 

docs/en/query_language/table_functions/odbc.md

-# odbc
+# odbc {#table_functions-odbc}
 
 Returns table that is connected via ODBC driver.
 
@@ -8,7 +8,7 @@ odbc(connection_settings, external_database, external_table)
 
 **Function Parameters**
 
-- `connection_settings` — Name of the sections with connection settings in the `odbc.ini` file.
+- `connection_settings` — Name of the section with connection settings in the `odbc.ini` file.
 - `external_database` — Database in an external DBMS.
 - `external_table` — A name of the table in `external_database`.
 

docs/fa/operations/table_engines/jdbc.md

+../../../en/operations/table_engines/jdbc.md
\ No newline at end of file

docs/fa/operations/table_engines/odbc.md

+../../../en/operations/table_engines/odbc.md
\ No newline at end of file

docs/fa/query_language/table_functions/odbc.md

+../../../en/query_language/table_functions/odbc.md
\ No newline at end of file

docs/ru/operations/table_engines/jdbc.md

+# JDBC
+
+Allows ClickHouse to connect to external databases via [JDBC](https://en.wikipedia.org/wiki/Java_Database_Connectivity).
+
+To implement JDBC connection, ClickHouse uses the separate program [clickhouse-jdbc-bridge](https://github.com/alex-krash/clickhouse-jdbc-bridge). You should run it as a daemon.
+
+This engine supports the [Nullable](../../data_types/nullable.md) data type.
+
+## Creating a Table
+
+```
+CREATE TABLE [IF NOT EXISTS] [db.]table_name  ENGINE = JDBC(dbms_uri, external_database, external_table)
+```
+
+**Engine Parameters**
+
+- `dbms_uri` — URI of an external DBMS.
+
+    Format: `jdbc:<driver_name>://<host_name>:<port>/?user=<username>&password=<password>`.
+    Example for MySQL: `jdbc:mysql://localhost:3306/?user=root&password=root`.
+
+- `external_database` — Database in an external DBMS.
+- `external_table` — A name of the table in `external_database`.
+
+## Usage Example
+
+Creating a table in MySQL (using native MySQL engine):
+
+```
+mysql> CREATE TABLE `test`.`test` (
+    ->   `int_id` INT NOT NULL AUTO_INCREMENT,
+    ->   `int_nullable` INT NULL DEFAULT NULL,
+    ->   `float` FLOAT NOT NULL,
+    ->   `float_nullable` FLOAT NULL DEFAULT NULL,
+    ->   PRIMARY KEY (`int_id`));
+Query OK, 0 rows affected (0,09 sec)
+
+mysql> insert into test (`int_id`, `float`) VALUES (1,2);
+Query OK, 1 row affected (0,00 sec)
+
+mysql> select * from test;
++--------+--------------+-------+----------------+
+| int_id | int_nullable | float | float_nullable |
++--------+--------------+-------+----------------+
+|      1 |         NULL |     2 |           NULL |
++--------+--------------+-------+----------------+
+1 row in set (0,00 sec)
+```
+
+Selecting data from the table in ClickHouse:
+
+```
+CREATE TABLE jdbc_table ENGINE JDBC('jdbc:mysql://localhost:3306/?user=root&password=root', 'test', 'test')
+
+Ok.
+
+DESCRIBE TABLE jdbc_table
+
+┌─name───────────────┬─type───────────────┬─default_type─┬─default_expression─┐
+│ int_id             │ Int32              │              │                    │
+│ int_nullable       │ Nullable(Int32)    │              │                    │
+│ float              │ Float32            │              │                    │
+│ float_nullable     │ Nullable(Float32)  │              │                    │
+└────────────────────┴────────────────────┴──────────────┴────────────────────┘
+
+10 rows in set. Elapsed: 0.031 sec.
+
+SELECT *
+FROM jdbc_table
+
+┌─int_id─┬─int_nullable─┬─float─┬─float_nullable─┐
+│      1 │         ᴺᵁᴸᴸ │     2 │           ᴺᵁᴸᴸ │
+└────────┴──────────────┴───────┴────────────────┘
+
+1 rows in set. Elapsed: 0.055 sec.
+```
+
+## See Also
+
+- [JDBC table function](../../query_language/table_functions/jdbc.md).
+
+[Original article](https://clickhouse.yandex/docs/en/operations/table_engines/jdbc/) <!--hide-->

docs/ru/operations/table_engines/odbc.md

+# ODBC
+
+Allows ClickHouse to connect to external databases via [ODBC](https://en.wikipedia.org/wiki/Open_Database_Connectivity).
+
+To implement ODBC connection, ClickHouse uses the separate program `clickhouse-odbc-bridge`. ClickHouse starts this program automatically when it is required. The ODBC bridge program is installed by the same package with the ClickHouse server.
+
+This engine supports the [Nullable](../../data_types/nullable.md) data type.
+
+## Creating a Table
+
+```
+CREATE TABLE [IF NOT EXISTS] [db.]table_name  ENGINE = ODBC(connection_settings, external_database, external_table)
+```
+
+**Engine Parameters**
+
+- `connection_settings` — Name of the section with connection settings in the `odbc.ini` file.
+- `external_database` — Database in an external DBMS.
+- `external_table` — A name of the table in `external_database`.
+
+## Usage Example
+
+Some examples of how to use external dictionaries through ODBC you can find in the [ODBC](../../query_language/dicts/external_dicts_dict_sources.md#dicts-external_dicts_dict_sources-odbc) section of external dictionaries configuration.
+
+## See Also
+
+- [ODBC table function](../../query_language/table_functions/odbc.md).
+
+[Original article](https://clickhouse.yandex/docs/en/operations/table_engines/jdbc/) <!--hide-->

docs/ru/query_language/dicts/external_dicts_dict_sources.md

@@ -28,7 +28,7 @@
 - [Исполняемый файл](#ispolniaemyi-fail)
 - [HTTP(s)](#http-s)
 -   СУБД:
-    - [ODBC](#odbc)
+    - [ODBC](#dicts-external_dicts_dict_sources-odbc)
     - [MySQL](#mysql)
     - [ClickHouse](#clickhouse)
     - [MongoDB](#mongodb)
@@ -97,7 +97,7 @@
 -   `format` - Формат файла. Поддерживаются все форматы, описанные в разделе "[Форматы](../../interfaces/formats.md#formats)".
 
 
-## ODBC
+## ODBC {#dicts-external_dicts_dict_sources-odbc}
 
 Этим способом можно подключить любую базу данных, имеющую ODBC драйвер.
 

docs/ru/query_language/table_functions/odbc.md

+# odbc
+
+Returns table that is connected via ODBC driver.
+
+```
+odbc(connection_settings, external_database, external_table)
+```
+
+**Function Parameters**
+
+- `connection_settings` — Name of the section with connection settings in the `odbc.ini` file.
+- `external_database` — Database in an external DBMS.
+- `external_table` — A name of the table in `external_database`.
+
+To implement ODBC connection, ClickHouse uses the separate program `clickhouse-odbc-bridge`. ClickHouse starts this program automatically when it is required. The ODBC bridge program is installed by the same package with the ClickHouse server.
+
+This function supports the [Nullable](../../data_types/nullable.md) data type (based on DDL of remote table that is queried).
+
+**Examples**
+
+```
+select * from odbc('DSN=connection_settings_name', 'external_database_name', 'external_table_name')
+```
+
+Some examples of how to use external dictionaries through ODBC you can find in the [ODBC](../../query_language/dicts/external_dicts_dict_sources.md#dicts-external_dicts_dict_sources-odbc) section of external dictionaries configuration.
+
+[Original article](https://clickhouse.yandex/docs/en/query_language/table_functions/jdbc/) <!--hide-->

docs/toc_en.yml

@@ -97,6 +97,7 @@ nav:
     - 'Buffer': 'operations/table_engines/buffer.md'
     - 'JDBC': 'operations/table_engines/jdbc.md'
     - 'ODBC': 'operations/table_engines/odbc.md'
+    
 - 'SQL Reference':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'

docs/toc_fa.yml

@@ -95,7 +95,9 @@ nav:
     - 'MaterializedView': 'operations/table_engines/materializedview.md'
     - 'Memory': 'operations/table_engines/memory.md'
     - 'Buffer': 'operations/table_engines/buffer.md'
-
+    - 'JDBC': 'operations/table_engines/jdbc.md'
+    - 'ODBC': 'operations/table_engines/odbc.md'
+    
 - 'SQL Reference':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
@@ -148,6 +150,7 @@ nav:
     - 'remote': 'query_language/table_functions/remote.md'
     - 'url': 'query_language/table_functions/url.md'
     - 'jdbc': 'query_language/table_functions/jdbc.md'
+    - 'odbc': 'query_language/table_functions/odbc.md'
   - 'Dictionaries':
     - 'Introduction': 'query_language/dicts/index.md'
     - 'External Dictionaries':

docs/toc_ru.yml

@@ -96,7 +96,9 @@ nav:
     - 'MaterializedView': 'operations/table_engines/materializedview.md'
     - 'Memory': 'operations/table_engines/memory.md'
     - 'Buffer': 'operations/table_engines/buffer.md'
-
+    - 'JDBC': 'operations/table_engines/jdbc.md'
+    - 'ODBC': 'operations/table_engines/odbc.md'
+    
 - 'Справка по SQL':
   - 'hidden': 'query_language/index.md'
   - 'SELECT': 'query_language/select.md'
@@ -148,6 +150,7 @@ nav:
     - 'remote': 'query_language/table_functions/remote.md'
     - 'url': 'query_language/table_functions/url.md'
     - 'jdbc': 'query_language/table_functions/jdbc.md'
+    - 'odbc': 'query_language/table_functions/odbc.md'
   - 'Словари':
     - 'Введение': 'query_language/dicts/index.md'
     - 'Внешние словари':

docs/toc_zh.yml

@@ -94,6 +94,8 @@ nav:
     - 'MaterializedView': 'operations/table_engines/materializedview.md'
     - 'Memory': 'operations/table_engines/memory.md'
     - 'Buffer': 'operations/table_engines/buffer.md'
+    - 'JDBC': 'operations/table_engines/jdbc.md'
+    - 'ODBC': 'operations/table_engines/odbc.md'
 
 - 'SQL语法':
   - 'hidden': 'query_language/index.md'
@@ -147,6 +149,7 @@ nav:
     - 'remote': 'query_language/table_functions/remote.md'
     - 'url': 'query_language/table_functions/url.md'
     - 'jdbc': 'query_language/table_functions/jdbc.md'
+    - 'odbc': 'query_language/table_functions/odbc.md'
   - 'Dictionaries':
     - 'Introduction': 'query_language/dicts/index.md'
     - 'External dictionaries':

docs/zh/operations/table_engines/jdbc.md

+../../../en/operations/table_engines/jdbc.md
\ No newline at end of file

docs/zh/operations/table_engines/odbc.md

+../../../en/operations/table_engines/odbc.md
\ No newline at end of file

docs/zh/query_language/table_functions/odbc.md

+../../../en/query_language/table_functions/odbc.md
\ No newline at end of file