开心每一天

Appearance

H2 数据库之在 SpringBoot 中的使用方式 ​

使用方式 ​

  1. pom.xml 添加：
xml
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
    <version>1.4.199</version>
</dependency>
  1. SpringBoot 配置：
yaml
spring:
  datasource:
    driver-class-name: org.h2.Driver
    # url: jdbc:h2:file:./db/test       # 以本地文件存储数据的方式使用H2数据库
    # 以内存方式使用数据库（这里会创建一个数据库名为 test 的数据库实例）
    url: jdbc:h2:mem:test
    username: sa
    password: sa
  h2:
    console:
      # 是否允许网页访问，默认false
      enabled: true
      # h2数据库的访问路径：http://localhost:8080/h2（默认为/h2-console）
      path: /h2
      settings:
        # 是否允许从其他地方访问，还是只允许从本地访问
        web-allow-others: true

  1. 启动 SpringBoot 程序。

  2. 打开浏览器访问：http://localhost:8080/h2

出现连接界面，特别注意：JDBC URL 参数，SpringBoot 默认为 jdbc:h2:~/test ，需要修改为 SpringBoot 配置文件一致的参数。

image

H2 数据库  URL 说明 ​

H2 官网文档地址

数据库支持多种连接模式和连接设置，不同的连接模式和连接设置是通过不同的 URL 来区分的，URL 中的设置是不区分大小写。

TopicURL Format and Examples
嵌入式（本地）连接jdbc:h2:[file:][<path>]<databaseName>
jdbc:h2:~/test
jdbc:h2:file:/data/sample
jdbc:h2:file:C:/data/sample (Windows only)
内存数据库（私有）jdbc:h2:mem:
内存数据库（被命名）jdbc:h2:mem:<databaseName>
jdbc:h2:mem:test_mem
使用 TCP/IP 的服务器模式（远程连接）jdbc:h2:tcp://<server>[:<port>]/[<path>]<databaseName>
jdbc:h2:tcp://localhost/~/test
jdbc:h2:tcp://dbserv:8084/~/sample
使用 SSL/TLS 的服务器模式（远程连接）jdbc:h2:ssl://<server>[:<port>]/<databaseName>
jdbc:h2:ssl://secureserv:8085/~/sample;
使用加密文件jdbc:h2:<url>;CIPHER=[AES|XTEA]
jdbc:h2:ssl://secureserv/~/testdb;CIPHER=AES
jdbc:h2:file:~/secure;CIPHER=XTEA
文件锁jdbc:h2:<url>;FILE_LOCK={NO|FILE|SOCKET}
jdbc:h2:file:~/quickAndDirty;FILE_LOCK=NO
jdbc:h2:file:~/private;CIPHER=XTEA;FILE_LOCK=SOCKET
仅打开存在的数据库jdbc:h2:<url>;IFEXISTS=TRUE
jdbc:h2:file:~/sample;IFEXISTS=TRUE
当虚拟机退出时并不关闭数据库jdbc:h2:<url>;DB_CLOSE_ON_EXIT=FALSE
用户名和密码jdbc:h2:<url>[;USER=<username>][;PASSWORD=<value>]
jdbc:h2:file:~/sample;USER=sa;PASSWORD=123
更新记入索引jdbc:h2:<url>;LOG=2
jdbc:h2:file:~/sample;LOG=2
调试跟踪项设置jdbc:h2:<url>;TRACE_LEVEL_FILE=<level 0..3>
jdbc:h2:file:~/sample;TRACE_LEVEL_FILE=3
忽略位置参数设置jdbc:h2:<url>;IGNORE_UNKNOWN_SETTINGS=TRUE
指定文件读写模式jdbc:h2:<url>;ACCESS_MODE_LOG=rws;ACCESS_MODE_DATA=rws
在 Zip 文件中的数据库jdbc:h2:zip:<zipFileName>!/<databaseName>
jdbc:h2:zip:~/db.zip!/test
兼容模式jdbc:h2:<url>;MODE=<databaseType>
jdbc:h2:~/test;MODE=MYSQL
自动重连接jdbc:h2:<url>;AUTO_RECONNECT=TRUE
jdbc:h2:tcp://localhost/~/test;AUTO_RECONNECT=TRUE
自动混合模式jdbc:h2:<url>;AUTO_SERVER=TRUE
jdbc:h2:~/test;AUTO_SERVER=TRUE
更改其他设置jdbc:h2:<url>;<setting>=<value>[;<setting>=<value>...]
jdbc:h2:file:~/sample;TRACE_LEVEL_SYSTEM_OUT=3

URL 个别参数说明 ​

jdbc:h2:file:C:/h2/vitality;AUTO_SERVER=TRUE;DB_CLOSE_ON_EXIT=FALSE;MODE=MYSQL;IGNORECASE=TRUE;DATABASE_TO_UPPER=FALSE

参数示例说明
AUTO_SERVER=TRUEDatabase may be already in use 问题。H2 数据库在内嵌模式下运行时只能有一个客户端连接，在连接之后，数据库会加锁，可以在 URL 后加 AUTO_SERVER=TRUE 启动自动混合模式（注意分号隔开），允许开启多个连接，但该参数不支持在内存中运行模式。注：file 方式不能加该参数，应该只有 mem 方式需要。
DB_CLOSE_ON_EXIT=FALSE默认情况下 H2 在虚拟机退出时是会自动关闭数据库， 通过在 URl 中设置 DB_CLOSE_ON_EXIT=FALSE 可以改变这个行为。即改为当虚拟机退出时不要关闭数据库
MODE=MYSQL兼容模式，H2 兼容多种数据库，该值可以为：DB2、Derby、HSQLDB、MSSQLServer、MySQL、Oracle、PostgreSQL
IGNORECASE=TRUEH2 默认不区分大小写（比如查询数据时），加上 IGNORECASE=TRUE 后，查询数据时就会区分大小写
DATABASE_TO_UPPER=FALSE1、这个参数是用来指定 H2 在创建数据库与表时，不要转换为大写。因为 H2 对大小写明感，默认会自动将英文转换为大写。
2、在第一次创建数据库时就必须指定此参数，否则会出现不生效的情况。
DATABASE_TO_LOWER=TRUE1、这个参数是用来指定 H2 在创建数据库与表时，把转换为小写。因为 H2 对大小写明感，默认情况下，会自动将英文转换为大写。
2、在第一次创建数据库时就必须指定此参数，否则会出现不生效的情况。
  1. 使用 JAVA 代码的方式启动 tcp h2 数据库
java
import lombok.extern.slf4j.Slf4j;
import org.h2.tools.Server;

import java.sql.SQLException;

@Slf4j
public class H2Server {

    private static Server server;

    private static final String port = "9999";

    public static void start() throws SQLException {
        server = Server.createTcpServer(new String[]{"-tcp", "-tcpAllowOthers", "-ifNotExists", "-tcpPort", port})
                .start();
        log.info(server.getURL());
    }

    public static void stop(){
        if(server != null){
            server.stop();
        }
    }

    public static void main(String[] args) {
        try {
            H2Server.start();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

Q: 应用程序连接时如何配置？

yaml
spring:
  datasource:
    driver-class-name: org.h2.Driver
    url: jdbc:h2:tcp://localhost:9999/./h2/test;AUTO_SERVER=TRUE;DB_CLOSE_ON_EXIT=FALSE;MODE=MYSQL
    username: sa
    password: