java spring 连接clickhouse数据库

### Java Spring 连接 ClickHouse 数据库

为了使 Java Spring 应用程序能够连接到 ClickHouse 数据库，需完成几个必要的配置和依赖设置。

#### 添加 Maven 或 Gradle 依赖项
确保项目中的 `pom.xml` 文件包含了 ClickHouse JDBC 驱动的依赖：

<dependency>
    <groupId>ru.yandex.clickhouse</groupId>
    <artifactId>clickhouse-jdbc</artifactId>
    <version>0.3.2</version>
</dependency>

对于使用 Gradle 的项目，则应在 build.gradle 中加入如下语句：

implementation 'ru.yandex.clickhouse:clickhouse-jdbc:0.3.2'

#### 修改 Application Properties/YML 文件
在应用程序属性文件中定义数据源的相关参数。可以采用两种方式之一来指定这些细节；一种是在 `application.properties` 文件里直接声明[^1]：

spring.datasource.url=jdbc:clickhouse://localhost:8123/mydatabase
spring.datasource.username=myusername
spring.datasource.password=mypassword
spring.datasource.driver-class-name=ru.yandex.clickhouse.ClickHouseDriver

另一种方法则是通过更具体的命名空间来进行配置，在此情况下应参照下面的例子并将其放置于 `application.properties` 或者 `application.yml` 文件内[^2]:

spring:
  datasource:
    clickhouse:
      jdbc-url: jdbc:clickhouse://localhost:8123/default
      username: default
      password: 
      driver-class-name: ru.yandex.clickhouse.ClickHouseDriver

#### 创建 DataSource Bean (如果必要的话)

有时可能还需要显式创建一个用于管理数据库连接池的数据源 bean 。这可以通过编写自定义配置类实现:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DatabaseConfig {

    @Bean(destroyMethod = "close")
    public DataSource dataSource() {
        HikariDataSource ds = new HikariDataSource();
        ds.setJdbcUrl("jdbc:clickhouse://localhost:8123/mydatabase");
        ds.setUsername("myusername");
        ds.setPassword("mypassword");
        ds.setDriverClassName("ru.yandex.clickhouse.ClickHouseDriver");

        return ds;
    }
}

上述代码片段展示了如何利用 HikariCP 来作为高性能的连接池解决方案，并初始化了一个指向 ClickHouse 实例的数据源对象。