命令行工具有:

  • Backup 创建数据库备份
  • ChangeFileEncryption 允许改变文件加密密码和数据库的加密算法
  • Console 启动基于浏览器的 H2 控制台
  • ConvertTraceFile 转换 .trace.db 文件到 Java 应用和 SQL 脚本
  • CreateCluster 从一个独立的数据库服务创建集群
  • DeleteDbFiles 删除所有的数据库文件
  • Recover 恢复损坏的数据库
  • Restore 从数据库备份中恢复数据库
  • RunScript 运行数据库 SQL 脚本
  • Script 为数据库备份或迁移导出 SQL 脚本
  • Server 启动 H2 服务模式
  • Shell 命令行工具

这些工具也能在程序中通过调用相应的方法来使用,相关详细的调用说明,请参考 JavaDoc 文档。

Shell 工具

Shell 工具是最简单的命令行工具,开始时,输入:

  1. java -cp h2*.jar org.h2.tools.Shell

你会要求输入数据库URL、JDBC 驱动、用户名和密码。连接设置也可以作为命令行参数设置。连接后,你会得到的列表选项。内置命令不需要以分号结束,但只是执行 SQL 语句,需要以分号 ;作为结束。这允许输入多行语句:

  1. sql> select * from test
  2. ...> where id = 0;

默认情况下,结果是打印成表。结果有许多列,考虑使用模式列表:

  1. sql> list
  2. Result list mode is now on
  3. sql> select * from test;
  4. ID : 1
  5. NAME: Hello
  6. ID : 2
  7. NAME: World
  8. (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). 如访问标签:

  1. <all-permissions/>
  2. </security>

如果 H2 的数据库已经打开,打开一个连接很快。如果要打开和关闭许多连接,使用连接池,可以提升性能。H2 包含了一个简单的连接池,它是基于Christian d’Heureuse 的 。还有其他更复杂的开源连接池可以使用,如Apache Commons DBCP。H2 从内置连接池获取连接比使用DriverManager.getConnection()快两倍左右。内置的连接池使用方法如下:

  1. import java.sql.*;
  2. public class Test {
  3. public static void main(String[] args) throws Exception {
  4. JdbcConnectionPool cp = JdbcConnectionPool.create(
  5. "jdbc:h2:~/test", "sa", "sa");
  6. for (int i = 0; i < args.length; i++) {
  7. Connection conn = cp.getConnection();
  8. conn.createStatement().execute(args[i]);
  9. conn.close();
  10. }
  11. cp.dispose();
  12. }
  13. }

全文检索

H2 包含了两种全文检索的实现。一种通过使用 Apache Lucene 来实现,另一种是通过存储索引文件到数据库里的一张特殊表来实现的(私有实现)。

通过下面的调用来实现初始化:

如果你要用到私有全文检索,你需要在每个数据库里都初始化它。然后你能创建一张表用于全文检索的索引,如:

  1. CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR);
  2. INSERT INTO TEST VALUES(1, 'Hello World');

PUBLIC 是 schema 的名字, TEST 是索引表名。字段名列表是可选的,在上面的例子中,所有的字段都被索引,索引的更新是实时的,使用下面的查询语句可以进行搜索:

  1. SELECT * FROM FT_SEARCH('Hello', 0, 0);

下面的语句将得到一个指定内容的搜索结果集。

  1. QUERY: "PUBLIC"."TEST" WHERE "ID"=1

删除表上的索引

  1. CALL FT_DROP_INDEX('PUBLIC', 'TEST');

你也能在 Java 应用中使用索引:

  1. org.h2.fulltext.FullText.search(conn, text, limit, offset);
  2. org.h2.fulltext.FullText.searchData(conn, text, limit, offset);

用 Lucene 实现的全文检索

使用 Lucene 实现的全文检索,你需要将 Lucene 加入到 classpath 中,并且处理相关的依赖,如果你使用 H2 控制台,你能增加 Lucene 的 jar 文件到环境变量 H2DRIVERSCLASSPATH 中。通过下面的语句初始化 Lucene 全文检索:

如果你需要是使用 Lucene 全文检索,你每个数据库都需要初始化。你也能通过下面的语句创建全文索引表:

  1. CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR);
  2. INSERT INTO TEST VALUES(1, 'Hello World');
  3. CALL FTL_CREATE_INDEX('PUBLIC', 'TEST', NULL);

PUBLIC 是 schema 名, TEST 是表名. 字段名列表是可选的,在上面的例子中,所有的字段都被索引,索引的更新是实时的,使用下面的查询语句可以进行搜索:

  1. SELECT * FROM FTL_SEARCH('Hello', 0, 0);

下面的语句将得到一个指定内容的搜索结果集:

  1. QUERY: "PUBLIC"."TEST" WHERE "ID"=1

表上的索引(警告称,这将对所有的整个数据库的全文索引进行检索):

  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应用中使用索引:

  1. org.h2.fulltext.FullTextLucene.search(conn, text, limit, offset);

Lucene 搜索支持全文搜索仅在特定的列。列名必须大写(如果原始列双援引除外)。为列名下划线(_),另一个强调需要添加。例子: