clickhouse/jdbc-bridge

ClickHouse JDBC Bridge Docker镜像

什么是ClickHouse JDBC Bridge？

它是一个无状态代理，用于将查询从ClickHouse传递到外部数据源。通过此扩展，您可以在ClickHouse服务器上使用JDBC表函数和/或相应的表引擎实时查询任意数据源。

版本

latest标签指向master分支的最新发布。分支标签（如2.0）指向对应分支的最新发布。完整版本标签（如2.0.0）指向对应版本的发布。

如何使用此镜像

启动JDBC桥

bash
docker run -d --name ch-jdbc-bridge -p9019:9019 \
    -e MAVEN_REPO_URL="https://repo1.maven.org/maven2" \
    -e JDBC_DRIVERS="org/mariadb/jdbc/mariadb-java-client/2.7.1/mariadb-java-client-2.7.1.jar,org/postgresql/postgresql/42.2.18/postgresql-42.2.18.jar" clickhouse/jdbc-bridge

如果您希望在主机上使用JDBC驱动和命名数据源，可使用以下命令：

bash
wget -P drivers \
    https://repo1.maven.org/maven2/org/mariadb/jdbc/mariadb-java-client/2.7.1/mariadb-java-client-2.7.1.jar \
    https://repo1.maven.org/maven2/org/postgresql/postgresql/42.2.18/postgresql-42.2.18.jar
wget -P datasources \
    https://raw.githubusercontent.com/ClickHouse/clickhouse-jdbc-bridge/master/misc/quick-start/jdbc-bridge/config/datasources/mariadb10.json \
    https://raw.githubusercontent.com/ClickHouse/clickhouse-jdbc-bridge/master/misc/quick-start/jdbc-bridge/config/datasources/postgres13.json
# 请编辑datasources/*.json以连接到您的数据库服务器
docker run -d --name ch-jdbc-bridge -p9019:9019 -v `pwd`/drivers:/app/drivers \
    -v `pwd`/datasources:/app/config/datasources clickhouse/jdbc-bridge

配置ClickHouse服务器

默认情况下，ClickHouse假定JDBC桥在localhost:9019可用。您可以在/etc/clickhouse-server/config.xml中自定义主机和端口，如下所示：

xml
<yandex>
    ...
    <jdbc_bridge>
        <host>localhost</host>
        <port>9019</port>
    </jdbc_bridge>
    ...
</yandex>

在ClickHouse上执行查询

启动JDBC桥并相应配置ClickHouse服务器后，您可以在ClickHouse上运行如下查询：

sql
-- 显示所有命名数据源
select * from jdbc('', 'show datasources')
-- 针对临时数据源查询（出于安全考虑不推荐）
select * from jdbc('jdbc:mariadb://localhost:3306/test?useSSL=false&user=root&password=root', 'select 1')
-- 针对命名数据源，使用内联模式和临时查询
select * from jdbc('mariadb10', 'num UInt8', 'select 1 as num')
-- 脚本执行
select * from jdbc('script', '[1,2,3]')

配置

容器暴露9019端口，用于ClickHouse集成和监控。

如需自定义容器，请参考以下目录结构和支持的环境变量：

bash
/app                        # 工作目录
  |
  |-- drivers               # JDBC驱动
  |-- config                
  |     |
  |     |-- datasources     # 命名数据源
  |     |-- schemas         # 命名模式
  |     |-- queries         # 命名查询
  |
  |-- logs                  # 应用日志
  |-- scripts               # 保存的查询/脚本

许可证

查看https://github.com/ClickHouse/clickhouse-jdbc-bridge/blob/master/LICENSE%E4%BA%86%E8%A7%A3%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%AD%E5%8C%85%E5%90%AB%E8%BD%AF%E4%BB%B6%E7%9A%84%E8%AE%B8%E5%8F%AF%E8%AF%A6%E6%83%85%E3%80%82