jdbc - ClickHouse Documentation

clickhouse-jdbc-bridge contém código Experimental e não tem mais suporte. Pode conter problemas de confiabilidade e vulnerabilidades de segurança. Use por sua conta e risco. O ClickHouse recomenda usar funções de tabela nativas do ClickHouse, que oferecem uma alternativa melhor para cenários de consultas ad hoc (Postgres, MySQL, MongoDB etc.).

A função de tabela JDBC retorna uma tabela conectada por meio do driver JDBC. Esta função de tabela exige que um programa clickhouse-jdbc-bridge separado esteja em execução. Ela oferece suporte a tipos Nullable (com base no DDL da tabela remota consultada).

Sintaxe

jdbc(datasource, external_database, external_table)
jdbc(datasource, external_table)
jdbc(named_collection)

Exemplos

Em vez do nome de um banco de dados externo, é possível especificar um esquema:

SELECT * FROM jdbc('jdbc:mysql://localhost:3306/?user=root&password=root', 'schema', 'table')

SELECT * FROM jdbc('mysql://localhost:3306/?user=root&password=root', 'select * from schema.table')

SELECT * FROM jdbc('mysql-dev?p1=233', 'num Int32', 'select toInt32OrZero(''{{p1}}'') as num')

SELECT *
FROM jdbc('mysql-dev?p1=233', 'num Int32', 'select toInt32OrZero(''{{p1}}'') as num')

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

Última modificação em 26 de setembro de 2026