ClickHouse JDBC 桥接器快速启动指南

ClickHouse JDBC 桥接器快速启动指南

clickhouse-jdbc-bridgeA JDBC proxy from ClickHouse to external databases项目地址:https://gitcode.com/gh_mirrors/cl/clickhouse-jdbc-bridge

目录结构及介绍

在克隆了 clickhouse-jdbc-bridge 仓库之后, 你会看到以下主要目录和文件:

• src: 主要的源代码目录, 包含该项目的核心代码.
• docker: 包含用于构建Docker镜像的所有相关文件.
  • Dockerfile: 构建容器的脚本.
  • all-in-one Dockerfile: 特别的 Dockerfile 文件, 可以用来创建一个全功能镜像.
• gitignore: Git 忽略文件列表.
• LICENSE: 许可协议文件.
• NOTICE: 注意事项说明.
• README.md: 项目的读我文件, 提供项目概述等信息.
• all-in-one Dockerfile: 如上所述的专用 Dockerfile.
• pom.xml: Maven 配置文件, 定义依赖库和其他构建细节.

启动文件介绍

运行 ClickHouse JDBC Bridge 的方法包括：

• 使用JAR包（通常是 clickhouse-jdbc-bridge-x.x.x-shaded.jar）运行。
• 使用Docker容器。

JAR包运行方式

可以通过下面的方式启动服务：

java -jar clickhouse-jdbc-bridge-x.x.x-shaded.jar

这里的 x.x.x 是具体的版本号。你需要替换为你实际下载或编译得到的 JAR 文件名中的版本号部分。

Docker容器运行方式

构建并运行 Docker 镜像的方法是通过执行 Docker 命令来完成：

docker build -t my/clickhouse-jdbc-bridge .
docker run -p 9019:9019 my/clickhouse-jdbc-bridge

或者如果你想要构建并运行所有集成在一起的图像，则可以使用下面这个命令：

docker build --build-arg revision=x.y.z -f all-in-one Dockerfile -t my/clickhouse-all-in-one .

这里 x.y.z 是 ClickHouse 版本, 也需要根据实际情况进行替换。

配置文件介绍

为了确保桥接器正确地连接到目标数据库, 需要在运行前设置相应的数据源参数. 数据源的详细配置通常被定义在一个JSON文件中, 并放在 config/datasources 目录下.

例如, 在快速启动指导中提到的 ch-server.json, 具有典型的配置布局：

{
  "name": "ch-server",
  "type": "<type>",
  "url": "<jdbc-url>",
  "username": "<username>",
  "password": "<password>",
  // ... 更多可能的属性...
}

其中 <type> 将确定数据源的类型, 譬如 MySQL 或 PostgreSQL；而 <jdbc-url>,<username> 和 <password> 等字段则是访问特定数据库实例所需的凭证信息.

注意, 当桥接器启动时它将自动搜索并加载 config/datasources 下所有的 JSON 文件作为可用的数据源.

一旦配置好了你的数据源, 你可以通过 jdbc() 函数从 ClickHouse 中查询外部数据库. 示例查询如下：

select * from jdbc('ch-server', '<schema>', '<query>')

在这个例子中, 'ch-server' 应该是你在配置文件中定义的数据源名称, 而 <schema> 和 <query> 则指定了你想要运行的具体 SQL 查询语句. 在某些情况下 <schema> 字段可能是可选的, 但其余部分都是强制性的.

clickhouse-jdbc-bridgeA JDBC proxy from ClickHouse to external databases项目地址:https://gitcode.com/gh_mirrors/cl/clickhouse-jdbc-bridge