SpringBoot + MyBatis + taosDB时序数据库 + MySql ，多数据源配置

本文主要说明一下多数据源配置，然后再详细阐述一下配置taosDB的注意事项，其中taosDB配置起来需要注意的问题比较多。至于时序数据库是干啥用的，一般用于哪些范围大家可以自行百度一下，这里就不过多赘述了。

1）添加mysql和taosDB的数据库依赖

<!-- Mysql依赖 -->
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>8.0.11</version>
</dependency>

<!-- TDengine 驱动 -->
<dependency>
    <groupId>com.taosdata.jdbc</groupId>
    <artifactId>taos-jdbcdriver</artifactId>
    <version>2.0.15</version>
</dependency>

2）application.yml文件配置，这里需要注意一下,

       2.1 , 多数据源配置要使用连接池的话url需要用jdbc-url，否则不能识别到url ；其中驱动类名需要用driver-class-name;

       2.2 , MyBatis配置字段下划线自动转驼峰的配置就不需要了，因为多数据源配置的话在yml文件配置不会生效，需要在数据库的配置类中单独配置，后面有涉及

spring:
  datasource:
    taos:
      jdbc-url: jdbc:TAOS://IP:PORT/test?charset=UTF-8&timezone=UTC-8
      username: root
      password: taosdata
      driver-class-name: com.taosdata.jdbc.TSDBDriver
      pool-name: Cloud-OAuth2-HikariCP-taos
      minimum-idle: 5
      maximum-pool-size: 20
    mysql:
      jdbc-url: jdbc:mysql://IP:PORT/test?characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8&rewriteBatchedStatements=true
      username: ENC(/0hXJUQIAh5vFPLP0OwfgSpLOBjZnnEH)
      password: ENC(nQkd4LyM+EbMVjzcGnqJUkotFiycE5Cl)
      driver-class-name: com.mysql.cj.jdbc.Driver
      pool-name: Cloud-OAuth2-HikariCP-mysql
      minimum-idle: 5
      maximum-pool-size: 20
mybatis:
  mapper-locations: classpath:/mapper/**/*Mapper.xml
  typeAliasesPackage: com.zhxd.**.model.entity

3）taosDB的配置类和MySql的配置类单独配置，然后需要将MySql和taosDB的文件目录区分开来，这样可以避免启动项目时注册接口重复；下图是我搭建的项目目录结构，可以参考

MySqlConfiguration.java文件的配置详情：

package com.zhxd.config;


import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.SqlSessionTemplate;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;

import javax.sql.DataSource;

// “com.zhxd.mysql.mapper”这里需要注意mysql和taosdb的目录是不同的
@Configuration
@MapperScan(basePackages = {"com.zhxd.mysql.mapper"},sqlSessionFactoryRef = "mysqlSqlSessionFactory")
//这里一定要注意，这个basePackages是你的mapper接口及service所在的包名，
// 而下面的红线所标注的classpath是mapper.xml所在的位置，这个xml是配置文件，
// 处在resources里，他的路径也要格外区分开。
public class MySqlConfiguration {

    @Bean(name="mysqlDataSource")
    //下面的注解作用就是从application.properties中读取以这个字符串开头的那些配置，设置为数据源的配置
    @ConfigurationProperties(prefix ="spring.datasource.mysql")
    public DataSource mysqlDataSource(){
        return DataSourceBuilder.create().build();
    }
    @Bean(name="mysqlSqlSessionFactory")
    public SqlSessionFactory mysqlSqlSessionFactory(@Qualifier("mysqlDataSource") DataSource dataSource)throws Exception{
        SqlSessionFactoryBean bean=new SqlSessionFactoryBean();
        bean.setDataSource(dataSource);
        // 这里配置的是mysql需要读取的xml文件路径
        bean.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/mysql/*Mapper.xml"));

        SqlSessionFactory sqlSessionFactory = bean.getObject();
        // 这里就是第二步中提到的数据库字段下划线转驼峰的配置
        sqlSessionFactory.getConfiguration().setMapUnderscoreToCamelCase(true);
        return sqlSessionFactory;
    }
    @Bean(name = "mysqlTransactionManager")
    public DataSourceTransactionManager mysqlTransactionManager(@Qualifier("mysqlDataSource")DataSource dataSource){
        return new DataSourceTransactionManager(dataSource);
    }
    @Bean(name="mysqlSqlSessionTemplate")
    public SqlSessionTemplate mysqlSqlSessionTemplate(@Qualifier("mysqlSqlSessionFactory")SqlSessionFactory sqlSessionFactory){
        return new SqlSessionTemplate(sqlSessionFactory);
    }

}

TaosdbConfiguration.java文件的配置详情：

package com.zhxd.config;

import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.SqlSessionTemplate;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;

import javax.sql.DataSource;

@Configuration
@MapperScan(basePackages = {"com.zhxd.taosdb.mapper"},sqlSessionFactoryRef = "taosdbSqlSessionFactory")
//这里一定要注意，这个basePackages是你的mapper接口及service所在的包名，
// 而下面的红线所标注的classpath是mapper.xml所在的位置，这个xml是配置文件，
// 处在resources里，他的路径也要格外区分开。
public class TaosdbConfiguration  {

    @Bean(name="taosdbDataSource")
    //下面的注解作用就是从application.properties中读取以这个字符串开头的那些配置，设置为数据源的配置
    @ConfigurationProperties(prefix ="spring.datasource.taos")
    public DataSource taosdbDataSource(){
        return DataSourceBuilder.create().build();
    }
    @Bean(name="taosdbSqlSessionFactory")
    public SqlSessionFactory taosdbSqlSessionFactory(@Qualifier("taosdbDataSource") DataSource dataSource)throws Exception{
        SqlSessionFactoryBean bean=new SqlSessionFactoryBean();
        bean.setDataSource(dataSource);
        bean.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/taos/*Mapper.xml"));

        SqlSessionFactory sqlSessionFactory = bean.getObject();
        sqlSessionFactory.getConfiguration().setMapUnderscoreToCamelCase(true);
        return sqlSessionFactory;
    }
    @Bean(name = "taosdbTransactionManager")
    public DataSourceTransactionManager taosdbTransactionManager(@Qualifier("taosdbDataSource")DataSource dataSource){
        return new DataSourceTransactionManager(dataSource);
    }
    @Bean(name="taosdbSqlSessionTemplate")
    public SqlSessionTemplate taosdbSqlSessionTemplate(@Qualifier("taosdbSqlSessionFactory")SqlSessionFactory sqlSessionFactory){
        return new SqlSessionTemplate(sqlSessionFactory);
    }
}

至此，多数据源的配置已经完成了。

 

接下来，我们大致说一下项目想要成功连接taosDB数据库，需要哪些配置和可能会遇到的坑：

1）项目服务如果需要连接到taosdb数据库则需要在本机或者服务器（项目所部署的机器）安装客户端，而且要求客户端版本必须和服务端版本一致，否则连接会失败；

连接报错:java.lang.UnsatisfiedLinkError: no taos in java.library.path

原因：程序没有找到依赖的本地函数库 taos。

解决方法：windows 下可以将 C:\TDengine\driver\taos.dll 拷贝到 C:\Windows\System32\ 目录下 ；

                 linux 下将建立如下软链 ln -s /usr/local/taos/driver/libtaos.so.x.x.x.x /usr/lib/libtaos.so 即可。

2）TAOSDB只支持64位JDK

      java.lang.UnsatisfiedLinkError: taos.dll Can't load AMD 64 bit on a IA 32-bit platform

     原因：目前 TDengine 只支持 64 位 JDK。

     解决方法：重新安装 64 位 JDK。

3) 若配置完成后取taosdb数据库的数据失败，提示不能解析FQDN，则需要在电脑上配置hosts文件，将taosdb数据库的FQDN名称配置到hosts文件中

      以Win10为例，大家需要修改C:\Windows\System32\drivers\etc 目录下的hosts文件 ；

      而Linux系统中，修改/etc/hosts

      在文件中添加 如下示例   192.168.1.1 lnx  ，其中IP为taosdb数据库的ip，lnx则为taosdb数据库的FQDN名称