2020-04-03 13:23:32 +00:00
---
2022-08-28 14:53:34 +00:00
slug: /en/sql-reference/table-functions/jdbc
2023-06-23 13:16:22 +00:00
sidebar_position: 100
2022-04-09 13:29:05 +00:00
sidebar_label: jdbc
2020-04-03 13:23:32 +00:00
---
2022-06-02 10:55:18 +00:00
# jdbc
2018-10-16 10:47:17 +00:00
2024-03-18 00:30:36 +00:00
:::note
clickhouse-jdbc-bridge contains experimental codes and is no longer supported. It may contain reliability issues and security vulnerabilities. Use it at your own risk. ClickHouse recommend using built-in table functions in ClickHouse which provide a better alternative for ad-hoc querying scenarios (Postgres, MySQL, MongoDB, etc).
:::
2021-06-11 09:37:38 +00:00
`jdbc(datasource, schema, table)` - returns table that is connected via JDBC driver.
2018-10-16 10:47:17 +00:00
2021-06-11 09:37:38 +00:00
This table function requires separate [clickhouse-jdbc-bridge ](https://github.com/ClickHouse/clickhouse-jdbc-bridge ) program to be running.
2018-10-16 10:47:17 +00:00
It supports Nullable types (based on DDL of remote table that is queried).
**Examples**
2020-03-20 10:10:48 +00:00
``` sql
2018-10-16 10:47:17 +00:00
SELECT * FROM jdbc('jdbc:mysql://localhost:3306/?user=root& password=root', 'schema', 'table')
```
2020-03-20 10:10:48 +00:00
``` sql
2021-06-11 09:37:38 +00:00
SELECT * FROM jdbc('mysql://localhost:3306/?user=root&password=root', 'select * from schema.table')
2018-10-16 10:47:17 +00:00
```
2020-03-20 10:10:48 +00:00
``` sql
2021-06-11 09:37:38 +00:00
SELECT * FROM jdbc('mysql-dev?p1=233', 'num Int32', 'select toInt32OrZero(''{{p1}}'') as num')
2018-10-16 10:47:17 +00:00
```
2021-06-11 09:37:38 +00:00
``` sql
2021-07-29 15:20:55 +00:00
SELECT *
2021-06-11 09:37:38 +00:00
FROM jdbc('mysql-dev?p1=233', 'num Int32', 'select toInt32OrZero(''{{p1}}'') as num')
```
``` sql
SELECT a.datasource AS server1, b.datasource AS server2, b.name AS db
FROM jdbc('mysql-dev?datasource_column', 'show databases') a
INNER JOIN jdbc('self?datasource_column', 'show databases') b ON a.Database = b.name
```