H2 数据库使用简介
一、前言
H2 是一个用 Java 开发的嵌入式数据库,它本身只是一个类库,即只有一个 jar 文件,可以直接嵌入到应用项目中。H2 主要有如下三个用途:
第一个用途,也是最常使用的用途就在于可以同应用程序打包在一起发布,这样可以非常方便地存储少量结构化数据。
第二个用途是用于单元测试。启动速度快,而且可以关闭持久化功能,每一个用例执行完随即还原到初始状态。
第三个用途是作为缓存,即当做内存数据库,作为NoSQL的一个补充。当某些场景下数据模型必须为关系型,可以拿它当Memcached使,作为后端MySQL/Oracle的一个缓冲层,缓存一些不经常变化但需要频繁访问的数据,比如字典表、权限表。
二、下载安装
2.1 下载
h2 数据库下载地址:http://www.h2database.com/html/main.html 或者 http://www.h2database.com/html/download.html
选择 "All Platforms" 版本,是一个压缩包,解压后即可使用既可用于 Windows 平台,也可用于 Linux 平台。
2.2 H2 目录结构
三、管理终端
3.1 启动
进入H2 的 bin 目录,如果在 Window 环境下使用,可以运行 h2.bat 或 h2w.bat。区别只是后者是后台静默运行。
如果你在 Linux 环境下,可运行./h2.sh 文件来启动数据库服务。但不建议这样直接启动,因为还有一些参数可以设置。可进行如下修改:
1)复制h2.sh为h2_server.sh文件;
2)编辑h2_server.sh,如下:
#!/bin/sh
dir=$(dirname"$0")
java -cp "$dir/h2-1.4.197.jar:$H2DRIVERS:$CLASSPATH" org.h2.tools.Server -tcpAllowOthers -webAllowOthers -webPort 8082 "$@"
3)说明:
org.h2.tools.Server: 以服务器模式启动
-tcpAllowOthers: 允许远程机器通过TCP方式访问
-webAllowOthers: 允许远程机器通过浏览器访问
-webPort 8082: 默认的访问端口(8082为未被占用的端口,如果此端口已经被其他端口占用,则改为其他端口)
4)具体的运行方式
chmod修改文件权限;
输入nohup ./h2_server.sh & 回车。这样可以后台运行。
nohup 命令可以在你退出账户之后继续运行相应的进程。nohup 就是不挂起的意思(no hang up)。& 表示让该进程实现后台运行。该命令的一般形式为:
# nohup command &
比如运行了 h2.bat,系统会进入:
或者自己打开浏览器,输入地址:http://localhost:8082 访问 H2 数据库的 Web Console。这里就需要说明一下 "~" 这个符号在window操作系统下代表什么意思,在Window操作系统下,"~"这个符号代表的就是当前登录到操作系统的用户对应的用户目录,与 Linux 系统中的意义相同,代表用户家目录。
最上方可以选择 language,可以进行语言切换。如切换成中文:
点击蓝色字体配置,可以跳转到配置H2数据库的另一个页面,点击工具,会给你提供一堆对H2数据库操作的功能,比如:备份、还原、恢复、集群、运行脚本、删除文件等等。点击帮助,会提示一些关于 H2 数据库使用的帮助信息。接下来就是最重要的配置数据库连接信息,驱动类和 JDBC URL 是默认的,如果你想创建一个新的数据库,直接修改 jdbc:h2:[输入你想创建的数据库文件的路径],就可以为你自动创建一个新的数据库(在指定路径下会创建对应的数据库文件 xxxx.mv.db),用户名密码由用户自行定义,连接数据库之前还可以点击测试连接,测试是否可以正确连接。
如下:
生成的数据库文件:
点击连接后可进入管理终端,很类似于 phpMyAdmin 这样的 Web 管理终端,执行具体的数据库 SQL 语句:
常用的两个快捷键:
按 Ctrl+Enter 执行输入区的 SQL,按 Shift+Enter 执行当前选中的 SQL。
四、应用程序开发
H2数据库的开发非常简单,和 MySQL 等没有太大区别。
4.1 加入 Maven 依赖
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<version>1.4.197</version>
</dependency>
4.2 创建 db.properties
driverClassName=org.h2.Driver
# 此处的写法是使用嵌入模式链接 H2 库,紧接着那行是使用 Server Mode 用 tcp 连接。区别是前者性能更好,后者可同时供多个客户端连接。
url=jdbc:h2:F:/software/h2data/h2test
#url=jdbc:h2:tcp://localhost//usr/h2data/h2test=rootpassword=123456
注意:
比如上面创建了 db.properties 文件,然后将其放入项目的 resources 目录中,此时需要打开项目的 .classpath 文件,加入:<classpathentry kind="src" path="resources"/>
通常 .classpath 文件中均会包含如下设置:
<classpathentry kind="src" path="src"/>
<classpathentry kind="src" path="resources"/>
显示如下:
关于 .classpath 文件的具体讲解,可以参考如下博客文章:
4.3 JDBC 连接 H2
可以参考附录中的博客文章地址,与使用其他的数据库操作相同。
五、H2 连接方式
H2 支持以下三种连接模式:
1)嵌入式模式(使用 JDBC 的本地连接)
2)服务器模式(使用 JDBC 或 ODBC 在 TCP/IP 上的远程连接)
3)混合模式(本地和远程连接同时进行)
5.1 嵌入式模式
在嵌入式模式下,应用程序使用JDBC从同一JVM中打开数据库。这是最快也是最容易的连接方式。缺点是数据库可能只在任何时候在一个虚拟机(和类加载器)中打开。与所有模式一样,支持持久性和内存数据库。对并发打开数据库的数量或打开连接的数量没有限制。
5.2 服务器模式
当使用服务器模式(有时称为远程模式或客户机/服务器模式)时,应用程序使用 JDBC 或 ODBC API 远程打开数据库。服务器需要在同一台或另一台虚拟机上启动,或者在另一台计算机上启动。许多应用程序可以通过连接到这个服务器同时连接到同一个数据库。在内部,服务器进程在嵌入式模式下打开数据库。
服务器模式比嵌入式模式慢,因为所有数据都通过TCP/IP传输。与所有模式一样,支持持久性和内存数据库。对每个服务器并发打开的数据库数量或打开连接的数量没有限制。
5.3 混合模式
混合模式是嵌入式和服务器模式的结合。连接到数据库的第一个应用程序在嵌入式模式下运行,但也启动服务器,以便其他应用程序(在不同进程或虚拟机中运行)可以同时访问相同的数据。本地连接的速度与数据库在嵌入式模式中的使用速度一样快,而远程连接速度稍慢。
服务器可以从应用程序内(使用服务器API)启动或停止,或自动(自动混合模式)。当使用自动混合模式时,所有想要连接到数据库的客户端(无论是本地连接还是远程连接)都可以使用完全相同的数据库URL来实现。
以上不同的连接方式对应不同的 JDBC URL,可以参考如下附录表格中的连接格式。
附录:H2 数据库不同模式连接字串
在 H2 的安装目录下,如:F:\software\h2\docs\h2.pdf 中,可以查看其帮助文档。
可参考如下博客文章学习 Java 连接 H2:
Java嵌入式数据库H2学习总结(二)——在Web应用程序中使用H2数据库
Java嵌入式数据库H2学习总结(三)——在Web应用中嵌入H2数据库
URL Format and Examples | |
Embedded (local) connection | jdbc:h2:[file:][<path>]<databaseName> jdbc:h2:~/test jdbc:h2:file:/data/sample jdbc:h2:file:C:/data/sample (Windows only) |
In-memory (private) | jdbc:h2:mem: |
In-memory (named) | jdbc:h2:mem:<databaseName> jdbc:h2:mem:test_mem |
Server mode (remote connections) using TCP/IP | jdbc:h2:tcp://<server>[:<port>]/[<path>]<databaseName> jdbc:h2:tcp://localhost/~/test jdbc:h2:tcp://dbserv:8084/~/sample jdbc:h2:tcp://localhost/mem:test |
Server mode (remote connections) using TLS | jdbc:h2:ssl://<server>[:<port>]/<databaseName> jdbc:h2:ssl://localhost:8085/~/sample; |
Using encrypted files | jdbc:h2:<url>;CIPHER=AES jdbc:h2:ssl://localhost/~/test;CIPHER=AES jdbc:h2:file:~/secure;CIPHER=AES |
File locking methods | jdbc:h2:<url>;FILE_LOCK={FILE|SOCKET|NO} jdbc:h2:file:~/private;CIPHER=AES;FILE_LOCK=SOCKET |
Only open if it already exists | jdbc:h2:<url>;IFEXISTS=TRUE jdbc:h2:file:~/sample;IFEXISTS=TRUE |
Don't close the database when the VM exits | jdbc:h2:<url>;DB_CLOSE_ON_EXIT=FALSE |
Execute SQL on connection | jdbc:h2:<url>;INIT=RUNSCRIPT FROM '~/create.sql' jdbc:h2:file:~/sample;INIT=RUNSCRIPT FROM '~/create.sql'\;RUNSCRIPT FROM '~/populate.sql' |
User name and/or password | jdbc:h2:<url>[;USER=<username>][;PASSWORD=<value>] jdbc:h2:file:~/sample;USER=sa;PASSWORD=123 |
Debug trace settings | jdbc:h2:<url>;TRACE_LEVEL_FILE=<level 0..3> jdbc:h2:file:~/sample;TRACE_LEVEL_FILE=3 |
Ignore unknown settings | jdbc:h2:<url>;IGNORE_UNKNOWN_SETTINGS=TRUE |
Custom file access mode | jdbc:h2:<url>;ACCESS_MODE_DATA=rws |
Database in a zip file | jdbc:h2:zip:<zipFileName>!/<databaseName> jdbc:h2:zip:~/db.zip!/test |
Compatibility mode | jdbc:h2:<url>;MODE=<databaseType> jdbc:h2:~/test;MODE=MYSQL |
Auto-reconnect | jdbc:h2:<url>;AUTO_RECONNECT=TRUE jdbc:h2:tcp://localhost/~/test;AUTO_RECONNECT=TRUE |
Automatic mixed mode | jdbc:h2:<url>;AUTO_SERVER=TRUE jdbc:h2:~/test;AUTO_SERVER=TRUE |
Page size | jdbc:h2:<url>;PAGE_SIZE=512 |
Changing other settings | jdbc:h2:<url>;<setting>=<value>[;<setting>=<value>...] jdbc:h2:file:~/sample;TRACE_LEVEL_SYSTEM_OUT=3 |