HSQLDB 　 HSQLDBの基本的な使い方
　 2025/03/23


HSQLDBのインストール

HSQLDBはHyperSQLとも呼ばれる、Javaで書かれたオープンソースのRDBMSです。
Javaで書かれたRDBMSとしては、JavaDB(Apache Derby、その前にはCloudscapeと呼ばれていたもの)、 H2 Databaseと並んでよく知られたソフトウェアです。

  1. ホームページからZipファイルをダウンロードします。 私が使用したのは2.3.3から2.7.0の各バージョンです。
  2. 展開すると、hsqldbというディレクトリがありますが、基本的な操作はその中のlibの下にある、 hsqldb.jar と sqltool.jar だけで可能です。これらをどこかにコピーして配置します。
  3. データベース・ファイルを置くディレクトリも任意に決めて作ります。
    hsqldb.jarを置いたディレクトリのそば(例えば./databaseというディレクトリを自分で作る) でも、全く関係ない場所に作ってもOKです。管理しやすい場所でいいでしょう。


実行モード

hsqldbには、大きく二つのモードがあります。

簡単なのは後者の方なので、先にこちらを説明します。


SqlToolを対話的に使う

HSQLDBのコマンドラインツールはSqlToolという物です。 OracleのSQL*Plusに当たるもので、このツールもJavaで書かれています。起動コマンドの例を挙げます。 

java -jar /opt/tools/sqltool.jar --inlineRc=url=jdbc:hsqldb:file:/usr/dev1/database/nkdb;shutdown=true,user=sa
セミコロンとカンマの使い分けに注意してください。 「;shutdown=true」は、url=の一部です。その後ろの「user=sa」は、url=...とは別のパラメータになります。
起動すると、パスワードを尋ねるプロンプトが現れます。 HSQLDBのデフォルトユーザーはsaという名前で、パスワードは未設定です。 そこで何も入力せずにENTERキーを押すと、/usr/dev1/database/nkdb というデータベースが読み込まれ (まだなければ新規に作成されて)、CREATE TABLE文、INSERT文、SELECT文などの対話的な実行が可能になります。
ちなみに、この例ではデータベースを絶対パスで指定していますが、次のように相対パスでも指定できます。 
java -jar /opt/tools/sqltool.jar --inlineRc=url=jdbc:hsqldb:file:./database/nkdb;shutdown=true,user=sa

使い方ですが、とりあえず「\?」と打つとヘルプが出ます。
よく使うコマンドは以下の通りです。

いきなりですが終了は\qです。(最初に覚えておくことですね)

「\i SQLファイル」を実行すると、SQLファイルに書かれたSQLが実行されます。 CREATE TABLE文などのDDLを実行するのに使います。 このとき、処理結果のメッセージ等は何も出ないので、慌てないように。 そうそうこれらのコマンドを打つときはSQLを打つのと異なり「;」は不要です。改行と同時に実行されます。
なお、\iで実行するファイルにはコメントを書くことができます。 コメントは「-- コメント」「/* コメント */」「// コメント」の3種類で書けます。 それぞれ私がOracle式、C言語式、C++式と読んでいる書き方ですね(実態は違います…)

「\d 表などのオブジェクト名」を実行すると、 OracleのDESCRIBE(DESC)のように定義情報を見ることができます。
また「\dt」と打つとテーブルの一覧が、「\dv」と打つとビューの一覧が表示されます。 他にもオブジェクト種別ごとに「\d+1文字」の形で一覧が見れます。 それらはヘルプに書いてあります。 というか、後で知ったのですが\d+1文字のコマンドはPostgreSQLのpsqlツールと同じですね。
データファイルから表へのインポート、その逆のエクスポートは、 それぞれ\m、\xで行えます。\m?、\x?と打つとそれぞれ詳細な説明が見れます。
インポートについてこの下で詳しくご紹介します。


shutdown=trueの意味

URLがfile:で始まるとき、URLの末尾に「;shutdown=true」を付けるかどうかで動作に致命的な違いがあります。
これを失念していると延々と悩むことになるので(というか悩みました)先にメモしておきます。

まず、SqlToolはデフォルトでオートコミットではありません。 さらに、DML文を発行しても、COMMITせずに終了するとデータの変更は保存されません。 SqlToolでデータを変更して終了するときは必ずCOMMITを発行する必要があります。

そして、それと根本的に別物の注意点がもう一つあります。 「;shutdown=true」を付けない場合、自分でSHUTDOWNコマンドを発行しない限りなんとDDL文の結果すら保存されません。 後に触れるServerモードでは、SHUTDOWNを実行してしまうと他のユーザーからの接続も強制終了になってしまうため、 コネクションの終了のたびにSHUTDOWNを実行するわけにはいきませんが、 In-ProcessモードでDB接続してDDLを発行したら終了時にそれを必ず保存したい場合には 「;shutdown=true」を付けておくのが分かりやすいと思います。


ifexists=trueの使用

URLにifexists=trueを付けると、指定されたデータベースが存在するときだけDB接続が行われ、 存在しない場合はエラーになります。これを付けておくと、タイプミスなどで存在しないDBを指定した時、 余計なファイルが作られてしまうのを防げます。 

java -jar /opt/tools/sqltool.jar --inlineRc=url=jdbc:hsqldb:file:/usr/dev1/database/nkdb;shutdown=true;ifexists=true,user=sa


sqltool.rcの使用

これまでの例のように--inlineRcオプションでURLとユーザーを指定する方法だと、 パスワードは対話的に必ず聞かれます。 バッチ処置などでパスワードも設定ファイルから読むことで非対話的に処理を実行したい場合は、 sqltool.rc という設定ファイルを作成します。

  1. まず、hsqldbのsampleディレクトリ内にある sqltool.rc というファイルを好きな場所にコピーして、編集します。 
    urlid nkdb
url jdbc:hsqldb:file:/usr/dev1/database/nkdb;shutdown=true
username SA
password

urlid localhost-sa
url jdbc:hsqldb:hsql://localhost/
username SA
password
    "urlid"の行が接続情報のIDで、名前を適当につけることができ、その後ろに続く内容がその接続情報です。
    上の例の上半分はIn-Processモードでデータベースに接続する方法で、 下半分がServerモードで動いているデータベースに接続する方法です。
  2. 次のようにして、SqlToolを起動します。 
    % java -jar ./sqltool.jar --rcfile ./sqltool.rc nkdb
    sqltool.rcを自分のホームディレクトリ以外に置いた場合、--rcfileオプションでその位置を指定します。
    その次のパラメータがsqltool.rcの中に書いたurlidです。


SqlToolでスクリプトを実行する

スクリプトファイルを用意して、複数のコマンドやSQLを一括実行させることもできます。 

% java -jar ./sqltool.jar --rcfile ./sqltool.rc nkdb creatab.sql
このように先ほどのコマンドラインの末尾にファイル名を指定すると、そのファイルをSQLスクリプトとして実行してくれます。 上記のcreatab.sqlはこんな感じです。 (hsqldbのsampleディレクトリにも似たようなサンプルが入っていますね) 
\c true
DROP TABLE AREA IF EXISTS;
DROP TABLE SHITEN IF EXISTS;
\c false

\p Creating table AREA and SHITEN
CREATE TABLE AREA (
  AREA_CODE     INT NOT NULL,
  AREA_NAME     VARCHAR(30),
  CONSTRAINT AREA_PK PRIMARY KEY(AREA_CODE)
);

CREATE TABLE SHITEN (
  SHITEN_CODE  VARCHAR(5) NOT NULL,
  SHITEN_NAME  VARCHAR(20),
  AREA_CODE    INT,
  ADDRESS      VARCHAR(200),
  EMPLOYEE_NUM INT,
  CONSTRAINT SHITEN_PK PRIMARY KEY(SHITEN_CODE)
);

\p Inserting test records
INSERT INTO AREA (AREA_CODE, AREA_NAME)
 VALUES ('0', 'テスト');

COMMIT;
SHUTDOWN;
\cや\pというのはSqlToolの命令です。
\cはSQLがエラーになった場合、後続を実行するかやめるかを指定するオプションで、 trueが実行、falseがやめるになり、デフォルトはfalseです。
\pは単にメッセージを表示する命令です。
先述の通り、処理が終わったら必ずCOMMITを発行しないとデータが保存されません。 またこの例ではURLの末尾に「;shutdown=true」を含めているので不要ですが、 含めていない場合はSHUTDOWNコマンドも発行が必要です。
なお、実行するSQLスクリプトに日本語を含む場合には、javaのコマンドラインで "-Dsqlfile.charset=Windows-31J" のように文字コードを指定すればOKです。


GUIツールの使用

コマンドラインのSqlToolに対して、 GUIでデータベースを操作するツールとして、Database ManagerというJavaアプリケーションが付属しています。

  1. このツールは以下のようにコマンドラインで起動できます。 
    % java -cp ./hsqldb.jar org.hsqldb.util.DatabaseManagerSwing
  2. "Connect"ダイアログが出るので、次のように打ちます。
    TypeHSQL Database Engine Standalone
    Driverorg.hsqldb.jdbc.JDBCDriver初期表示のまま
    URLjdbc:hsqldb:file:./database/nkdb
    Usersa初期表示のまま
    Password(空欄)初期表示のまま
  3. DatabaseManagerツールは簡単なインターフェースで、SQLを打ち込むとそれを実行してくれます。 表を作ると、左のツリーに現在存在する表と列が表示されます。 (メニューのREFRESH TREE(CTRL+R)を実行すると最新に更新されます)


SqlToolによるデータのインポート

SqlToolの\mコマンドで、データファイルからテーブルへデータをインポートできます。
インポート処理のデフォルトでは、列区切りは|、インポート先のテーブル名はファイル名から拡張子以降を除いた物、 NULLを表現する文字列は"[null]"になっています。これらを変更するには、「* コマンド」で「*変数」を変更します。 

sql>* *DSV_COL_SPLITTER = \t
sql>* *DSV_TARGET_TABLE = table1
sql>* *NULL_REP_TOKEN =
ここで、行頭は「* *」（アスタリスク・スペース・アスタリスク）です。 つまり、最初の*は*というコマンドで、次の*DSV_COL_SPLITTERは、頭に*もついて*DSV_COL_SPLITTERという変数名です。 間違って*が足りないと「SqlSyntaxErrorException」など意味不明なエラーが出て延々悩むことになるので、注意が必要です。

タブ文字は\tと表現できます。またNULL_REP_TOKENの上の設定は空文字列を表します。
設定した「*変数」の値を確認するには、「* listvalues」と打てばokです。
そしてインポートは「\m データファイル名」で行えます。 

sql>\m /the/path/of/shiten.dat
Import summary ('#'-skips / rejects / inserts):  0 / 0 / 18.
Insertions will be lost of you don't commit.
sql>commit;
インポート時のデータファイルについていくつか注意があります。
HSQLDBのマニュアルでは、データファイルのことをDSV(Delimiter Separated Value)ファイルと呼んでいますが、 そのファイルの拡張子は何でも構いません。上の例のように.datもokです。
つぎに、ファイルの1行目には必ず列名を書く必要があります。
以下がshiten.datの例です。 
SHITEN_CODE	SHITEN_NAME	ADDRESS	AREA_CODE	EMPLOYEE_NUM
00100	東京	東京都港区北青山9-99-998	3	40
00120	さいたま	さいたま市桜田99-99	3	200
00200	横浜	横浜市中区根岸町999	3	222
またデータファイルの日本語のエンコーディングですが、 WindowsでHSQLDBを使っている際には、データファイルはシフトJIS(MS932、Windows-31Jとも言う)で普通に書けばOKです。 こちらのマニュアルを見ると、***.rcファイルの設定で変更もできるようです。

最後に改行文字ですが、デフォルト設定では「*DSV_ROW_SPLITTER」の値は、\r\n|\r|\nとなっています。 つまり今日一般的なLF(UNIX)、CR+LF(Windows)のどちらでも、改行文字は正しく認識されます。

\mコマンドでデータをロードする命令を、スクリプトに書いて流すこともできます。以下はその例です。 

* *DSV_COL_SPLITTER = \t
* *DSV_TARGET_TABLE = CARD_PRICES
* *NULL_REP_TOKEN =
* *DSV_REJECT_REPORT = import_err.html

DELETE FROM CARD_PRICES;

\m input_card_prices.txt
COMMIT;
SHUTDOWN;
\p end.
というスクリプトファイル "load.sql" を作って 
% java -jar ./sqltool.jar --rcfile ./sqltool.rc sadb load.sql
と実行するか、 
% java -jar ./sqltool.jar --rcfile ./sqltool.rc sadb
で対話型UIを起動して「\i load.sql」を実行します。

インポートが長くなったので、エクスポートは別の機会にしましょう…


表データのファイルへのエクスポート

はい！ではエクスポートです(すぐさま)
1行ずつコマンドを打っても良いのですが、インポートとよく似ているので最初からファイルを作って流す方法にします。 

