Spring Boot ＋ Mybatis Plus 使用 Microsoft SQL Server 数据源心得

Spring Boot ＋ Mybatis Plus 使用 Microsoft SQL Server 数据源心得

从学习 Java 开发开始，绝大多数的教程都是采用的 MySQL 数据库，原因不用说了吧——免费啊！当然也有介绍 Oracle 的，唯独对 SQL Server 鲜有涉及。我想，可能是目前使用 Java 开发应用基本上都是 Web 应用。所以大多部署到 Linux 服务器上，而 Linux 版的 SQL Server 貌似刚出来没多少天，因此选择 SQL Server 作为数据源的也就很少见了。
奈何本人所在单位现有很多业务系统都是基于.net + SQL Server 开发的。为了让新的系统能与现有系统在数据交互上有较好的协调性，要求使用 Java 开发时也要选择 SQL Server。踩坑开始了……

1. pom 文件中的 SQL server 驱动依赖

版本选择时要注意需要与开发环境中的 JDK 版本一致。可以到 Maven 的中央仓库查看 mssql-jdbc 具体版本。我选择了使用偏多的 6.4.0 。

        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>mssql-jdbc</artifactId>
            <version>6.4.0.jre8</version>
        </dependency>
        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>sqljdbc4</artifactId>
            <version>4.0</version>
        </dependency>

2. pom 文件中的 MyBatis-Plus 依赖

            <!-- Mybatis Plus-->
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-boot-starter</artifactId>
                <version>3.3.2</version>
            </dependency>
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-generator</artifactId>
                <version>3.3.2</version>
            </dependency>

3. MS SQL Server 数据源配置

（1）MS SQL Server 的连接字符串最简单的格式如下：

jdbc:sqlserver://192.168.10.11:1433;DatabaseName=scott

（2）代码生成器中

  dsc.setUrl("jdbc:sqlserver://10.10.10.110:1433;DatabaseName=scott");  //检查是否需要修改
  dsc.setDriverName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
  dsc.setUsername("sa");
  dsc.setPassword("123456");    //检查是否需要修改
  dsc.setDbType(DbType.SQL_SERVER);

（3）yaml 文件中

  spring:
    profiles:
      active: dev # 环境设置
    application:
      name: service-sys # 服务名
    datasource: # mysql数据库连接
      driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
      url: jdbc:sqlserver://10.10.10.110:1433:/DatabaseName=scott
      username: sa
      password: 123456

至此，有关 Spring Boot 的相关配置应该就算完事了，但是……我发现了一个有意思的坑！！

我为了测试，先在数据库中建立了一个 user 表，这可是几乎所有视频教程都在用的典型范例。但是我发现，generator 报错了……查百度、CSDN……说是 Mybatis-Plus 的版本高了，降到 3.2.0。
可是，主键策略……3.2 和 3.3 的不那么一样。原来想用 3.3 中的 ASSIGN_ID 不灵了，只能用 UUID。算了，先改了再说。wow～～居然可以了！！！（难道 3.3 版本出 bug 了？）
由于前面的数据都是用的雪花算法弄出来的 ID，这如何是好。再改回去？嗯，改！改 POM，改实体类注解，改代码生成器注解（反正也不运行了，都注释了也可以）……编写个 Controller 实验一下，又不行了～～报错说 SQL 语法错误！

select * from user;

这么简单的会有错？？！！
查来查去发现，user 是 SQL Server 的一个保留字～！表名改成 employee 就可以了。

于是我想，要不用代码生成器再试试原来就有的 dept 表？顺利生成了！！
这说明，人家 Mybatis－Plus 根本啥问题没有，是我对 SQL Server 的不了解导致折腾了这么久。

结论

使用 Microsoft SQL Server 时，千万千万千万不要让表名、字段名等与保留字相同。

SQL Server Compact 3.5 中的保留字用法不一定和 SQL Server 中对应的保留字用法相同。

应避免将保留字用作标识符。如果保留字必须用作标识符，则必须用双引号进行分隔，或者放入括号中：[]。

下表列出了 SQL Server Compact 3.5 中的保留字。