dunwu
/
db-tutorial
mirror of https://github.com/dunwu/db-tutorial.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
db-tutorial/docs/sql/h2.md

474 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 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) |
Reference in New Issue View Git Blame Copy Permalink