* *DSV_COL_DELIM = \t
* *DSV_TARGET_FILE = ./outfile.txt
* *NULL_REP_TOKEN =
\x SELECT * FROM ITEMS
\p end.
このようなファイルを適当な名前(ここではexport.sqlとします)で作り、 
% java -jar ./sqltool.jar --rcfile ./sqltool.rc sadb export.sql
と実行するか、 
% java -jar ./sqltool.jar --rcfile ./sqltool.rc sadb
で対話型UIを起動して「\i export.sql」を実行します。


Serverモードの使用

  1. 今度は、hsqldbをサーバープロセスとして起動します。 
    % java -classpath /opt/tools/hsqldb.jar org.hsqldb.Server -database.0 file:/usr/dbms/hsqldb-2.7/database/nkdb;ifexists=true -dbname.0 nkx
    対象とするデータベース・ファイルのパスは-database.{N}オプションで指定します。 正式にはfile:を頭につけるのだと思いますが、上のように省略もできるようです。
    バージョン1.7.2から、hsqldbのサーバーは複数のデータベースを同時に開いて待つことができます。 その場合は、個々のデータベースに別名(alias)をつけます。それは、-dbname.{N}オプションで行います。 
    % java -classpath ./hsqldb.jar org.hsqldb.Server -database.0 testdb -dbname.0 testdb \
 -database.1 mydb -dbname.1 mydb
    あんまり長すぎる場合、コマンドラインに書くのではなく、 server.propertiesファイルを起動するディレクトリに書いておく方がよいでしょう。 
    database.0=file:/opt/db/accounts
dbname.0=an_alias

database.1=file:/opt/db/mydb
dbname.1=enrollments

database.2=mem:adatabase
dbname.2=quickdb
    それで、In-Processモードのときと同様、このパスのデータベースファイルがまだ存在しなければ、 (URLに;ifexists=trueを付けていなければ)サーバープロセスの起動時に作られます。
    このサーバープロセスは、Ctrl+Cを押すことで終了できますが、 それはAbortという位置づけで、データベース操作の変更は保存されません。 変更を保存して終了するには、自作なり、SqlToolなり何らかのクライアントで接続して、 SHUTDOWN;コマンドを発行する必要があります。 例えば、以下のようなSQLスクリプトをSqlToolで使うという方法があります。(そのままやんけ) 
    SHUTDOWN;
  2. クライアントから接続して試してみます。先にも使ったDatabase Managerを使う場合 
    % java -cp hsqldb.jar org.hsqldb.util.DatabaseManagerSwing
    SqlToolを使う場合、 
    % java -jar ./sqltool.jar --inlineRc=url=jdbc:hsqldb:hsql://localhost/nkx,user=sa
    なお「nkx」の部分は、サーバーを起動したときのdbname.{N}のいずれかの値を指定します。 全く省略した場合、つまり
    jdbc:hsqldb:hsql://localhost
    jdbc:hsqldb:hsql://localhost/
    のように指定すると、-dbname.{N}が空文字列、 またはそのオプションを指定していないデータベースに接続しにいくことになります。


パスワードを設定する

ユーザーSAのデフォルトのパスワードは""（空文字列）です。 パスワードを設定するには、次のようにSQLToolを起動して、 SET PASSWORDコマンドを使います。 

java -jar ./sqltool.jar --rcfile ./sqltool.rc sadb
sql> set password "hello01"
sql> shutdown;
sql> \q
ここで、パスワードは必ず二重引用符""で囲む必要があります。
また一度パスワードを設定してしまうと、 同じsqltool.rcでは接続できなくなります。 編集して、passwordの値を合わせる必要があります。 
urlid sadb
url jdbc:hsqldb:file:./sadb
username SA
password hello01


データ型

hsqldbの表(テーブル)の各列に指定できるデータ型には以下の種類があります。
(バージョン2.6で他のデータ型も追加されましたが、とりあえず基本のデータ型をご紹介します)

整数型にはTINYINT、SMALLINT、INTEGER、BIGINTがあります。 これらはJava世界のそれぞれbyte、short、int、longの精度に対応します。 これらのうちbyteはHSQLDB独自の精度ですが、 それ以外はSQL標準に則ったデータ型名と範囲になっています。

小数部を持つことも持たないこともできる数値型としては、NUMERICとDECIMALがあります。 これらは全く同じもので、java.math.BigDecimalの精度に対応します。 これらは DECIMAL とだけ指定できる他に、 DECIMAL(10)やDECIMAIL(12,3)のように精度を指定できます。

小数型にはREAL、FLOAT、DOUBLEがあります。 これらは全てJava世界のdoubleに相当し、全く同じ物です。 これらには精度は指定できません。またSqlToolなどで値を表示すると、 「12.0000000…」と延々と0が並ぶ表記になります。 したがって、アプリケーション側で表示を工夫する必要が多くの場合あります。

真偽値を保持するBOOLEANという型は、SQL標準にならい、TRUE、FALSE、 そしてUNKNOWNという値をとりえます。 これに対してBITは、バージョン1台ではBOOLEANと全く同じ物でしたが、 バージョン2では単に1ビットの値(つまり0か1)を持つ型として、BOOLEANと分離しました。

テキスト文字列型には、SQL標準と同じ名前のデータ型としては、 固定長のCHARACTER、可変長のCHARACTER VARYING、 大量データを保持できるCLOB(Character Large OBject)があります。 先頭から2つのよく知られた商用RDBMSでの別名、CHARとVARCHARも使えます。 またHSQLDBでは、LONGVARCHARは長くないVARCHARと全く同じ物です。

バイナリ文字列型には、 固定長のBINARY、可変長のBINARY VARING、そしてBLOB(Binary Large OBject)があります。

日付/時刻型にはDATE、TIME、TIMESTAMPがあります。


DEFAULTと現在時刻の設定

多くのRDBMSと同様、hsqldbにも組み込み関数が用意されていて、 その中にはこれも定番の、現在時刻を返すものも用意されています。 組み込み関数の一覧はこちらに載っています。 現在時刻を返す関数は NOW()で、これはLOCALTIMESTAMPも同じ意味です。 これを使って、表定義のDEFAULT句に現在時刻を設定できます。 

CREATE TABLE ITEMS (
  ITEM_CODE VARCHAR(8) NOT NULL,
/* 中略 */
  CDATE     DATE DEFAULT NOW(),
  UDATE     DATE DEFAULT NOW(),
  CONSTRAINT ITEMS_PK PRIMARY KEY(ITEM_CODE)
);
そういえば、DEFAULTといえば一つ注意があります。 DEFAULTとNOT NULLを両方使うとき、HSQLDBの文法では順番に制約があります。 Oracleだと 
COL1 VARCHAR(3) NOT NULL DEFAULT 'ZZZ'
と書けたのが、hsqldbでは「unexpected token: DEFAULT」というエラーになります。 正しくは次の順序です。 
COL1 VARCHAR(3) DEFAULT 'ZZZ' NOT NULL


列定義の変更

Oracleと違うといえば、hsqldbのALTER TABLE文もOracleとかなり違います。 例えば列のデータ型を変更する際、Oracleでは 

ALTER TABLE TAB1 MODIFY COL1 VARCHAR(12);
と書きますが、hsqldbではこう書きます。 
ALTER TABLE TAB1 ALTER COLUMN COL1 SET VARCHAR(12);


参照ビューがあると表を削除できない

もう一つ。表Aを参照するビューBがあるとき、AをDROPできるでしょうか？
Oracleではできて、Bは「INVALID」になります。
hsqldbではできません。「dependent objects exist」というエラーになります。 また参照するビューがあると表をDROPできないだけでなく、上のALTER TABLEもできません。


自動発番(オートインクリメント)列の作成

主キー列を意味なし連番にしたい時などは、GENERATEDが使えます。 公式マニュアルはこちら 

CREATE TABLE ITEM_CATEGORIES(
  CATEGORY_ID INTEGER GENERATED BY DEFAULT AS IDENTITY(START WITH 1) PRIMARY KEY,
  CATEGORY_NAME VARCHAR(50) NOT NULL
);
\mコマンドでデータをロードする時も、この列をデータに入れなければ自動発番されます。 つまり上の例だとCATEGORY_ID列は不要で、CATEGORY_NAME列だけからなる 
電気部品
機械部品
その他
こういうデータファイルを読ませれば、1が電気部品、2が機械部品、3がその他になります。

なお、自動発番の行をINSERTした後にロールバックしたり、コミットせず終了したりした場合、 それらの番号は再利用されず、欠番になります。 連番をリセットしたい場合は、次のようなSQLを発行します。 
ALTER TABLE ITEM_CATEGORIES ALTER COLUMN CATEGORY_ID RESTART WITH 1;
これはITEM_CATEGORIESテーブルのCATEGORY_ID列を1から始まるようにリセットしています。


JDBCクライアントの開発

hsqldb.jarにはJDBCドライバも入っているので、JDBCクライアントを開発できます。 ドライバのクラス名はorg.hsqldb.jdbcDriverです。
JDBCクライアントの作り方は、ほとんどごく普通の書き方でいいのですが、上と同じ注意点が1点。 In-Processモードでデータベースを開いた場合、 アプリケーションの終了時に "SHUTDOWN" というSQLステートメントを実行してから終了する必要があります。 これはコミットされるかという話以前のことで、 "SHUTDOWN" を実行しないとDML文だけでなくDDL文さえ実行が保存されません。 なおそれは、個々の接続(Connection)を切る際に実行する必要があるのではなく、 1回のJava VMで同じデータベースに複数回接続をするのであれば、最後の1回だけでよいということです。 毎回接続の度にSHUTDOWNが必要だというのなら世にも恐ろしいことですが、 そうでないのは若干救いといえます。 また、先述の通り、JDBC接続のURLに";shutdown=true"を追加でつけておくと、 そのJava VMで最後の接続が閉じられたときにSHUTDOWN処理も行ってくれます。

検索処理のサンプルです。「SHITEN」テーブルから「AREA_CODE」が「3」の行を検索するという想定です。 

public class HsqldbTester {
    public static void main(String[] args) throws SQLException {
        String user = "sa";
        String password = "";
        String dburl = "jdbc:hsqldb:file:/D:/usr/dbms/hsqldb/database/sadb;shutdown=true";
        String sql =
                "SELECT SHITEN_CODE, SHITEN_NAME, ADDRESS, EMPLOYEE_NUM FROM SHITEN " +
                "WHERE AREA_CODE = ? ORDER BY SHITEN_CODE";

        Connection conn = DriverManager.getConnection(dburl, user, password);
        PreparedStatement st = conn.prepareStatement(sql);
        st.setString(1, "3");
        ResultSet rset = st.executeQuery();

        while (rset.next()){
            System.out.println(rset.getString(1) + "\t" +
              rset.getString(2) + "\t" + rset.getString(3) + "\t" + rset.getString(4));
        }
        rset.close();
        st.close();
        conn.close();
    }
}


Webアプリケーションの起動・停止とhsqldbサーバの起動・停止を連動する

これは、ServletのListenerの仕組を使って可能です。 Project Amaterasのこのページ にそのようなServletContextListenerの実装例が載っています。 私もほぼそのまま参考にして期待通りの動作を確認しました。 

<Resource name="jdbc/sadbREMOTE" auth="Container" type="javax.sql.DataSource"
    driverClassName="org.hsqldb.jdbcDriver"
    url="jdbc:hsqldb:hsql://localhost/"
    factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
    username="sa" password=""
    maxWait="1000" maxActive="30" maxIdle="10"
    removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true" />


standaloneモードでWebアプリケーションに内蔵する

上記の例は、Webアプリケーションサーバの起動・停止に連動してhsqldb「サーバ」を起動・停止するものでしたが、 それとは別に、以下のようなJNDIリソースを定義すれば、 WebアプリケーションのJava VMの中からstandaloneモードのhsqldbと接続を開いて、操作を行うことができます。 (この例では、DataSource FactoryとしてJakarta Commons DBCPを使っています) 

<Resource name="jdbc/sadb" auth="Container" type="javax.sql.DataSource"
    driverClassName="org.hsqldb.jdbcDriver"
    url="jdbc:hsqldb:file:C:/the/path/of/database/sadb"
    factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"
    username="sa" password=""
    maxWait="1000" maxActive="30" maxIdle="10"
    removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true" />


standaloneモードのJDBCクライアント開発時のエラーについて

standaloneモード、つまりURLが「jdbc:hsqldb:file〜」でHSQLDBに接続に行く JDBCアプリケーションを実行すると、 「〜unexpected token: CONFLICT required: DEADLOCK」 とか「unexpected token: AVG」というエラーが出ることがあります。 意味はよく分かりませんが、データベースの「**db.script」 をテキストエディタで次のように変更するとエラーが出なくなりました。
まず、「〜unexpected token: CONFLICT required: DEADLOCK」 というエラーが出たら、**db.scriptの 

SET DATABASE TRANSACTION ROLLBACK ON CONFLICT TRUE
という行を 
SET DATABASE TRANSACTION ROLLBACK ON DEADLOCK TRUE
に変更して保存し、再度Javaプログラムを実行します。すると今度は 「unexpected token: AVG」というエラーになると思うので、 
SET DATABASE SQL AVG SCALE 0
という行を削除します。
(後日注：両方同時にやってもOKのようです)

　 もくじ
HSQLDB 　 (C) 2002-2025 MISUMI URANO (2003/12/05 - 2025/03/23)