# H2 快速指南

<!-- TOC depthFrom:2 depthTo:2 -->

- [概述](#概述)
- [使用说明](#使用说明)
- [Spring 整合 H2](#spring-整合-h2)
- [H2 SQL](#h2-sql)
- [数据类型](#数据类型)
- [集群](#集群)
- [参考资料](#参考资料)
- [:door: 传送门](#door-传送门)

<!-- /TOC -->

## 概述

H2 是一个开源的嵌入式数据库引擎，采用 java 语言编写，不受平台的限制。同时 H2 提供了一个十分方便的 web 控制台用于操作和管理数据库内容。H2 还提供兼容模式，可以兼容一些主流的数据库，因此采用 H2 作为开发期的数据库非常方便。

## 使用说明

### H2 控制台应用

H2 允许用户通过浏览器接口方式访问 SQL 数据库。

1. 进入[官方下载地址](http://www.h2database.com/html/download.html)，选择合适版本，下载并安装到本地。
2. 启动方式：在 bin 目录下，双击 jar 包；执行 `java -jar h2*.jar`；执行脚本：`h2.bat` 或 `h2.sh`。
3. 在浏览器中访问：http://localhost:8082，应该可以看到下图中的页面：

<br><div align="center"><img src="http://dunwu.test.upcdn.net/cs/database/h2/h2-console.png!zp"/></div><br>

点击 **Connect** ，可以进入操作界面：

<br><div align="center"><img src="http://dunwu.test.upcdn.net/cs/database/h2/h2-console-02.png!zp"/></div><br>

操作界面十分简单，不一一细说。

### 嵌入式应用

#### JDBC API

```java
Connection conn = DriverManager.
    getConnection("jdbc:h2:~/test");
conn.close();
```

> 详见：[Using the JDBC API](http://www.h2database.com/html/tutorial.html#connecting_using_jdbc)

#### 连接池

```java
import org.h2.jdbcx.JdbcConnectionPool;
JdbcConnectionPool cp = JdbcConnectionPool.
create("jdbc:h2:~/test", "sa", "sa");
Connection conn = cp.getConnection();
conn.close(); cp.dispose();
```

> 详见：[Connection Pool](http://www.h2database.com/html/tutorial.html#connection_pool)

#### Maven

```xml
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>1.4.197</version>
</dependency>
```

> 详见：[Maven 2](http://www.h2database.com/html/build.html#maven2)

#### Hibernate

hibernate.cfg.xml (or use the HSQLDialect):

```xml
<property name="dialect">
    org.hibernate.dialect.H2Dialect
</property>
```

> 详见：[Hibernate](http://www.h2database.com/html/tutorial.html#using_hibernate)

#### TopLink 和 Glassfish

Datasource class: `org.h2.jdbcx.JdbcDataSource`
`oracle.toplink.essentials.platform.database.H2Platform`

> 详见：[TopLink and Glassfish](http://www.h2database.com/html/tutorial.html#using_toplink)

### 运行方式

#### 嵌入式

数据库持久化存储为单个文件。

连接字符串：`\~/.h2/DBName` 表示数据库文件的存储位置，如果第一次连接则会自动创建数据库。

- `jdbc:h2:\~/test` - 'test' 在用户根目录下
- `jdbc:h2:/data/test` - 'test' 在 /data 目录下
- `jdbc:h2:test` - 'test' 在当前工作目录

#### 内存式

数据库只在内存中运行，关闭连接后数据库将被清空，适合测试环境

连接字符串：`jdbc:h2:mem:DBName;DB_CLOSE_DELAY=-1`

如果不指定 DBName，则以私有方式启动，只允许一个连接。

- `jdbc:h2:mem:test` - 一个进程中有多个连接
- `jdbc:h2:mem:` - 未命名的私有库，一个连接

#### 服务模式

H2 支持三种服务模式：

- web server：此种运行方式支持使用浏览器访问 H2 Console
- TCP server：支持客户端/服务器端的连接方式
- PG server：支持 PostgreSQL 客户端

启动 tcp 服务连接字符串示例：

- `jdbc:h2:tcp://localhost/\~/test` - 用户根目录
- `jdbc:h2:tcp://localhost//data/test` - 绝对路径

#### 启动服务

执行 `java -cp *.jar org.h2.tools.Server`

执行如下命令，获取选项列表及默认值

```shell
java -cp h2*.jar org.h2.tools.Server -?
```

常见的选项如下：

- -web：启动支持 H2 Console 的服务
- -webPort <port>：服务启动端口，默认为 8082
- -browser：启动 H2 Console web 管理页面
- -tcp：使用 TCP server 模式启动
- -pg：使用 PG server 模式启动

#### 设置

- `jdbc:h2:..;MODE=MySQL` 兼容模式（或 HSQLDB 等）
- `jdbc:h2:..;TRACE_LEVEL_FILE=3` 记录到 `*.trace.db`

#### 连接字符串参数

- `DB_CLOSE_DELAY` - 要求最后一个正在连接的连接断开后，不要关闭数据库
- `MODE=MySQL` - 兼容模式，H2 兼容多种数据库，该值可以为：DB2、Derby、HSQLDB、MSSQLServer、MySQL、Oracle、PostgreSQL
- `AUTO_RECONNECT=TRUE` - 连接丢失后自动重新连接
- `AUTO_SERVER=TRUE` - 启动自动混合模式，允许开启多个连接，该参数不支持在内存中运行模式
- `TRACE_LEVEL_SYSTEM_OUT`、`TRACE_LEVEL_FILE` - 输出跟踪日志到控制台或文件， 取值 0 为 OFF，1 为 ERROR（默认值），2 为 INFO，3 为 DEBUG
- `SET TRACE_MAX_FILE_SIZE mb` - 设置跟踪日志文件的大小，默认为 16M

#### maven 方式

此外，使用 maven 也可以启动 H2 服务。添加以下插件

```xml
<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>exec-maven-plugin</artifactId>
  <executions>
    <execution>
      <goals>
        <goal>java</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <mainClass>org.h2.tools.Server</mainClass>
    <arguments>
      <argument>-web</argument>
      <argument>-webPort</argument>
      <argument>8090</argument>
      <argument>-browser</argument>
    </arguments>
  </configuration>
</plugin>
```

在命令行中执行如下命令启动 H2 Console

```shell
mvn exec:java
```

或者建立一个 bat 文件

```shell
@echo off
call mvn exec:java
pause
```

此操作相当于执行了如下命令：

```shell
java -jar h2-1.3.168.jar -web -webPort 8090 -browser
```

## Spring 整合 H2

1.  添加依赖

```xml
<dependency>
  <groupId>com.h2database</groupId>
  <artifactId>h2</artifactId>
  <version>1.4.194</version>
</dependency>
```

2.  spring 配置

```xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:jdbc="http://www.springframework.org/schema/jdbc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
            http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
            http://www.springframework.org/schema/jdbc
            http://www.springframework.org/schema/jdbc/spring-jdbc.xsd">

  <!--配置数据源-->
  <bean id="dataSource" class="org.h2.jdbcx.JdbcConnectionPool"
        destroy-method="dispose">
    <constructor-arg>
      <bean class="org.h2.jdbcx.JdbcDataSource">
        <!-- 内存模式 -->
        <property name="URL" value="jdbc:h2:mem:test"/>
        <!-- 文件模式 -->
        <!-- <property name="URL" value="jdbc:h2:testRestDB" /> -->
        <property name="user" value="root"/>
        <property name="password" value="root"/>
      </bean>
    </constructor-arg>
  </bean>

  <!-- JDBC模板 -->
  <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
    <constructor-arg ref="dataSource"/>
  </bean>
  <bean id="myJdbcTemplate" class="org.zp.notes.spring.jdbc.MyJdbcTemplate">
    <property name="jdbcTemplate" ref="jdbcTemplate"/>
  </bean>

  <!-- 初始化数据表结构 -->
  <jdbc:initialize-database data-source="dataSource" ignore-failures="ALL">
    <jdbc:script location="classpath:sql/h2/create_table_student.sql"/>
  </jdbc:initialize-database>
</beans>
```

## H2 SQL

### SELECT

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-a3f90c0d1f1f3437.png"/></div><br>

### INSERT

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-6a92ae4362c3468a.png"/></div><br>

### UPDATE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-dddf0e26995d46c3.png"/></div><br>

### DELETE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-96e72023445a6fd6.png"/></div><br>

### BACKUP

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-6267894d24fab47f.png"/></div><br>

### EXPLAIN

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-bbed6bb69f998b7a.png"/></div><br>

7、MERGE
<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-bd021648431d12a7.png"/></div><br>

### RUNSCRIPT

运行 sql 脚本文件

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-d6fe03eff0037e14.png"/></div><br>

### SCRIPT

根据数据库创建 sql 脚本

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-9ba7547ab8bcaeab.png"/></div><br>

### SHOW

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-67449c6cc5cbb8c1.png"/></div><br>

### ALTER

#### ALTER INDEX RENAME

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-230bd3f97e185d2f.png"/></div><br>

#### ALTER SCHEMA RENAME

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-797a028938e46ba3.png"/></div><br>

#### ALTER SEQUENCE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-46f343da1b6c6a29.png"/></div><br>

#### ALTER TABLE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-7e146a4010f2f357.png"/></div><br>

##### 增加约束

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-4e5605a9c87a79cb.png"/></div><br>

##### 修改列

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-fbc1358c553e6614.png"/></div><br>

##### 删除列

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-dc3b897413700981.png"/></div><br>

##### 删除序列

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-ec83899cb8724966.png"/></div><br>

#### ALTER USER

##### 修改用户名

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-a1e429c0d8ece66c.png"/></div><br>

##### 修改用户密码

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-5b86f98796606e54.png"/></div><br>

#### ALTER VIEW

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-8832ecbc2db63a13.png"/></div><br>

### COMMENT

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-467ce031883f0020.png"/></div><br>

### CREATE CONSTANT

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-1231c83563bfec9c.png"/></div><br>

### CREATE INDEX

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-d66d59bd7803d5c1.png"/></div><br>

### CREATE ROLE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-7df1dee098e1127b.png"/></div><br>

### CREATE SCHEMA

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-c485123c62c0866e.png"/></div><br>

### CREATE SEQUENCE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-cc25860776d361ae.png"/></div><br>

### CREATE TABLE

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-36ffc66327df8b5b.png"/></div><br>

### CREATE TRIGGER

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-9a7bfa4425281213.png"/></div><br>

### CREATE USER

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-a1e45e308be6dac3.png"/></div><br>

### CREATE VIEW

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-45c4cd516fd36611.png"/></div><br>

### DROP

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-52a3562d76411811.jpg"/></div><br>

### GRANT RIGHT

给 schema 授权授权

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-750e96ceff00c4ee.png"/></div><br>

给 schema 授权给 schema 授权

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-22cfd65c2ff1eea5.png"/></div><br>

#### 复制角色的权限

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-6cba2f1585fd913b.png"/></div><br>

### REVOKE RIGHT

#### 移除授权

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-3f905669cbb331b7.png"/></div><br>

#### 移除角色具有的权限

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-af77f495222f1b30.png"/></div><br>

### ROLLBACK

#### 从某个还原点（savepoint）回滚

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-c71a226ac4fff913.png"/></div><br>

#### 回滚事务

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-efb65c504c7d69c2.png"/></div><br>

#### 创建 savepoint

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-feefdc236d4b211d.png"/></div><br>

## 数据类型

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-52296dd53249cdae.png"/></div><br>

### INT Type

<br><div align="center"><img src="http://upload-images.jianshu.io/upload_images/3101171-fe62e3d07eb93d11.png"/></div><br>

## 集群

H2 支持两台服务器运行两个数据库成为集群，两个数据库互为备份，如果一个服务器失效，另一个服务器仍然可以工作。另外只有服务模式支持集群配置。

H2 可以通过 CreateCluster 工具创建集群，示例步骤如下（在在一台服务器上模拟两个数据库组成集群）：

- 创建目录
  - 创建两个服务器工作的目录
- 启动 tcp 服务
  - 执行如下命令分别在 9101、9102 端口启动两个使用 tcp 服务模式的数据库
- 使用 CreateCluster 工具创建集群
  - 如果两个数据库不存在，该命令将会自动创建数据库。如果一个数据库失效，可以先删除坏的数据库文件，重新启动数据库，然后重新运行 CreateCluster 工具
- 连接数据库现在可以使用如下连接字符串连接集群数据库
  - 监控集群**运行状态**
  - 可以使用如下命令查看配置的集群服务器是否都在运行
- 限制
  - H2 的集群并不支持针对事务的负载均衡，所以很多操作会使两个数据库产生不一致的结果
- 执行如下操作时请小心：
  - 自动增长列和标识列不支持集群，当插入数据时，序列值需要手动创建不支持 SET AUTOCOMMIT FALSE 语句；
  - 如果需要设置成为不自动提交，可以执行方法 Connection.setAutoCommit(false)

## 参考资料

- [h2database 官网](http://www.h2database.com/html/main.html)
- [Java 嵌入式数据库 H2 学习总结(一)——H2 数据库入门](https://www.cnblogs.com/xdp-gacl/p/4171024.html)

## :door: 传送门

| [我的 Github 博客](https://github.com/dunwu/blog) | [db-tutorial 首页](https://github.com/dunwu/db-tutorial) |