命令行工具有:
- Backup 创建数据库备份
- ChangeFileEncryption 允许改变文件加密密码和数据库的加密算法
- Console 启动基于浏览器的 H2 控制台
- ConvertTraceFile 转换
.trace.db
文件到 Java 应用和 SQL 脚本 - CreateCluster 从一个独立的数据库服务创建集群
- DeleteDbFiles 删除所有的数据库文件
- Recover 恢复损坏的数据库
- Restore 从数据库备份中恢复数据库
- RunScript 运行数据库 SQL 脚本
- Script 为数据库备份或迁移导出 SQL 脚本
- Server 启动 H2 服务模式
- Shell 命令行工具
这些工具也能在程序中通过调用相应的方法来使用,相关详细的调用说明,请参考 JavaDoc 文档。
Shell 工具
Shell 工具是最简单的命令行工具,开始时,输入:
java -cp h2*.jar org.h2.tools.Shell
你会要求输入数据库URL、JDBC 驱动、用户名和密码。连接设置也可以作为命令行参数设置。连接后,你会得到的列表选项。内置命令不需要以分号结束,但只是执行 SQL 语句,需要以分号 ;
作为结束。这允许输入多行语句:
sql> select * from test
...> where id = 0;
默认情况下,结果是打印成表。结果有许多列,考虑使用模式列表:
sql> list
Result list mode is now on
sql> select * from test;
ID : 1
NAME: Hello
ID : 2
NAME: World
(2 rows, 0 ms)
OpenOffice.org 基础框架支持通过 JDBC 连接数据库。你也可以通过 OpenOffice 框架连接到 H2 数据库。首先将 JDBC 驱动增加到 OpenOffice 中,下面的步骤可以连接到H2数据库:
- 启动 OpenOffice Writer,进入[Tools], [Options]
- 确认你在 OpenOffice.org/Java 中选择了 JAVA 运行环境
- 单击 [Class Path…], [Add Archive…]
- 选择你的 h2 的 jar 文件(本机上的路径可以由你选择)
- 单击 [OK] (按要求的点击), 停止OpenOffice (包括 Quickstarter)
- 启动 OpenOffice 框架
- 连接到一个存在的数据库;选择 [JDBC]; [Next]
- 输入数据库URL,如:
jdbc:h2:~/test
- 输入 JDBC 驱动类:
org.h2.Driver
你可以访问存于用户当前目录的数据库。
使用 H2 数据通过 NeoOffice (去掉 X11 的 OpenOffice):
- 在 NeoOffice,到[NeoOffice], [Preferences]
- 在[NeoOffice]页下找到[Java]
- 单击[Class Path], [Add Archive…]
- 选择 h2 的 jar 文件(本地目录,任你选择合适的目录)
- 单击[OK](根据需要),重启 NeoOffice
现在,你可以通过”Database Wizard”创建一新的数据库:
- 单击[File], [New], [Database]
- 选择[Connect to existing database],并且选择[JDBC],单击next
- 输入数据源的URL,例如:
jdbc:h2:~/test
- JDBC驱动类: org.h2.Driver
- 将 H2 的 jar 包打包到一个扩展包中
- 在 NeoOffice 中作为扩展 Java 包进行安装
这个能通过使用 NetBeans OpenOffice 插件来创建。详细看
Java Web Start / JNLP
当使用 Java Web Start / JNLP(JAVA网络加载协议),允许访问标签必须被设置在 .jnlp 文件,并且 .jar 的应用文件必须被签名,否则,当你试着去写文件系统,下面的异常将会被抛出:java.security.AccessControlException
: 拒绝访问 (java.io.FilePermission ... read
). 如访问标签:
<all-permissions/>
</security>
如果 H2 的数据库已经打开,打开一个连接很快。如果要打开和关闭许多连接,使用连接池,可以提升性能。H2 包含了一个简单的连接池,它是基于Christian d’Heureuse 的 。还有其他更复杂的开源连接池可以使用,如Apache Commons DBCP。H2 从内置连接池获取连接比使用DriverManager.getConnection()
快两倍左右。内置的连接池使用方法如下:
import java.sql.*;
public class Test {
public static void main(String[] args) throws Exception {
JdbcConnectionPool cp = JdbcConnectionPool.create(
"jdbc:h2:~/test", "sa", "sa");
for (int i = 0; i < args.length; i++) {
Connection conn = cp.getConnection();
conn.createStatement().execute(args[i]);
conn.close();
}
cp.dispose();
}
}
全文检索
H2 包含了两种全文检索的实现。一种通过使用 Apache Lucene 来实现,另一种是通过存储索引文件到数据库里的一张特殊表来实现的(私有实现)。
通过下面的调用来实现初始化:
如果你要用到私有全文检索,你需要在每个数据库里都初始化它。然后你能创建一张表用于全文检索的索引,如:
CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR);
INSERT INTO TEST VALUES(1, 'Hello World');
PUBLIC 是 schema 的名字, TEST 是索引表名。字段名列表是可选的,在上面的例子中,所有的字段都被索引,索引的更新是实时的,使用下面的查询语句可以进行搜索:
SELECT * FROM FT_SEARCH('Hello', 0, 0);
下面的语句将得到一个指定内容的搜索结果集。
QUERY: "PUBLIC"."TEST" WHERE "ID"=1
删除表上的索引
CALL FT_DROP_INDEX('PUBLIC', 'TEST');
你也能在 Java 应用中使用索引:
org.h2.fulltext.FullText.search(conn, text, limit, offset);
org.h2.fulltext.FullText.searchData(conn, text, limit, offset);
用 Lucene 实现的全文检索
使用 Lucene 实现的全文检索,你需要将 Lucene 加入到 classpath 中,并且处理相关的依赖,如果你使用 H2 控制台,你能增加 Lucene 的 jar 文件到环境变量 H2DRIVERS
或 CLASSPATH
中。通过下面的语句初始化 Lucene 全文检索:
如果你需要是使用 Lucene 全文检索,你每个数据库都需要初始化。你也能通过下面的语句创建全文索引表:
CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR);
INSERT INTO TEST VALUES(1, 'Hello World');
CALL FTL_CREATE_INDEX('PUBLIC', 'TEST', NULL);
PUBLIC 是 schema 名, TEST 是表名. 字段名列表是可选的,在上面的例子中,所有的字段都被索引,索引的更新是实时的,使用下面的查询语句可以进行搜索:
SELECT * FROM FTL_SEARCH('Hello', 0, 0);
下面的语句将得到一个指定内容的搜索结果集:
QUERY: "PUBLIC"."TEST" WHERE "ID"=1
表上的索引(警告称,这将对所有的整个数据库的全文索引进行检索):
CALL FTL_DROP_INDEX('PUBLIC', 'TEST');
要得到原始的数据,需要使用 FTL_SEARCH_DATA('Hello', 0, 0);
。结果包含字段 SCHEMA (schema名), TABLE (表名), COLUMNS (字段名数组), 和KEYS (对象数组)。可以和表做连接,使用连接如下SELECT T.* FROM FTL_SEARCH_DATA('Hello', 0, 0) FT, TEST T WHERE FT.TABLE='TEST' AND T.ID=FT.KEYS[0]
;
你也能在JAVA应用中使用索引:
org.h2.fulltext.FullTextLucene.search(conn, text, limit, offset);
Lucene 搜索支持全文搜索仅在特定的列。列名必须大写(如果原始列双援引除外)。为列名下划线(_),另一个强调需要添加。例子: