@advanced_1000_h1 進歩したトピックス @advanced_1001_a Result Sets @advanced_1002_a 大きなオブジェクト @advanced_1003_a リンクテーブル @advanced_1004_a トランザクション分離 @advanced_1005_a #Multi-Version Concurrency Control (MVCC) @advanced_1006_a クラスタリング / 高可用性 @advanced_1007_a 2フェーズコミット @advanced_1008_a 互換性 @advanced_1009_a #Standards Compliance @advanced_1010_a Windowsサービスとして実行する @advanced_1011_a ODBCドライバ @advanced_1012_a #Using H2 in Microsoft .NET @advanced_1013_a ACID @advanced_1014_a 永続性問題 @advanced_1015_a リカバーツールを使用する @advanced_1016_a ファイルロックプロトコル @advanced_1017_a SQLインジェクションに対する防御 @advanced_1018_a #Restricting Class Loading and Usage @advanced_1019_a セキュリティプロトコル @advanced_1020_a 汎用一意識別子 (UUID) @advanced_1021_a システムプロパティから読み込まれた設定 @advanced_1022_a #Setting the Server Bind Address @advanced_1023_a 用語集とリンク @advanced_1024_h2 Result Sets @advanced_1025_h3 行数の制限 @advanced_1026_p アプリケーションから結果が返される前に、全ての行はデータベースによって読み取られます。 サーバー側のカーソルは現在サポートされていません。もし最初の数行がアプリケーションに読み取られたら、 result setサイズはパフォーマンスを改善するために制限されます。これは、クエリーの LIMIT を使用することで 実現できます (例: SELECT * FROM TEST LIMIT 100)、または Statement.setMaxRows(max) を使用します。 @advanced_1027_h3 大きなResult Set と外部ソート @advanced_1028_p 1000行以上のresult setのために、結果はディスクにバッファーされます。 もし ORDER BY が使用されていたら、ソートは、外部ソートアルゴリズムを使用して 完了しています。このケースでは、それぞれの行のブロックはクイックソートを使用してソートされ、 ディスクに書き込まれています; データを読み込んでいる時、ブロックは一緒にマージされます。 @advanced_1029_h2 大きなオブジェクト @advanced_1030_h3 大きなオブジェクトのソートと読み込み @advanced_1031_p メモリに収まらないオブジェクトは可能であるなら、 データ型は CLOB (テキストデータ) または BLOB (バイナリーデータ) が使用されるべきです。 これらのデータ型に関して、オブジェクトはストリームを使用して、完全にメモリから読み込まれるというわけではありません。 BLOB を保存するためには、PreparedStatement.setBinaryStream を使用します。 CLOB を使用するためには、PreparedStatement.setCharacterStream を使用します。 BLOB を読み込みためには、ResultSet.getBinaryStream を使用し、CLOB を読み込むために ResultSet.getCharacterStream を使用します。もし クライアント / サーバーモードが使用されていたら、 BLOB と CLOB データはアクセス時に完全にメモリから読み込まれます。このケースでは、メモリによって BLOB と CLOB のサイズは制限されています。 @advanced_1032_h2 リンクテーブル @advanced_1033_p このデータベースはリンクテーブルをサポートしています。これは、 現在存在しないテーブルは、ただ他のデータベースへリンクするという意味です。 このようなリンクを作るには、CREATE LINKED TABLE ステートメントを使用します: @advanced_1034_p この時、通常の方法でテーブルにアクセスすることが可能です。このテーブルにデータを挿入する時、 制限があります: テーブルに行を挿入、または更新する時、insertステートメントで設定されていないNULLと値は、 両方ともNULLとして挿入されます。目的のテーブルのデフォルト値がNULL以外なら、 望みどおりの効果は得られません。 @advanced_1035_p 各リンクテーブルの新しい接続は開かれます。多くのリンクテーブルが使用されている時、一部データベースにとってこれは問題となり得ます。Oracle XEでは、接続の最大数を増加することができます。Oracle XEは次の値の変更後、再起動する必要があります: @advanced_1036_h2 トランザクション分離 @advanced_1037_p このデータベースは次のトランザクション分離レベルをサポートしています: @advanced_1038_b Read Committed (コミット済み読み取り) @advanced_1039_li これはデフォルトレベルです。 read lockは早急に解除されます。 このレベルを使用する時、高い同時並行性が可能です。 これは多数のデータベースシステムで使用される分離レベルです。 @advanced_1040_li これを有効にするには、 SQLステートメント 'SET LOCK_MODE 3' を実行します。 @advanced_1041_li または、;LOCK_MODE=3 をデータベースURLに付け加えます: jdbc:h2:~/test;LOCK_MODE=3 @advanced_1042_b Serializable (直列化) @advanced_1043_li これを有効にするには、 SQLステートメント 'SET LOCK_MODE 1' を実行します。 @advanced_1044_li または、;LOCK_MODE=1 をデータベースURLに付け加えます: jdbc:h2:~/test;LOCK_MODE=1 @advanced_1045_b Read Uncommitted (非コミット読み取り) @advanced_1046_li このレベルの意味は、トランザクション分離は無効だということです。 @advanced_1047_li これを有効にするには、SQLステートメント 'SET LOCK_MODE 0' を実行します @advanced_1048_li または、;LOCK_MODE=0 をデータベースURLに付け加えます: jdbc:h2:~/test;LOCK_MODE=0 @advanced_1049_p 分離レベル "serializable" を使用している時、ダーティリード、反復不可能読み取り、 ファントムリードを防ぐことができます。 @advanced_1050_b Dirty Reads (ダーティリード) @advanced_1051_li 他の接続によるコミットされていない変更を読み取ることができる、という意味です。 @advanced_1052_li 実行可能: read uncommitted (非コミット読み取り) @advanced_1053_b Non-Repeatable Reads (反復不可能読み取り) @advanced_1054_li ひとつの接続が行を読み取り、 他の接続が行を変更し、コミットすると、最初の接続は同じ行を再読し、新しい結果を取得します。 @advanced_1055_li 実行可能: read uncommitted (非コミット読み取り)、read committed (コミット済み読み取り) @advanced_1056_b Phantom Reads (ファントムリード) @advanced_1057_li ひとつの接続が条件を使って行の集まりを読み取り、 他の接続がこの条件を壊して行を挿入し、コミットした時、最初の接続は同じ条件を使って再読し、 新しい行を取得します。 @advanced_1058_li 実行可能: read uncommitted (非コミット読み取り)、read committed (コミット済み読み取り) @advanced_1059_h3 テーブルレベルロック @advanced_1060_p #The database allows multiple concurrent connections to the same database. To make sure all connections only see consistent data, table level locking is used by default. This mechanism does not allow high concurrency, but is very fast. Shared locks and exclusive locks are supported. Before reading from a table, the database tries to add a shared lock to the table (this is only possible if there is no exclusive lock on the object by another connection). If the shared lock is added successfully, the table can be read. It is allowed that other connections also have a shared lock on the same object. If a connection wants to write to a table (update or delete a row), an exclusive lock is required. To get the exclusive lock, other connection must not have any locks on the object. After the connection commits, all locks are released. This database keeps all locks in memory. @advanced_1061_h3 ロックタイムアウト @advanced_1062_p もし接続がオブジェクト上でロックを取得できないのであれば、一定時間待機します (ロックタイムアウト)。この時間の間、うまくいけば接続はロックコミットを保有し、 この時、ロックを取得することが可能です。他の接続がロックを解除しないため、 これが不可能であれば、失敗した接続がロックタイムアウト例外を取得します。 それぞれの接続に個別にロックタイムアウトを設定することができます。 @advanced_1063_h2 #Multi-Version Concurrency Control (MVCC) @advanced_1064_p #The MVCC feature allows higher concurrency than using (table level or row level) locks. When using MVCC in this database, delete, insert and update operations will only issue a shared lock on the table. An exclusive lock is still used when adding or removing columns, when dropping the table, and when using SELECT ... FOR UPDATE. Connections only 'see' committed data, and own changes. That means, if connection A updates a row but doesn't commit this change yet, connection B will see the old value. Only when the change is committed, the new value is visible by other connections (read committed). If multiple connections concurrently try to update the same row, this database fails fast: a concurrent update exception is thrown. @advanced_1065_p #To use the MVCC feature, append MVCC=TRUE to the database URL: @advanced_1066_p #The MVCC feature is not fully tested yet. @advanced_1067_h2 クラスタリング / 高可用性 @advanced_1068_p このデータベースは簡単なクラスタリング / 高可用性メカニズムをサポートしています。 アーキテクチャ: 二つのデータベースサーバーは二つの異なったコンピューター上で動作し、 両方のコンピューターは同じデータベースのコピーです。もし両方のサーバーが動いたら、 それぞれのデータベース操作は両方のコンピューター上で実行されます。ひとつのサーバーがおちたら (電源、ハードウェア、またはネットワーク障害)、他のサーバーはまだ動作を続行します。 このポイントから、操作は他のサーバーがバックアップされるまで、ひとつのサーバー上で実行されます。 @advanced_1069_p クラスタリングはサーバーモードでのみ使用できます (エンベッドモードはクラスタリングをサポートしていません)。 サーバーを停止しないでクラスタを回復することは可能ですが、二番目のデータベースが回復している間に、 他のどんなアプリケーションでも最初のデータベースのデータを変更しないことは重要なため、 クラスタを回復するのは現在手動プロセスです。 @advanced_1070_p クラスタを初期化するには、次の手順に従います: @advanced_1071_li データベースを作成する @advanced_1072_li 他の位置にデータベースをコピーし、クラスタリングを初期化するために、 CreateClusterツールを使用します。その後、同じデータが含まれる二つのデータベースを所有します。 @advanced_1073_li 二つのサーバーを起動します (ひとつはそれぞれのデータベースのコピー) @advanced_1074_li これでクライアントアプリケーションのデータベースに接続する準備ができました @advanced_1075_h3 CreateClusterツールを使用する @advanced_1076_p クラスタリングがどのように機能するか理解するために、 次の例を試してみて下さい。この例では、二つのデータベースは同じコンピューター内に属していますが、 通常は、データベースは異なるサーバー内にあります。 @advanced_1077_li 二つのディレクトリを作成します: server1 と server2 です。それぞれのディレクトリは コンピューター上のディレクトリをシミュレートします。 @advanced_1078_li 最初のディレクトリを示してTCPサーバーを起動します。 次のコマンドラインを使用して実行できます: @advanced_1079_li 二番目のディレクトリを示して二番目のTCPサーバーを起動します。 これは二番目の (重複の) コンピューターで動いているサーバーをシミュレートします。 次のコマンドラインを使用して実行できます: @advanced_1080_li クラスタリングを初期化するためにCreateClusterツールを使用します。 データベースが存在しなければ、自動的に新しい、空のデータベースを作成します。 次のコマンドラインでツールを実行します: @advanced_1081_li #You can now connect to the databases using an application or the H2 Console using the JDBC URL jdbc:h2:tcp://localhost:9101,localhost:9102/~/test @advanced_1082_li サーバーを止めたら (プロセスを無視して)、他のマシンは動作を続行し、 従ってデータベースもまだアクセス可能だということがわかります。 @advanced_1083_li クラスタを回復するために、まず最初に失敗したデータベースを削除し、止められていたサーバーを 再起動します。そして、CreateClusterツールを再実行します。 @advanced_1084_h3 クラスタリングアルゴリズムと制限 @advanced_1085_p 読み取り専用クエリーは、最初のクラスタノードに対してのみ 実行されますが、他の全てのステートメントは全てのノードに対して実行されます。 現在、トランザクションの問題を回避するように作られたロードバランシングは存在しません。 次の関数は、異なったクラスタノード上で異なった結果をもたらすので、実行には注意して下さい: RANDOM_UUID()、SECURE_RAND()、SESSION_ID()、MEMORY_FREE()、 MEMORY_USED()、CSVREAD()、CSVWRITE()、RAND() [seed を使用していない時] 直接ステートメントを変更する際に、これらの関数を使用してはなりません (例: INSERT、 UPDATE、または MERGE)。しかし、読み取り専用ステートメントでは使用でき、 結果はステートメントを変更するために使用することができます。 @advanced_1086_h2 2フェーズコミット @advanced_1087_p 2フェーズコミットプロトコルがサポートされています。 2フェーズコミットは次のように機能します: @advanced_1088_li オートコミットはOFFの状態であることが必要です @advanced_1089_li トランザクションは、例えば行を挿入することによって、起動されます @advanced_1090_li トランザクションは、SQLステートメント PREPARE COMMIT transactionName を実行することによって "prepared" とマークされます @advanced_1091_li 現在トランザクションはコミット、またはロールバックすることができます @advanced_1092_li トランザクションがコミット、またはロールバックに成功する前に問題が起きたら (例えば、ネットワークの問題が起きたことによって)、トランザクションは "in-doubt" の状態になります @advanced_1093_li データベースへの再接続時、in-doubtトランザクションは SELECT * FROM INFORMATION_SCHEMA.IN_DOUBT でリストアップされます @advanced_1094_li リスト上のそれぞれのトランザクションは、COMMIT TRANSACTION transactionName または、 ROLLBACK TRANSACTION transactionName を実行してコミット、またはロールバックされなければなりません @advanced_1095_li 変更を適用するために、データベースを終了し、再び開く必要があります @advanced_1096_h2 互換性 @advanced_1097_p このデータベースは (ある程度までは)、HSQLDB、MySQL や PostgreSQLのような 他のデータベースと互換性があります。H2が互換性のないある一定の領域があります。 @advanced_1098_h3 オートコミットがONの時のトランザクションコミット @advanced_1099_p この時、このデータベースエンジンは 結果が返ってくる直前にトランザクションをコミットします (オートコミットがONの場合)。 クエリーにとって、アプリケーションがresult setを通してスキャンする前や、result setが閉じられる前でさえも、 トランザクションはコミットされるということを意味しています。このケースでは、他のデータベースエンジンは result setが閉じられる時、トランザクションをコミットします。 @advanced_1100_h3 キーワード / 予約語 @advanced_1101_p 引用 (二重引用符で囲まれる) されない限り、識別子 (テーブル名、カラム名など) として使用できないキーワードのリストがあります。 現在のリスト: @advanced_1102_p CURRENT_TIMESTAMP, CURRENT_TIME, CURRENT_DATE, CROSS, DISTINCT, EXCEPT, EXISTS, FROM, FOR, FALSE, FULL, GROUP, HAVING, INNER, INTERSECT, IS, JOIN, LIKE, MINUS, NATURAL, NOT, NULL, ON, ORDER, PRIMARY, ROWNUM, SELECT, SYSDATE, SYSTIME, SYSTIMESTAMP, TODAY, TRUE, UNION, WHERE @advanced_1103_p このリストのある特定のワードはキーワードです。なぜなら、例えば CURRENT_TIMESTAMP のような 互換性のため "()" なしで使用できる関数だからです。 @advanced_1104_h2 #Standards Compliance @advanced_1105_p #This database tries to be as much standard compliant as possible. For the SQL language, ANSI/ISO is the main standard. There are several versions that refer to the release date: SQL-92, SQL:1999, and SQL:2003. Unfortunately, the standard documentation is not freely available. Another problem is that important features are not standardized. Whenever this is the case, this database tries to be compatible to other databases. @advanced_1106_h2 Windowsサービスとして実行する @advanced_1107_p ネイティブラッパー / アダプタを使用して、JavaアプリケーションはWindowsサービスとして実行できます。これを実行するために、様々なツールが有効です。Tanuki Software, Inc. (<a href="http://wrapper.tanukisoftware.org/">http://wrapper.tanukisoftware.org/</a>) のJavaサービスラッパーはインストールが含まれています。H2データベースエンジンサービスのインストール、起動、終了とアンインストールのためのバッチファイルが添付されます。このサービスは、TCPサーバーとH2コンソールWebアプリケーションが含まれます。バッチファイルは、H2/service ディレクトリに配置されています。 @advanced_1108_h3 サービスをインストールする @advanced_1109_p サービスは、最初にWindowsサービスとして登録することが必要です。 これを行うために、1_install_service.bat をダブルクリックします。 成功すれば、コマンドプロンプトウィンドウが開き、すぐに消えます。失敗したらメッセージが現れます。 @advanced_1110_h3 サービスを起動する @advanced_1111_p Windowsのサービスマネージャを使用するか、2_start_service.bat をダブルクリックして H2データベースエンジンサービスを起動することができます。サービスがインストールされていなければ、 バッチファイルはエラーメッセージを表示しないということに注意して下さい。 @advanced_1112_h3 H2コンソールに接続する @advanced_1113_p サービスのインストールと起動後、ブラウザを使用してH2コンソールアプリケーションに 接続することができます。3_start_browser.bat をダブルクリックして実行します。 デフォルトのポート (8082) はバッチファイルでハードコード化されているものです。 @advanced_1114_h3 サービスを終了する @advanced_1115_p サービスを終了するには、4_stop_service.bat をダブルクリックします。 サービスがインストール、または開始されていなければ、 バッチファイルはエラーメッセージを表示しないということに注意して下さい。 @advanced_1116_h3 サービスのアンインストール @advanced_1117_p サービスをアンインストールするには、5_uninstall_service.bat をダブルクリックします。成功すれば、コマンドプロンプトウィンドウが開き、すぐに消えます。 失敗したらメッセージが現れます。 @advanced_1118_h2 ODBCドライバ @advanced_1119_p このデータベースは現時点で、自身のODBCドライバと共に動作しませんが、PostgreSQLネットワークプロトコルをサポートしています。そのため、PostgreSQL ODBCドライバが使用可能です。PostgreSQLネットワークプロトコルのサポートは非常に新しく、試験的なものとして見なされます。製品アプリケーションで使用されるべきではありません。 @advanced_1120_p 現時点で、PostgreSQL ODBCドライバはWindowsの64 bitバージョンでは動作しません。詳細は <a href="http://svr5.postgresql.org/pgsql-odbc/2005-09/msg00127.php">ODBC Driver on Windows 64 bit</a> をご覧下さい。 @advanced_1121_h3 ODBCインストール @advanced_1122_p まず、ODBCドライバがインストールされていなければなりません。最近のいずれのPostgreSQL ODBCドライバでも動作しますが、バージョン 8.2.4 以降のものを推奨します。PostgreSQL ODBCドライバのWindowsバージョンは <a href="http://www.postgresql.org/ftp/odbc/versions/msi">http://www.postgresql.org/ftp/odbc/versions/msi</a> から利用可能です。 @advanced_1123_h3 サーバーの起動 @advanced_1124_p ODBCドライバのインストール後、コマンドラインを使用してH2サーバーを起動します: @advanced_1125_p PGサーバー (PostgreSQLプロトコルのためのPG) が同様に起動します。デフォルトでは、データベースはサーバーが起動した現在作業中のディレクトリに保存されます。ユーザーホームディレクトリなど、別のディレクトリにデータベースを保存するには、-baseDir を使用します: @advanced_1126_p PGサーバーは次のJavaアプリケーション内から起動、終了することが可能です: @advanced_1127_p デフォルトでは、ローカルホストからの接続のみ許可されます。リモート接続を許可するには、サーバーの起動時に<code>-pgAllowOthers true</code> を使用します。 @advanced_1128_h3 ODBC設定 @advanced_1129_p ドライバのインストール後、新しいデータソースを追加しなければなりません。Windowsでは、データソースAdministratorを開くために、<code>odbcad32.exe</code> を実行します。"Add..." をクリックし、PostgreSQL Unicode driverを選択します。そして、"Finish" をクリックします。接続プロパティを変更することが可能です: @advanced_1130_th プロパティ @advanced_1131_th 例 @advanced_1132_th コメント @advanced_1133_td Data Source @advanced_1134_td H2 Test @advanced_1135_td ODBCデータソースの名称 @advanced_1136_td Database @advanced_1137_td test @advanced_1138_td データベース名。現時点では簡易な名前のみサポートされています; @advanced_1139_td 相対パス、または絶対パスはデータベース名にサポートされていません。 @advanced_1140_td デフォルトでは、-baseDir 設定が使用された時を除き、 @advanced_1141_td データベースはサーバーが起動された現在作業中のディレクトリに保存されます。 @advanced_1142_td 名前は少なくとも3文字でなければなりません。 @advanced_1143_td Server @advanced_1144_td localhost @advanced_1145_td サーバー名、またはIPアドレス @advanced_1146_td デフォルトでは、リモート接続のみ許可されています。 @advanced_1147_td User Name @advanced_1148_td sa @advanced_1149_td データベースのユーザー名 @advanced_1150_td SSL Mode @advanced_1151_td disabled @advanced_1152_td 現時点で、SSLはサポートされていません。 @advanced_1153_td Port @advanced_1154_td 5435 @advanced_1155_td PGサーバーが傾聴しているポート @advanced_1156_td Password @advanced_1157_td sa @advanced_1158_td データベースパスワード @advanced_1159_p この後、このデータソースを使用できます。 @advanced_1160_h3 PGプロトコルサポートの制限 @advanced_1161_p 現時点では、PostgreSQLネットワークプロトコルのサブセットのみ実装されています。また、カタログ、またはテキストエンコーディングでのSQLレベル上の互換性問題がある可能性があります。問題は発見されたら修正されます。現在、PGプロトコルが使用されている時、ステートメントはキャンセルされません。 @advanced_1162_p #PostgreSQL ODBC Driver Setup requires a database password; that means it is not possible to connect to H2 databases without password. This is a limitation of the ODBC driver. @advanced_1163_h3 セキュリティ考慮 @advanced_1164_p 現在、PGサーバーはchallenge response、またはパスワードの暗号化をサポートしていません。パスワードが読みやすいため、アタッカーがODBCドライバとサーバー間でのデータ転送を傾聴できる場合、これは問題になるでしょう。また、暗号化SSL接続も現在使用不可能です。そのため、ODBCドライバはセキュリティが重視される場面においては使用されるべきではありません。 @advanced_1165_h2 #Using H2 in Microsoft .NET @advanced_1166_p #The database can be used from Microsoft .NET even without using Java, by using IKVM.NET. You can access a H2 database on .NET using the JDBC API, or using the ADO.NET interface. @advanced_1167_h3 #Using the ADO.NET API on .NET @advanced_1168_p #An implementation of the ADO.NET interface is available in the open source project <a href="http://code.google.com/p/h2sharp">H2Sharp</a> . @advanced_1169_h3 #Using the JDBC API on .NET @advanced_1170_li #Install the .NET Framework from <a href="http://www.microsoft.com">Microsoft</a> . Mono has not yet been tested. @advanced_1171_li #Install <a href="http://www.ikvm.net">IKVM.NET</a> . @advanced_1172_li #Copy the h2.jar file to ikvm/bin @advanced_1173_li #Run the H2 Console using: <code>ikvm -jar h2.jar</code> @advanced_1174_li #Convert the H2 Console to an .exe file using: <code>ikvmc -target:winexe h2.jar</code> . You may ignore the warnings. @advanced_1175_li #Create a .dll file using (change the version accordingly): <code>ikvmc.exe -target:library -version:1.0.69.0 h2.jar</code> @advanced_1176_p #If you want your C# application use H2, you need to add the h2.dll and the IKVM.OpenJDK.ClassLibrary.dll to your C# solution. Here some sample code: @advanced_1177_h2 ACID @advanced_1178_p データベースの世界では、ACIDとは以下を表しています: @advanced_1179_li Atomicity (原子性) : トランザクションはアトミックでなければならず、全てのタスクが実行されたか、実行されないかの どちらかであるという意味です。 @advanced_1180_li Consistency (一貫性) : 全てのオペレーションは定義された制約に従わなくてはいけません。 @advanced_1181_li Isolation (独立性 / 分離性) : トランザクションはそれぞれ独立 (隔離) されていなくてはなりません。 @advanced_1182_li Durability (永続性) : コミットされたトランザクションは失われません。 @advanced_1183_h3 Atomicity (原子性) @advanced_1184_p このデータベースでのトランザクションは常にアトミックです。 @advanced_1185_h3 Consistency (一貫性) @advanced_1186_p このデータベースは常に一貫性のある状態です。 参照整合性のルールは常に実行されます。 @advanced_1187_h3 Isolation (独立性 / 分離性) @advanced_1188_p H2は、他の多くのデータベースシステムと同様に、デフォルトの分離レベルは "read committed" です。これはより良いパフォーマンスを提供しますが、トランザクションは完全に分離されていないということも意味します。H2はトランザクション分離レベル "serializable"、"read committed"、"read uncommitted" をサポートしています。 @advanced_1189_h3 Durability (永続性) @advanced_1190_p このデータベースは、全てのコミットされたトランザクションが電源異常に耐えられるということを保証しません。全てのデータベースが電源異常の状況において、一部トランザクションが失われるということをテストは示しています (詳細は下記をご覧下さい)。トランザクションが失われることを容認できない場面では、ノートパソコン、またはUPS (無停電電源装置) を使用します。永続性がハードウェア異常の起こり得る全ての可能性に対して必要とされるのであれば、H2クラスタリングモードのようなクラスタリングが使用されるべきです。 @advanced_1191_h2 永続性問題 @advanced_1192_p 完全な永続性とは、全てのコミットされたトランザクションは電源異常に耐えられる、ということを意味します。 いくつかのデータベースは、永続性を保証すると主張していますが、このような主張は誤っています。 永続性テストはH2、HSQLDB、PostgreSQL、Derbyに対して実行されました。これらの全てのデータベースは、 時々コミットされたトランザクションを失います。このテストはH2ダウンロードに含まれています。 org.h2.test.poweroff.Test をご覧下さい。 @advanced_1193_h3 永続性を実現する (しない) 方法 @advanced_1194_p 失われなかったコミット済みトランザクションは、最初に思うよりもより複雑だということを理解して下さい。 完全な永続性を保障するためには、データベースは、コミットの呼び出しが返ってくる前に ログレコードがハードドライブ上にあることを確実にしなければなりません。 これを行うために、データベースは異なったメソッドを使用します。ひとつは "同期書き込み" ファイルアクセスモードを使用することです。Javaでは、RandomAccessFile はモード "rws" と "rwd" を サポートしています: @advanced_1195_li rwd: それぞれのファイル内容の更新は、元になるストレージデバイスと同時に書き込まれます。 @advanced_1196_li rws: rwdに加えて、それぞれのメタデータの更新は同時に書き込まれます。 @advanced_1197_p この特徴はDerbyで使用されています。それらのモードのうちのひとつは、テスト (org.h2.test.poweroff.TestWrite) において、毎秒およそ5万件の書き込み操作を実現します。オペレーティングシステムのライトバッファーが無効の時でさえも、 書き込み速度は毎秒およそ5万件です。この特徴はディスクを交換させるというものではありません。 なぜなら、全てのバッファーをフラッシュするのではないからです。テストはファイル内の同じバイトを何度も更新しました。 もしハードドライブがこの速度での書き込みが可能なら、ディスクは少なくても毎秒5万回転か、 または300万 RPM (revolutions per minute 回転毎分) を行う必要があります。 そのようなハードドライブは存在しません。テストで使用されたハードドライブは、およそ7200 RPM、または 毎秒120回転です。これがオーバーヘッドなので、最大書き込み速度はこれより低くなくてはなりません。 @advanced_1198_p バッファーは fsync 関数を呼ぶことによってフラッシュされます。Javaでこれを行う二つの方法があります: @advanced_1199_li FileDescriptor.sync() ドキュメンテーションには、これは強制的に全てのシステムバッファーに基本となる デバイスとの同期を取らせる、と書かれています。このFileDescriptorに関連するバッファーのインメモリでの 変更コピーが全て物理メディアに書かれた後、Syncは返ることになっています。 @advanced_1200_li FileChannel.force() (JDK 1.4 以来) このメソッドは、強制的にこのチャネルのファイルの更新は それを含むストレージデバイスに書き込まれることを行います。 @advanced_1201_p #By default, MySQL calls fsync for each commit. When using one of those methods, only around 60 write operations per second can be achieved, which is consistent with the RPM rate of the hard drive used. Unfortunately, even when calling FileDescriptor.sync() or FileChannel.force(), data is not always persisted to the hard drive, because most hard drives do not obey fsync(): see <a href="http://hardware.slashdot.org/article.pl?sid=05/05/13/0529252">Your Hard Drive Lies to You</a> . In Mac OS X, fsync does not flush hard drive buffers. See <a href="http://lists.apple.com/archives/darwin-dev/2005/Feb/msg00072.html">Bad fsync?</a> . So the situation is confusing, and tests prove there is a problem. @advanced_1202_p ハードドライブバッファーを懸命にフラッシュしようと試みると、パフォーマンスは非常に悪いものになります。 最初に、ハードドライブは実際には全てのバッファーをフラッシュしているということを確かめることが必要です。 テストは信頼性ある方法でこれが行われていないことを示しています。その結果、トランザクションの最大数は毎秒およそ60件です。 これらの理由により、H2のデフォルト性質はコミットされたトランザクションの書き込みを遅らせることです。 @advanced_1203_p H2では、電源異常の後、1秒以上のコミットされたトランザクションが失われます。 この性質を変更するためには。 SET WRITE_DELAY と CHECKPOINT SYNC を使用します。 多くの他のデータベースも同様に遅延コミットをサポートしています。パフォーマンス比較では、 遅延コミットは、サポートする全てのデータベースによって使用されました。 @advanced_1204_h3 永続性テストを実行する @advanced_1205_p このデータベースと他のデータベースの、永続性 / 非永続性テストを行うために、 パッケージ内 org.h2.test.poweroff のテストアプリケーションを使用することができます。 ネットワーク接続の二つのコンピューターがこのテストを実行するのに必要です。 ひとつのコンピューターは、他のコンピューター上でテストアプリケーションが実行されている間 (電源は切られています) ただ聞いています。リスナーアプリケーションのコンピューターは TCP/IP ポートを開き、 次の接続のために聞きます。二つ目のコンピューターは最初リスナーに接続し、データベースを作成して レコードの挿入を開始します。この接続は "autocommit" に設定されます。それぞれのレコード挿入後のコミットが 自動的に行われるという意味です。その後、テストコンピューターはこのレコードの挿入に成功したということを リスナーに通知します。リスナーコンピューターは10秒ごとに最後に挿入されたレコードを表示します。 電源を手動でOFFにしてコンピューターを再起動し、アプリケーションを再び実行します。 多くのケースで、リスナーコンピューターが知る全てのレコードを含むデータベースはないということがわかります。 詳細は、リスナーのソースコードとテストアプリケーションを参照して下さい。 @advanced_1206_h2 リカバーツールを使用する @advanced_1207_p リカバーツールはデータベースが破損している場合においても、 データファイルのコンテンツを復元するために使用されます。現段階では、ログファイルのコンテンツ、 または大きなオブジェクト (CLOB または BLOB) は復元しません。 このツールを実行するには、このコマンドラインをタイプして下さい: @advanced_1208_p 現在のディレクトリのそれぞれのデータベースのために、テキストファイルが作られます。 このファイルには、データベースのスキーマを再び作成するために、行挿入ステートメント (データのための) と data definition (DDL) ステートメントを含んでいます。このファイルは、行挿入ステートメントが 正しいテーブル名を保持していないため、直接実行するこはできません。そのため、 ファイルは実行する前に手動で前処理を行う必要があります。 @advanced_1209_h2 ファイルロックプロトコル @advanced_1210_p データベースが開かれるときはいつも、データベースが使用中であると他のプロセスに合図するためにロックファイルが作成されます。もしデータベースが閉じられるか、データベースを開いたプロセスが終了するなら、ロックファイルは削除されます。 @advanced_1211_p 特別なケースでは (例えば、停電のためプロセスが正常に終了されなかった場合)、 ロックファイルは作られたプロセスによって削除されません。これは、ロックファイルの存在は、 ファイルロックのための安全なプロトコルではない、ということを意味しています。 しかし、このソフトウェアはデータベースファイルを守るため、challenge-responseプロトコルを使用します。 セキュリティ (同じデータベースファイルは、同時に二つのプロセスによって開かれてはいけない) と シンプリシティー (ロックファイルはユーザーによって手動で削除される必要がない) の両方を備えるために 二つのメソッド (アルゴリズム) が実行されます。二つのメソッドは、"Fileメソッド" と "Socketメソッド" です。 @advanced_1212_h3 ファイルロックメソッド "File" @advanced_1213_p データベースファイルロックのデフォルトメソッドは "Fileメソッド" です。アルゴリズム: @advanced_1214_li ロックファイルが存在しない時は、作成されます (アトミックオペレーション File.createNewFile を使用する)。 その時、プロセスは少し (20ms) 待機し、再びファイルをチェックします。 もしファイルがこの間に変更されたら、オペレーションは中止されます。 ロックファイルを作成したすぐ後にプロセスがロックファイルを削除する時、 これはレースコンディションから保護し、三番目のプロセスはファイルを再び作成します。 二つのライターしか存在しなければ、これは起こりません。 @advanced_1215_li もしファイルが作成されたら、ロックメソッド ("file") でランダムな番号が一緒に挿入されます。 その後、ファイルが他のスレッド/ プロセスによって削除、または 修正された時、定期的にチェックする (デフォルトでは毎秒1回) watchdogスレッドは開始されます。 これが起きる時はいつも、ファイルは古いデータに上書きされます。システムが非常に混み合っている時でさえも、 非検出の状態で処理できないロックファイルを変更するために、watchdogスレッドは最優先に実行します。 しかし、watchdogスレッドはほとんどの時間待機しているため、非常に小さなリソース (CPU time) を使用します。 また、watchdogはハードディスクから読み取りのみ行い、書き込みはしません。 @advanced_1216_li もしロックファイルが存在し、20ms内に変更されたら、プロセスは数回 (10回以上) 待機します。 まだ変更されていたら、例外が投げられます (データベースはロックされます)。 多数の並列ライターで競合している状態を排除するためにこれが行われます。 その後、ファイルは新しいバージョンに上書きされます。 そして、スレッドは2秒間待機します。もしファイルを保護するwatchdogスレッドが存在したら、 変更は上書きし、このプロセスはデータベースをロックするために機能しなくなります。 しかし、もしwatchdogスレッドが存在しなければ、ロックファイルはこのスレッドによって 書かれたままの状態です。このケースでは、ファイルは削除され、自動的にまた作成されます。 watchdogスレッドはこのケースでは起動され、ファイルはロックされます。 @advanced_1217_p このアルゴリズムは100以上の並列スレッドでテストされました。いくつかのケースでは、 データベースをロックしようとする多数の並列スレッドが存在する時、それらはしばらくお互いをブロックします (それらのうちどれかがファイルをロックすることができないことを意味します)。 しかし、ファイルは同時に二つのスレッドによってロックされることは決してありません。 しかし、多数の並列スレッド / プロセスを使用することは一般的な使用ケースではありません。 通常、データベースを開くことができなかったり、(速い)ループのやり直しができなかったりした場合、 アプリケーションはユーザーにエラーを投げるべきです。 @advanced_1218_h3 ファイルロックメソッド "Socket" @advanced_1219_p 実行される二つ目のロックメカニズムがありますが、 デフォルトでは使用不可です。アルゴリズムは: @advanced_1220_li ロックファイルが存在しない時は、作成されます。その時、サーバーソケットは定義されたポートで開かれ、 開かれた状態を保ちます。開かれたデータベースのプロセスのポートとIPアドレスはロックファイルの中に書かれています。 @advanced_1221_li もしロックファイルが存在し、ロックメソッドが "file" なら、ソフトウェアは "file" メソッドにスイッチします。 @advanced_1222_li もしロックファイルが存在し、ロックメソッドが "socket" なら、プロセスはポートが使用されているかチェックします。 最初のプロセスがまだ実行されていたら、ポートは使用されていれ、このプロセスは例外を投げます (database is in use)。 最初のプロセスが失われたら (例えば、停電または、仮想マシンの異常終了のため)、ポートは解除されます。 新しいプロセスはロックファイルを削除し、再び起動します。 @advanced_1223_p このメソッドは、活発に毎秒同じファイルをポーリングする (読み込む) watchdogスレッドを必要としていません。 このメソッドの問題は、ファイルがネットワークシェアに保存されたら、二つのプロセスは (異なるコンピューターで実行中の)、 TCP/IP接続を直接保持していなければ、同じデータベースファイルを開くことができます。 @advanced_1224_h2 SQLインジェクションに対する防御 @advanced_1225_h3 SQLインジェクションとは @advanced_1226_p このデータベースエンジンは "SQLインジェクション" として知られる セキュリティ脆弱性の解決策を備えています。 これは、SQLインジェクションの意味とは何か、 についての短い説明です。いくつかのアプリケーションは、エンベッドユーザーがこのように入力する SQLステートメントを構築します: @advanced_1227_p このメカニズムがアプリケーションのどこかで使用され、ユーザー入力が正しくないフィルター処理、 またはエンベッドなら、ユーザーはパスワード: ' OR ''=' のような (この例の場合) 特別に作られた入力を使用することによって、SQLの機能、またはステートメントに入り込むことが可能です。 このケースでは、ステートメントはこのようになります: @advanced_1228_p データベースに保存されたパスワードが何であっても、これは常に正しいものになります。 SQLインジェクションについての詳細は、用語集とリンク をご覧下さい。 @advanced_1229_h3 リテラルを無効にする @advanced_1230_p ユーザー入力が直接SQLステートメントに組み込まれなければ、 SQLインジェクションは不可能です。上記の問題の簡単な解決方法は、PreparedStatementを使用することです: @advanced_1231_p このデータベースは、ユーザー入力をデータベースに通す時、パラメータの使用を強制する方法を提供しています。 SQLステートメントの組み込まれたリテラルを無効にすることでこれを実行します。 次のステートメントを実行します: @advanced_1232_p #Afterwards, SQL statements with text and number literals are not allowed any more. That means, SQL statement of the form WHERE NAME='abc' or WHERE CustomerId=10 will fail. It is still possible to use PreparedStatements and parameters as described above. Also, it is still possible to generate SQL statements dynamically, and use the Statement API, as long as the SQL statements do not include literals. There is also a second mode where number literals are allowed: SET ALLOW_LITERALS NUMBERS. To allow all literals, execute SET ALLOW_LITERALS ALL (this is the default setting). Literals can only be enabled or disabled by an administrator. @advanced_1233_h3 定数を使用する @advanced_1234_p リテラルを無効にするということは、ハードコード化された "定数" リテラルを無効にする、 ということも意味します。このデータベースは、CREATE CONSTANT コマンドを使用して定数を定義することをサポートしています。 定数はリテラルが有効であるときのみ定義することができますが、リテラルが無効の時でも使用することができます。 カラム名の名前の衝突を避けるために、定数は他のスキーマで定義できます: @advanced_1235_p リテラルが有効の時でも、クエリーやビューの中でハードコード化された数値リテラル、 またはテキストリテラルの代わりに、定数を使用する方がより良いでしょう。With 定数では、タイプミスはコンパイル時に発見され、ソースコードは理解、変更しやすくなります。 @advanced_1236_h3 ZERO() 関数を使用する @advanced_1237_p 組み込み関数 ZERO() がすでにあるため、 数値 0 のための定数を作る必要はありません: @advanced_1238_h2 #Restricting Class Loading and Usage @advanced_1239_p #By default there is no restriction on loading classes and executing Java code for admins. That means an admin may call system functions such as System.setProperty by executing: @advanced_1240_p #To restrict users (including admins) from loading classes and executing code, the list of allowed classes can be set in the system property h2.allowedClasses in the form of a comma separated list of classes or patterns (items ending with '*'). By default all classes are allowed. Example: @advanced_1241_p #This mechanism is used for all user classes, including database event listeners, trigger classes, user-defined functions, user-defined aggregate functions, and JDBC driver classes (with the exception of the H2 driver) when using the H2 Console. @advanced_1242_h2 セキュリティプロトコル @advanced_1243_p 次の文章は、このデータベースで使用されている セキュリティプロトコルのドキュメントです。これらの記述は非常に専門的で、 根本的なセキュリティの基本をすでに知っているセキュリティ専門家のみを対象としています。 @advanced_1244_h3 ユーザーパスワードの暗号化 @advanced_1245_p ユーザーがデータベースに接続しようとする時、ユーザー名の組み合わせ、@、パスワードは SHA-256 を使用してハッシュ化され、このハッシュ値はデータベースに送信されます。 この手順は、クライアントとサーバー間の転送をアタッカーが聞ける (非暗号化できる) のであれば、 再使用する値からのアタッカーを試みることはありません。しかし、パスワードはクライアントとサーバー間で 暗号化されていない接続を使用している時でさえも、プレーンテキストで送信されることはありません これはもしユーザーが、異なる場面で同じパスワードを再利用しても、このパスワードはある程度まで保護されます。 詳細は"RFC 2617 - HTTP Authentication: Basic and Digest Access Authentication" もご覧下さい。 @advanced_1246_p 新しいデータベース、またはユーザーが作られた時、暗号化された安全なランダムの 新しいsalt値が生成されます。salt値のサイズは 64 bit です。 ランダムなsaltを使用することによって、多数の異なった (通常、使用された) パスワードのハッシュ値を アタッカーに再計算されるリスクが軽減します。 @advanced_1247_p ユーザーパスワードのハッシュ値の組み合わせと (上記をご覧下さい) saltは SHA-256を使用してハッシュ化されます。 結果の値はデータベースに保存されます。ユーザーがデータベースに接続しようとする時、 データベースは、保存されたsalt値のユーザーパスワードのハッシュ値と計算されたハッシュ値を結合します。 他の製品は複数の反復 (ハッシュ値を繰り返しハッシュする) を使用していますが、 この製品ではサービス攻撃の拒絶 (アタッカーが偽のパスワードで接続しようとするところや、 サーバーがそれぞれのパスワードのハッシュ値を計算するのに長い時間費やすところ) のリスクを軽減するのに これは使用しません。理由は: もしアタッカーがハッシュ化されたパスワードにアクセスしたら、 プレーンテキストのデータにもアクセスできるため、パスワードはもはや必要ではなくなってしまいます。 もしデータが、保存されている他のコンピューターによって保護されていて、遠隔のみであるなら、 反復回数は全く必要とされません。 @advanced_1248_h3 ファイル暗号化 @advanced_1249_p データベースファイルは二つの異なるアルゴリズムを使用して、暗号化されます: AES-128 と XTEA です (32 ラウンドを使用)。 XTEAをサポートする理由はパフォーマンス (XTEAはAESのおよそ二倍の速さです) と、AESが突然壊れた場合、代わりとなるアルゴリズムを 持っているからです。 @advanced_1250_p ユーザーが暗号化されたデータベースに接続しようとした時、"file" という単語と、@と、 ファイルパスワードの組み合わせは、SHA-256を使用してハッシュ化されます。 このハッシュ値はサーバーに送信されます。 @advanced_1251_p 新しいデータベースファイルが作られた時、暗号化された安全なランダムの新しいsalt値が生成されます。 このsaltのサイズは 64 bitです。ファイルパスワードのハッシュとsalt値の組み合わせは、 SHA-256を使用して1024回ハッシュ化されます。反復の理由は、アタッカーが通常のパスワードの ハッシュ値を計算するよりも困難にするためです。 @advanced_1252_p ハッシュ値の結果は、ブロック暗号アルゴリズム (AES-128、または 32ラウンドのXTEA) のためのキーとして 使用されます。その時、初期化ベクター (IV) キーは、再びSHA-256を使用してキーをハッシュ化することによって 計算されます。IVはアタッカーに知らないということを確認して下さい。秘密のIVを使用する理由は、 ウォーターマークアタック (電子透かし攻撃) を防御するためです。 @advanced_1253_p データのブロックを保存する前に (それぞれのブロックは 8 バイト長)、次のオペレーションを 実行します: 最初に、IVはIVキー (同じblock cipher algorithmを使用して) でブロックナンバーを 暗号化することによって計算されます。このIVはXORを使用してプレーンテキストと併用されます。 結果データはAES-128、またはXTEAアルゴリズムを使用して暗号化されます。 @advanced_1254_p 復号化の時、オペレーションは反対に行われます。最初に、ブロックはキーを使用して復号化され、 その時、IVはXORを使用して復号化テキストと併用されます。 @advanced_1255_p その結果、オペレーションのブロック暗号モードはCBT (Cipher-block chaining) ですが、 それぞれの連鎖はたったひとつのブロック長です。ECB (Electronic codebook) モードに優る利点は、 データのパターンが明らかにされない点で、複数のブロックCBCに優る利点は、 はじき出された暗号テキストビットは次のブロックではじき出されたプレーンテキストビットに伝播されないという点です。 @advanced_1256_p データベース暗号化は、使用されていない間は (盗まれたノートパソコン等) 安全なデータベースだということを 意味します。これは、データベースが使用されている間に、アタッカーがファイルにアクセスしたというケースを 意味するのではありません。アタッカーが書き込みアクセスをした時、例えば、 彼はファイルの一部を古いバージョンに置き換え、データをこのように操ります。 @advanced_1257_p ファイル暗号化はデータベースエンジンのパフォーマンスを低速にします。非暗号化モードと比較すると、 データベースオペレーションは、XTEAを使用する時はおよそ2.2倍長くかかり、 AESを使用する時は2.5倍長くかかります (エンベッドモード)。 @advanced_1258_h3 #Wrong Password Delay @advanced_1259_p #To protect against remote brute force password attacks, the delay after each unsuccessful login gets double as long. Use the system properties h2.delayWrongPasswordMin and h2.delayWrongPasswordMax to change the minimum (the default is 250 milliseconds) or maximum delay (the default is 4000 milliseconds, or 4 seconds). The delay only applies for those using the wrong password. Normally there is no delay for a user that knows the correct password, with one exception: after using the wrong password, there is a delay of up (randomly distributed) the same delay as for a wrong password. This is to protect against parallel brute force attacks, so that an attacker needs to wait for the whole delay. Delays are synchronized. This is also required to protect against parallel attacks. @advanced_1260_h3 SSL/TLS 接続 @advanced_1261_p 遠隔SSL/TLS接続は、Java Secure Socket Extension (SSLServerSocket / SSLSocket) の使用をサポートしています。デフォルトでは、匿名のSSLは使用可能です。デフォルトの暗号化パッケージソフトは SSL_DH_anon_WITH_RC4_128_MD5 です。 @advanced_1262_p #To use your own keystore, set the system properties <code>javax.net.ssl.keyStore</code> and <code>javax.net.ssl.keyStorePassword</code> before starting the H2 server and client. See also <a href="http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.html#CustomizingStores">Customizing the Default Key and Trust Stores, Store Types, and Store Passwords</a> for more information. @advanced_1263_p #To disable anonymous SSL, set the system property <code>h2.enableAnonymousSSL</code> to false. @advanced_1264_h3 HTTPS 接続 @advanced_1265_p webサーバーは、SSLServerSocketを使用したHTTP と HTTPS接続をサポートします。 簡単に開始できるように、デフォルトの自己認証された証明書がありますが、 カスタム証明書も同様にサポートされています。 @advanced_1266_h2 汎用一意識別子 (UUID) @advanced_1267_p このデータベースはUUIDをサポートしています。 また、暗号化強力疑似乱数ジェネレーターを使用して新しいUUIDを作成する関数をサポートしています。 同じ値をもつ二つの無作為なUUIDが存在する可能性は、確率論を使用して計算されることができます。 "Birthday Paradox" もご覧下さい。標準化された無作為に生成されたUUIDは、122の無作為なビットを保持しています。 4ビットはバージョン(無作為に生成されたUUID) に、2ビットはバリアント (Leach-Salz) に使用されます。 このデータベースは組み込み関数 RANDOM_UUID() を使用してこのようなUUIDを生成することをサポートしています。 ここに、値の数字が生成された後、二つの 同一のUUIDが生じる可能性を見積もる小さなプログラムがあります: @advanced_1268_p いくつかの値は: @advanced_1269_p 人の隕石に衝突するという年に一度の危険性は、170億に一回と見積もられ、それは、確率がおよそ 0.000'000'000'06 だということを意味しています。 @advanced_1270_h2 システムプロパティから読み込まれた設定 @advanced_1271_p いくつかのデータベースの設定は、-DpropertyName=value を使用してコマンドラインで設定することができます。 通常、これらの設定は手動で変更することは必要とされていません。設定は大文字と小文字を区別しています。 例: @advanced_1272_p #The current value of the settings can be read in the table INFORMATION_SCHEMA.SETTINGS. @advanced_1273_p #For a complete list of settings, see <a href="../javadoc/org/h2/constant/SysProperties.html">SysProperties</a> . @advanced_1274_h2 #Setting the Server Bind Address @advanced_1275_p #Usually server sockets accept connections on any/all local addresses. This may be a problem on multi-homed hosts. To bind only to one address, use the system property h2.bindAddress. This setting is used for both regular server sockets and for SSL server sockets. IPv4 and IPv6 address formats are supported. @advanced_1276_h2 用語集とリンク @advanced_1277_th 用語 @advanced_1278_th 説明 @advanced_1279_td AES-128 @advanced_1280_td ブロック暗号化アルゴリズム。こちらもご覧下さい:<a href="http://en.wikipedia.org/wiki/Advanced_Encryption_Standard">Wikipedia: AES</a> @advanced_1281_td Birthday Paradox @advanced_1282_td 部屋にいる二人が同じ誕生日の可能性が期待された以上に高いということを説明する。 また、有効なランダムに生成されたUUID。こちらもご覧下さい:<a href="http://en.wikipedia.org/wiki/Birthday_paradox">Wikipedia: Birthday Paradox</a> @advanced_1283_td Digest @advanced_1284_td パスワードを保護するプロトコル (データは保護しません)。こちらもご覧下さい:<a href="http://www.faqs.org/rfcs/rfc2617.html">RFC 2617: HTTP Digest Access Authentication</a> @advanced_1285_td GCJ @advanced_1286_td JavaのGNUコンパイラー<a href="http://gcc.gnu.org/java/">http://gcc.gnu.org/java/</a> and <a href="http://nativej.mtsystems.ch">http://nativej.mtsystems.ch/ (not free any more)</a> @advanced_1287_td HTTPS @advanced_1288_td セキュリティをHTTP接続に提供するプロトコル。こちらもご覧下さい: <a href="http://www.ietf.org/rfc/rfc2818.txt">RFC 2818: HTTP Over TLS</a> @advanced_1289_td Modes of Operation @advanced_1290_a Wikipedia: Block cipher modes of operation @advanced_1291_td Salt @advanced_1292_td パスワードのセキュリティを増大する乱数。こちらもご覧下さい: <a href="http://en.wikipedia.org/wiki/Key_derivation_function">Wikipedia: Key derivation function</a> @advanced_1293_td SHA-256 @advanced_1294_td 暗号化の一方方向のハッシュ関数。こちらもご覧下さい:<a href="http://en.wikipedia.org/wiki/SHA_family">Wikipedia: SHA hash functions</a> @advanced_1295_td SQLインジェクション @advanced_1296_td 組み込みのユーザー入力でアプリケーションがSQLステートメントを生成するセキュリティ脆弱性 こちらもご覧下さい:<a href="http://en.wikipedia.org/wiki/SQL_injection">Wikipedia: SQL Injection</a> @advanced_1297_td Watermark Attack (透かし攻撃) @advanced_1298_td 復号化することなくあるデータの存在を証明できる、ある暗号化プログラムのセキュリティ問題。 詳細は、インターネットで "watermark attack cryptoloop" を検索して下さい。 @advanced_1299_td SSL/TLS @advanced_1300_td Secure Sockets Layer / Transport Layer Security。こちらもご覧下さい: <a href="http://java.sun.com/products/jsse/">Java Secure Socket Extension (JSSE)</a> @advanced_1301_td XTEA @advanced_1302_td ブロック暗号化アルゴリズム。こちらもご覧下さい: <a href="http://en.wikipedia.org/wiki/XTEA">Wikipedia: XTEA</a> @build_1000_h1 ビルド @build_1001_a ポータビリティ @build_1002_a 環境 @build_1003_a ソフトウェアのビルド @build_1004_a Maven 2 の利用 @build_1005_a #Translating @build_1006_h2 ポータビリティ @build_1007_p このデータベースはJavaによって記述されているため、多くのプラットフォームで動作します。また、GCJを利用することで、ネイティブでも実行可能に(ネイティブコードに)コンパイルすることが可能です @build_1008_h2 環境 @build_1009_p #A Java Runtime Environment (JRE) version 1.4 or higher is required to run this database. @build_1010_p #To build the database executables, the following software stack was used. Newer version or compatible software works too. @build_1011_li Windows XP @build_1012_li #Sun JDK Version 1.4 @build_1013_li Mozilla Firefox 1.5 @build_1014_li Eclipse Version 3.2.2 @build_1015_li YourKit Java Profiler @build_1016_li Apache Ant Version 1.6.5 @build_1017_h2 ソフトウェアのビルド @build_1018_p コマンドライン上でsrcディレクトリに移動し、以下のコマンドを実行してください: @build_1019_p #You will get a list of targets. If you want to build the jar file, execute: @build_1020_p JDBC APIを実装し、サーバーにのみ接続するクラスを持つjarファイルをビルドするには、jarCliantターゲットを用います: @build_1021_p これ以外のターゲットも実行が可能でしょう @build_1022_h2 Maven 2 の利用 @build_1023_h3 Centralリポジトリの利用 @build_1024_p 依存関係を取ることで、Maven 2プロジェクトでデータベースを組み込むことも可能です。例: @build_1025_p #New versions of this database are first uploaded to http://hsql.sourceforge.net/m2-repo/ and then automatically synchronized with the main maven repository; however after a new release it may take a few hours before they are available there. @build_1026_h3 スナップショットバージョンの利用 @build_1027_p スナップショット版のH2.jarファイルをビルドし、ローカルのMaven2リポジトリを更新するには以下のコマンドを実行します: @build_1028_p 実行後、Maven2プロジェクトにH2DBを依存させ組み込むことが出来るようになります: @build_1029_h2 #Translating @build_1030_p #The translation of this software is split into the following parts: @build_1031_li #H2 Console: src/main/org/h2/server/web/res/_text_*.properties @build_1032_li #Error messages: src/main/org/h2/res/_messages_*.properties @build_1033_li #Web site: src/docsrc/text/_docs_*.utf8.txt @build_1034_p #The conversion between UTF-8 and Java encoding (using the \u syntax), as well as the HTML entities (&#..;) is automated by running the tool PropertiesToUTF8. The web site translation is automated as well, using <code>build docs</code> . @changelog_1000_h1 変更履歴 @changelog_1001_h2 #Next Version (unreleased) @changelog_1002_li #- @changelog_1003_h2 #Version 1.0.73 (2008-05-31) @changelog_1004_li #ParameterMetaData now returns the right data type for most conditions, as in WHERE ID=?. @changelog_1005_li #The table SYSTEM_RANGE now supports expressions and parameters. @changelog_1006_li #New column INFORMATION_SCHEMA.CONSTRAINTS.UNIQUE_INDEX_NAME that contains the name of the unique index used to enforce this constraint, if there is such an index. @changelog_1007_li #SET QUERY_TIMEOUT and Statement.setQueryTimeout no longer commits a transaction. The same applies to SET @VARIABLE, SET LOCK_TIMEOUT, SET TRACE_LEVEL_*, SET THROTTLE, and SET PATH. @changelog_1008_li #The SCRIPT command does now emit IF NOT EXISTS for CREATE ROLE. @changelog_1009_li #MySQL compatibility: auto_increment column are no longer automatically converted to primary key columns. @changelog_1010_li #PostgreSQL compatibility: support for BOOL_OR and BOOL_AND aggregate functions. @changelog_1011_li #Negative scale values for DECIMAL or NUMBER columns are now supported in regular tables and in linked tables. @changelog_1012_li #A role or right can now be granted or revoked multiple times without getting an exception. @changelog_1013_li #Infinite numbers in SQL scripts are listed as POWER(0, -1)), negative infinite as (-POWER(0, -1)), and NaN (not a number) as SQRT(-1). @changelog_1014_li #The special double and float values 'NaN' (not a number) did not work correctly when sorting or comparing. @changelog_1015_li #The fulltext search did not support CLOB data types. @changelog_1016_li #If the drive with the database files was disconnected or unmounted while writing, sometimes a stack overflow exception was thrown instead of a IO exception. @changelog_1017_li #The H2 Console could not be shut down from within the tool if the browser supports keepAlive (most browsers do). @changelog_1018_li #If the password was passed as a char array, it was kept in an internal buffer longer than required. Theoretically the password could have been stolen if the main memory was swapped to disk before the garbage collection was run. @changelog_1019_h2 #Version 1.0.72 (2008-05-10) @changelog_1020_li #Some databases could not be opened when appending ;RECOVER=1 to the database URL. @changelog_1021_li #The Japanese translation of the error messages and the H2 Console has been completed by Masahiro Ikemoto (Arizona Design Inc.) @changelog_1022_li #Updates made to updatable rows are now visible within the same result set. DatabaseMetaData.ownUpdatesAreVisible now returns true. @changelog_1023_li #ParameterMetaData now returns the correct data for INSERT and UPDATE statements. @changelog_1024_li #H2 Shell: DESCRIBE now supports an schema name. @changelog_1025_li #A subset of the PostgreSQL 'dollar quoting' feature is now supported. @changelog_1026_li #SLF4J is now supported by using adding TRACE_LEVEL_FILE=4 to the database URL. @changelog_1027_li #The recovery tool did not work if the table name contained spaces or if there was a comment on the table. @changelog_1028_li #Triggers are no longer executed when changing the table structure (ALTER TABLE). @changelog_1029_li #When setting BLOB or CLOB values larger than 65 KB using a remote connection, temporary files were kept on the client longer than required (until the connection was closed or the object is garbage collected). Now they are removed as soon as the PreparedStatement is closed, or when the value is overwritten. @changelog_1030_li #Statements can now be cancelled remotely (when using remote connections). @changelog_1031_li #The Shell tool now uses java.io.Console to read the password when using JDK 1.6 @changelog_1032_li #When using read-only databases and setting LOG=2, an exception was written to the trace file when closing the database. Fixed. @changelog_1033_h2 #Version 1.0.71 (2008-04-25) @changelog_1034_li #H2 is now dual-licensed under the Eclipse Public License (EPL) and the old 'H2 License' (which is basically MPL). @changelog_1035_li #Sometimes an exception 'File ID mismatch' or 'try to add a record twice' occured after large records (8 KB or larger) are updated or deleted. See also http://code.google.com/p/h2database/issues/detail?id=22 @changelog_1036_li #H2 Console: The tools can now be translated (it didn't work in the last release). @changelog_1037_li #New traditional Chinese translation. Thanks a lot to Derek Chao! @changelog_1038_li #Indexes were not used when enabling the optimization for IN(SELECT...) (system property h2.optimizeInJoin). @changelog_1039_h2 #Version 1.0.70 (2008-04-20) @changelog_1040_li #The plan is to dual-license H2. The additional license is EPL (Eclipse Public License). The current license (MPL, Mozilla Public License) will stay. Current users are not affected because they can keep MPL. EPL is very similar to MPL, the only bigger difference is related to patents (EPL is a bit more business friendly in this regard). See also http://opensource.org/licenses/eclipse-1.0.php, http://www.eclipse.org/legal/eplfaq.php (FAQ), http://blogs.zdnet.com/Burnette/?p=131 @changelog_1041_li #Multi version concurrency (MVCC): when a row was updated, and the updated column was not indexed, this update was visible sometimes for other sessions even if it was not committed. @changelog_1042_li #Calling SHUTDOWN on one connection and starting a query on another connection concurrently could result in a Java level deadlock. @changelog_1043_li #New system property h2.enableAnonymousSSL (default: true) to enable anonymous SSL connections. @changelog_1044_li #The precision if SUBSTR is now calculated if possible. @changelog_1045_li #The autocomplete in the H2 Console has been improved a bit. @changelog_1046_li #The tools in the H2 Console are now translatable. @changelog_1047_li #The servlet and lucene jar files are now automatically downloaded when building. @changelog_1048_li #The code switch tool has been replaced by a simpler tool called SwitchSource that just uses find and replace. @changelog_1049_li #Started to write a Ant replacement ('JAnt') that uses pure Java build definitions. Advantages: ability to debug the build, extensible, flexible, no XML, a bit faster. Future plan: support creating custom h2 distributions (for embedded use). Maybe create a new project 'Jant' or 'Javen' if other people are interested. @changelog_1050_li #The jar file is now about 10% smaller because the variable debugging info is no longer included. The source file and line number debugging info is still included. If required, the jar file size of the full version can be further reduced to about 720 KB using 'build jarSmall' or even more by removing unneeded components. @changelog_1051_li #Added shell scripts run.sh and build.sh. chmod +x is required, but otherwise it should work. Feedback or improvements are welcome! @changelog_1052_li #Databases in zip files: large queries are now supported. Temp files are created in the temp directory if required. The documentation how to create the zip file has been corrected. @changelog_1053_li #Invalid inline views threw confusing SQL exceptions. @changelog_1054_li #The Japanese translation of the error messages and the H2 Console has been improved. Thanks a lot to Masahiro IKEMOTO. @changelog_1055_li #Optimization for MIN() and MAX() when using MVCC. @changelog_1056_li #To protect against remote brute force password attacks, the delay after each unsuccessful login now gets double as long. New system properties h2.delayWrongPasswordMin and h2.delayWrongPasswordMax. @changelog_1057_li #After setting the query timeout and then resetting it, the next query would still timeout. Fixed. @changelog_1058_li #Adding a IDENTITY column to a table with data threw a lock timeout. @changelog_1059_li #OutOfMemoryError could occur when using EXISTS or IN(SELECT ..). @changelog_1060_li #The built-in connection pool is not called JdbcConnectionPool. The API and documentation has been changed. @changelog_1061_li #The ConvertTraceFile tool now generates SQL statement statistics at the end of the SQL script file (similar to the profiling data generated when using java -Xrunhprof). @changelog_1062_li #Nested joins are now supported (A JOIN B JOIN C ON .. ON ..) @changelog_1063_h2 #Version 1.0.69 (2008-03-29) @changelog_1064_li #Most command line tools can now be called from within the H2 Console. @changelog_1065_li #A new Shell tools is now included (org.h2.tools.Shell) to query a database from the command line. @changelog_1066_li #The command line options in the tools have changed: instead of '-log true' now '-trace' is used. Also, '-ifExists', '-tcpSSL' and '-tcpAllowOthers' and so on have changed: now the 'true' is no longer needed. The old behavior is still supported. @changelog_1067_li #New system property h2.sortNullsHigh to invert the default sorting behavior for NULL. The default didn't change. @changelog_1068_li #Performance was very slow when using LOG=2 and deleting or updating all rows of a table in a loop. Fixed. @changelog_1069_li #ALTER TABLE or CREATE TABLE now support parameters for the password field. @changelog_1070_li #The linear hash has been removed. It was always slower than the b-tree index, and there were some bugs that would be hard to fix. @changelog_1071_li #TRACE_LEVEL_ settings are no longer persistent. This was a problem when database initialization code caused a lot of trace output. @changelog_1072_li #Fulltext search (native implementation): The words table is no longer an in-memory table because this caused memory problems in some cases. @changelog_1073_li #It was possible to create a role with the name as an existing user (but not vice versa). This is not allowed any more. @changelog_1074_li #The recovery tool didn't work correctly for tables without rows. @changelog_1075_li #For years below 1, the YEAR method didn't return the correct value, and the conversion from date and timestamp to varchar was incorrect. @changelog_1076_li #CSVWRITE caused a NullPointerException when not specifying a nullString. @changelog_1077_li #When a log file switch occured just after a truncate table or drop table statement, the database could not be started normally (RECOVER=1 was required). Fixed. @changelog_1078_li #When a log file switch occured in the middle of a sequence flush (sequences are only flushed every 32 values by default), the sequence value was lost. Fixed. @changelog_1079_li #Altering a sequence didn't unlock the system table when autocommit switched off. @changelog_1080_h2 #Version 1.0.68 (2008-03-18) @changelog_1081_li #Very large SELECT DISTINCT and UNION EXCEPT queries are now supported, however this feature is disabled by default. To enable it, set the system property h2.maxMemoryRowsDistinct to a lower value, for example 10000. @changelog_1082_li #A error is now thrown when trying to call a method inside a trigger that implicitly commits the current transaction, if an object is locked. @changelog_1083_li #Unused LOB files were deleted much too late. Now they are deleted if no longer referenced in memory. @changelog_1084_li #ALTER SEQUENCE and ALTER TABLE ALTER COLUMN RESTART can now be used inside a transaction. @changelog_1085_li #New system property h2.aliasColumnName. When enabled, aliased columns (as in SELECT ID AS I FROM TEST) return the real table and column name in ResultSetMetaData.getTableName() and getColumnName(). This is disabled by default for compatibility with other databases (HSQLDB, Apache Derby, PostgreSQL, some version of MySQL). In version 1.1 this setting will be enabled. @changelog_1086_li #When using encrypted databases, and using the wrong file password, the log file was renamed if the database was not already open. Fixed. @changelog_1087_li #Improved performance when using lob files in directories (however this is still disabled by default) @changelog_1088_li #H2 Console: autocomplete didn't work with very large scripts. Fixed. @changelog_1089_li #Fulltext search: new method SEARCH_DATA that returns the column names and primary keys as arrays. @changelog_1090_li #New experimental optimization for GROUP BY queries if an index can be used that matches the group by columns. To enable this optimization, set the system property h2.optimizeGroupSorted to true. @changelog_1091_li #When using multi-version concurrency (MVCC=TRUE), duplicate rows could appear in the result set when running queries with uncommitted changes in the same session. @changelog_1092_li #H2 Console: remote connections were very slow because getHostName/getRemoteHost was used. Fixed (now using getHostAddress/getRemoteAddr. @changelog_1093_li #H2 Console: on Linux, Firefox, Konqueror, or Opera (in this order) are now started if available. This has been tested on Ubuntu. @changelog_1094_li #H2 Console: the start window works better with IKVM @changelog_1095_li #H2 Console: improved compatibility with Safari (Safari requires keep-alive) @changelog_1096_li #Random: the process didn't stop if generating the random seed using the standard way (SecureRandom.generateSeed) was very slow. Now using a daemon thread to avoid this problem. @changelog_1097_li #SELECT UNION with a different number of ORDER BY columns did throw an ArrayIndexOutOfBoundsException. @changelog_1098_li #When using a view, the column precision was changed to the default scale for some data types. @changelog_1099_li #CSVWRITE now supports a 'null string' that is used for parsing and writing NULL. @changelog_1100_li #Some long running queries could not be cancelled. @changelog_1101_li #Queries with many outer join tables were very slow. Fixed. @changelog_1102_li #The performance of text comparison has been improved when using locale sensitive string comparison (SET COLLATOR). Now CollationKey is used with a LRU cache. The default cache size is 10000, and can be changed using the system property h2.collatorCacheSize. Use 0 to disable the cache. @changelog_1103_li #UPDATE SET column=DEFAULT is now supported. @changelog_1104_h2 #Version 1.0.67 (2008-02-22) @changelog_1105_li #New function FILE_READ to read a file or from an URL. Both binary and text data is supported. @changelog_1106_li #CREATE TABLE AS SELECT now supports specifying the column list and data types. @changelog_1107_li #Connecting to a TCP server and at shutting it down at the same time could cause a Java level deadlock. @changelog_1108_li #A user now has all rights on his own local temporary tables. @changelog_1109_li #The CSV tool now supports a custom lineSeparator. @changelog_1110_li #When using multiple connections, empty space was reused too early sometimes. This could corrupt the database when recovering. @changelog_1111_li #The H2 Console has been translated to Dutch. Thanks a lot to Remco Schoen! @changelog_1112_li #Databases can now be opened even if trigger classes are not in the classpath. The exception is thrown when trying to fire the trigger. @changelog_1113_li #Opening databases with ACCESS_MODE_DATA=r is now supported. In this case the database is read-only, but the files don't not need to be read-only. @changelog_1114_li #Security: The database now waits 200 ms before throwing an exception if the user name or password don't match, to slow down dictionary attacks. @changelog_1115_li #The value cache is now a soft reference cache. This should help save memory. @changelog_1116_li #CREATE INDEX on a table with many rows could run out of memory. Fixed. @changelog_1117_li #Large result sets are now a bit faster. @changelog_1118_li #ALTER TABLE ALTER COLUMN RESTART and ALTER SEQUENCE now support parameters (any expressions). @changelog_1119_li #When setting the base directory on the command line, the user directory prefix ('~') was ignored. @changelog_1120_li #The DbStarter servlet didn't start the TCP listener even if configured. @changelog_1121_li #Statement.setQueryTimeout() is now supported. @changelog_1122_li #New session setting QUERY_TIMEOUT, and new system property h2.maxQueryTimeout. @changelog_1123_li #Changing the transaction log level (SET LOG) is now written to the trace file by default. @changelog_1124_li #In a SQL script, primary key constraints are now ordered before foreign key constraints. @changelog_1125_li #It was not possible to create a referential constraint to a table in a different schema in some situations. @changelog_1126_li #The H2 Console was slow when the database contains many tables. Now the column names are not shown in this case. @changelog_1127_h2 #Version 1.0.66 (2008-02-02) @changelog_1128_li #There is a new online error analyzer tool. @changelog_1129_li #H2 Console: stack traces are now links to the source code in the source repository (H2 database only). @changelog_1130_li #CHAR data type equals comparison was case insensitive instead of case sensitive. @changelog_1131_li #The exception 'Value too long for column' now includes the data. @changelog_1132_li #The table name was missing in the documentation of CREATE INDEX. @changelog_1133_li #Better support for IKVM (www.ikvm.net): the H2 Console now opens a browser window. @changelog_1134_li #The cache size was not correctly calculated for tables with large objects (specially if compression is used). This could lead to out-of-memory exceptions. @changelog_1135_li #The exception "Hexadecimal string contains non-hex character" was not always thrown when it should have been. Fixed. @changelog_1136_li #The H2 Console now provides a link to the documentation when an error occurs (H2 databases only so far). @changelog_1137_li #The acting as PostgreSQL server, when a base directory was set, and the H2 Console was started as well, the base directory was applied twice. @changelog_1138_li #Calling EXTRACT(HOUR FROM ...) or EXTRACT(HH FROM ...) returned the wrong values (0 to 11 instead of 0 to 23). All other tested databases return values from 0 to 23. Please check if your application relies on the old behavior before upgrading. @changelog_1139_li #For compatibility with other databases the column default (COLUMN_DEF) for columns without default is now null (it was an empty string). @changelog_1140_li #Statements that contain very large subqueries (where the subquery result does not fit in memory) are now faster. @changelog_1141_li #Variables: large objects (CLOB and BLOB) that don't fit in memory did not work correctly when used as variables. @changelog_1142_li #Fulltext search is now supported in named in-memory databases. @changelog_1143_li #H2 Console: multiple consecutive spaces in the setting name did not work. Fixed. @changelog_1144_h2 #Version 1.0.65 (2008-01-18) @changelog_1145_li #The build (ant) now automatically switches the source code to the correct version (JDK 1.4/1.5 or 1.6). @changelog_1146_li #A recovery bug has been fixed. With older versions, it was necessary to add ;RECOVER=1 to the database URL in cases where it should not have been required. @changelog_1147_li #The performance for DROP and DROP ALL OBJECTS has been improved. @changelog_1148_li #The ChangePassword API has been improved. @changelog_1149_li #User defined variables are now supported. Examples: SET @VAR=10;CALL @VAR. This can be used for running totals as in: select x, set(@t, ifnull(@t, 0) + x) from system_range(1, 10) @changelog_1150_li #The Ukrainian translation has been improved. @changelog_1151_li #CALL statements can now be used in batch updates and called using Statement.executeUpdate. @changelog_1152_li #New read-only setting CREATE_BUILD (the build number of the database engine that created the database). @changelog_1153_li #The optimizer did not use multi column indexes for range queries in some cases. Fixed. @changelog_1154_li #The H2 Console now calls DataSource.getConnection() instead of DataSource.getConnection(user, password) when user name and password are not specified. @changelog_1155_li #The bind IP address can now be set when using multi-homed host (if multiple network adapters are available) using the system property h2.bindAddress. @changelog_1156_li #Batch update: Calling BatchUpdateException.printStackTrace() could result in out of memory. Fixed. @changelog_1157_li #Indexes of unique or foreign constraints where not dropped when the constraint was dropped after altering the table (for example dropping a column). Fixed. @changelog_1158_li #The performance for large result sets in the server mode has been improved. @changelog_1159_li #The setting h2.serverSmallResultSetSize has been renamed to h2.serverResultSetFetchSize. @changelog_1160_li #The SCRIPT command now uses multi-row insert statements to save space except if the option SIMPLE is used. @changelog_1161_li #The SCRIPT command did not split up CLOB data correctly. Fixed. @changelog_1162_li #Optimization for single column distinct queries with an index: select distinct name from test. Can be disabled by setting the system property h2.optimizeDistinct to false. @changelog_1163_li #DROP ALL OBJECTS did not drop user defined aggregate functions and domains. @changelog_1164_li #PostgreSQL compatibility: COUNT(T.*) is now supported. @changelog_1165_li #LIKE comparisons are now faster. @changelog_1166_li #Encrypted databases are now faster. @changelog_1167_h2 #Version 1.0.64 (2007-12-27) @changelog_1168_li #3-way union queries with prepared statement or views could return the wrong results. Fixed. @changelog_1169_li #The PostgreSQL ODBC driver did not work in the last release due to a parser regression. Fixed. @changelog_1170_li #CSV tool: some escape/separator character combinations did not work. Fixed. @changelog_1171_li #CSV tool: the character # could not be used as a separator when reading. @changelog_1172_li #Recovery: when the index file is corrupt, now the database deletes it and re-creates it automatically. @changelog_1173_li #The MVCC mode did not work well with in-memory databases. Fixed. @changelog_1174_li #The FTP server now supports a event listener. Thanks Fulvio Biondi for the help! @changelog_1175_li #New system function CANCEL_SESSION to cancel the currently executing statement of another session. @changelog_1176_li #The database now supports an exclusive mode. In exclusive mode, new connections are rejected. @changelog_1177_li #H2 Console: when editing result sets, columns can now be set to null. The text 'null' must be escaped using '=null'. @changelog_1178_li #New built-in functions RPAD and LPAD. @changelog_1179_li #New meta data table INFORMATION_SCHEMA.SESSIONS and LOCKS to get information about active connections and locks. Admins will see all connections, non-admins only their own session. @changelog_1180_li #The Ukrainian translation was not working in the last release. Fixed. @changelog_1181_li #Creating many tables (many hundreds) was slow. Fixed. @changelog_1182_li #Opening a database with many indexes (thousands) was slow. Fixed. @changelog_1183_li #H2 Console / autocomplete: Ctrl+Space now shows the list in all modes. @changelog_1184_li #The method Trigger.init has been changed: the parameters 'before' and 'type', have been added to the init method. @changelog_1185_li #The performance has been improved for ResultSet methods with column name. @changelog_1186_li #A stack trace was thrown if the system did not provide a quick secure random source and if there is no network or the network settings are not configured. Fixed. @changelog_1187_li #The H2 Console has been translated to Turkish. Thanks a lot to Ridvan Agar! @changelog_1188_li #Improved debugging support: toString methods of most object now return a meaningful text. @changelog_1189_li #The classes DbStarter and WebServlet have been moved to src/main. @changelog_1190_li #The column INFORMATION_SCHEMA.TRIGGERS.SQL now contains the CREATE TRIGGER statement. @changelog_1191_li #Loading classes and calling methods can be restricted using the new system property h2.allowedClasses. @changelog_1192_li #The database could not be used in Java applets due to security exceptions. Fixed. @changelog_1193_h2 #Version 1.0.63 (2007-12-02) @changelog_1194_li #The SecurePassword example has been improved. @changelog_1195_li #In time zones where the summer time saving limit is at midnight, some dates do not work in some virtual machines, for example 2007-10-14 in Chile, using the Sun JVM 1.6.0_03-b05. Fixed. @changelog_1196_li #The native fulltext search was not working properly after re-connecting. @changelog_1197_li #Improved FTP server: now the PORT command is supported. @changelog_1198_li #Temporary views (FROM(...)) with UNION didn't work if nested. Fixed. @changelog_1199_li #Performance optimization for IN(...) and IN(SELECT...), currently disabled by default. To enable, use java -Dh2.optimizeInJoin=true @changelog_1200_li #The H2 Console has been translated to Ukrainian by Igor Dobrovolskyi. Thanks a lot! @changelog_1201_li #New function TABLE_DISTINCT. @changelog_1202_li #Using LIMIT with values close to Integer.MAX_VALUE didn't work correctly. @changelog_1203_li #Certain setting in the Server didn't work (http://code.google.com/p/h2database/issues/detail?id=7). @changelog_1204_h2 #Version 1.0.62 (2007-11-25) @changelog_1205_li #Large updates and deletes are now supported by buffering data to disk if required. The threshold is currently set to 100'000 bytes and can be changed using SET MAX_OPERATION_MEMORY or using by appending ;MAX_OPERATION_MEMORY=.. to the database URL. See also the docs. @changelog_1206_li #MVCC: now an exception is thrown when an application tries to change the MVCC setting while the database is already open. @changelog_1207_li #Referential integrity checks didn't lock the referenced table, and thus could read uncommitted rows of other connections. In that way the referential constraints could get violated (except when using MVCC). @changelog_1208_li #Renaming or dropping a user with a schema, or removing the admin property of that user made the schema inaccessible after re-opening the database. Fixed. @changelog_1209_li #The H2 Console now also support the command line option -ifExists when started from the Server tool, but only when connecting to H2 databases. @changelog_1210_li #Duplicate column names were not detected when renaming columns. Fixed. @changelog_1211_li #The console did not display multiple embedded spaces in text correctly. Fixed. @changelog_1212_li #Google Android support: use 'ant codeswitchAndroid' to switch the source code to Android. @changelog_1213_li #Values of type ARRAY are now sorted as in PostgreSQL. @changelog_1214_li #In the cluster mode, could not connect if only one server was running (last release only). Fixed. @changelog_1215_li #The performance of large CSV operations has been improved. @changelog_1216_li #Now using custom toString() for most JDBC objects and commands. @changelog_1217_li #Nested temporary views (SELECT * FROM (SELECT ...)) with parameters didn't work in some cases. Fixed. @changelog_1218_li #CSV: Using an empty field delimiter didn't work (a workaround was using char(0)). Fixed. @changelog_1219_li #A patch for Apache DDL Utils is available at https://issues.apache.org/jira/browse/DDLUTILS-185 @changelog_1220_li #The default value for h2.emergencySpaceInitial is now 256 KB (to speed up creating encrypted databases) @changelog_1221_li #Eduardo Velasques has translated the H2 Console and the error messages to Brazilian Portuguese. Thanks a lot! @changelog_1222_li #Creating a table from GROUP_CONCAT didn't work if the data was longer than 255 characters @changelog_1223_h2 #Version 1.0.61 (2007-11-10) @changelog_1224_li #The Lucene Fulltext implementation is now compiled and included in the h2.jar. Requires Lucene 2.2. @changelog_1225_li #Added more tests. The code coverage is now at 83%. @changelog_1226_li #ResultSetMetaData.getColumnDisplaySize was calculated as the longest display size for the given result set, but should be the maximum size that fits in the column. Fixed. @changelog_1227_li #The MODE used to be a global setting, now it is a database level setting. @changelog_1228_li #The database does now always round to the nearest number when converting a floating point to a integer: CAST(1.5 AS INT) will now result in 2, like in PostgreSQL and MySQL. @changelog_1229_li #Math operations using unknown data types (for example -? and ?+?) are now interpreted as decimal. @changelog_1230_li #INSTR, LOCATE: backward searching is not supported by using a negative start position. @changelog_1231_li #Can now open a database stored in a jar or zip file (for example, jdbc:h2:zip:c:/temp/h2.zip!/test). @changelog_1232_li #Files access now uses an API (FileSystem, FileObject), this will simplify adding other file systems and features (for example replication). @changelog_1233_li #Vlad Alexahin has translated H2 Console to Russian. Thanks a lot! @changelog_1234_li #Descending indexes are now supported. This is useful when sorting columns descending, for example by creation date. @changelog_1235_li #Solved a Java level deadlock in the DatabaseCloser. @changelog_1236_li #CREATE SEQUENCE: New option CACHE (number of pre-allocated numbers). New column CACHE in the sequence meta data table. The default cache size is still 32. @changelog_1237_li #MVCC: The system property h2.mvcc has been removed. A few bugs have been fixed, and new tests have been added. @changelog_1238_h2 #Version 1.0.60 (2007-10-20) @changelog_1239_li #JdbcXAConnection: starting a transaction before getting the connection didn't switch off autocommit. @changelog_1240_li #User defined aggregate functions are not supported. @changelog_1241_li #Server.shutdownTcpServer was blocked when first called with force=false and then force=true. Now documentation is improved, and it is no longer blocked. @changelog_1242_li #Stack traces did not include the SQL statement in all cases where they could have. Also, stack traces with SQL statement are now shorter. @changelog_1243_li #Linked tables: now tables in non-default schemas are supported as well @changelog_1244_li #New Italian translation from PierPaolo Ucchino. Thanks a lot! @changelog_1245_li #CSV: New methods to set the escape character and field delimiter in the Csv tool and the CSVWRITE and CSVREAD methods. @changelog_1246_li #Prepared statements could not be used after data definition statements (creating tables and so on). Fixed. @changelog_1247_li #PreparedStatement.setMaxRows could not be changed to a higher value after the statement was executed. @changelog_1248_li #The H2 Console could not connect twice to the same H2 embedded database at the same time. Fixed. @changelog_1249_li #CSVREAD, RUNSCRIPT and so on now support URLs as well, using URL.openStream(). Example: select * from csvread('jar:file:///c:/temp/test.jar!/test.csv'); @changelog_1250_h2 #Version 1.0.59 (2007-10-03) @changelog_1251_li #When the data type was unknown in a subquery, sometimes the wrong exception (ArrayIndexOutOfBounds) was thrown. Fixed. @changelog_1252_li #If the process was killed while the database was running, sometimes the database could not be opened ('double allocation') except when the system property h2.check was set to false. Fixed. @changelog_1253_li #Multi-threaded kernel (MULTI_THREADED=1): A synchronization problem has been fixed. @changelog_1254_li #A PreparedStatement that was cancelled could not be reused. Fixed. @changelog_1255_li #H2 Console: Progress information when logging into a H2 embedded database (useful when opening a database is slow). @changelog_1256_li #When the database was closed while logging was disabled (LOG 0), re-opening the database was slow. Fixed. @changelog_1257_li #Fulltext search is now documented (in the Tutorial). @changelog_1258_li #The Console did not refresh the table list if the CREATE TABLE statement started with a comment. Fixed. @changelog_1259_li #When creating a table using CREATE TABLE .. AS SELECT, the precision for some data types (for example VARCHAR) was set to the default precision. Fixed. @changelog_1260_li #When using the (undocumented) in-memory file system (jdbc:h2:memFS:x or jdbc:h2:memLZF:x), and using multiple connections, a ConcurrentModificationException could occur. Fixed. @changelog_1261_li #REGEXP compatibility: So far String.matches was used, but for compatibility with MySQL, now Matcher.find is used. @changelog_1262_li #SCRIPT: the SQL statements in the result set now include the terminating semicolon as well. Simplifies copy and paste. @changelog_1263_li #When using a subquery with group by as a table, some columns could not be used in the where condition in the outer query. Example: SELECT * FROM (SELECT ID, COUNT(*) C FROM TEST) WHERE C > 100. Fixed. @changelog_1264_li #Views with subqueries as tables and queries with nested subqueries as tables did not always work. Fixed. @changelog_1265_li #Compatibility: comparing columns with constants that are out of range does not throw an exception. @changelog_1266_h2 #Version 1.0.58 (2007-09-15) @changelog_1267_li #System.exit is no longer called by the WebServer, the Console and the Server tool (except to set the exit code if required). This is important when using OSGi. @changelog_1268_li #Optimization for independent subqueries. For example, this query can now an index: SELECT * FROM TEST WHERE ID = (SELECT MAX(ID) FROM TEST) This can be disabled by setting the system property h2.optimizeSubqueryCache to false. @changelog_1269_li #The explain plan now says: /* direct lookup query */ if the query can be processed directly without reading rows, for example when using MIN(indexed column), MAX(indexed column), or COUNT(*). @changelog_1270_li #When using IFNULL, NULLIF, COALESCE, LEAST, or GREATEST, and the first parameter was ?, an exception was thrown. Now the highest data type of all parameters is used. @changelog_1271_li #When comparing TINYINT or SMALLINT columns against constants, the index was not used. Fixed. @changelog_1272_li #Maven 2: new version are now automatically synced with the central repositories. @changelog_1273_li #The default value for MAX_MEMORY_UNDO is now 100000. @changelog_1274_li #The documentation indexer does no longer index Japanese pages. If somebody knows how to split Japanese into words please post it. @changelog_1275_li #Oracle compatibility: SYSDATE now returns a timestamp. CHR(..) is now an alias for CHAR(..). @changelog_1276_li #After deleting data, empty space in the database files was not efficiently reused (but it was reused when opening the database). This has been fixed. @changelog_1277_li #About 230 bytes per database was leaked. This is a problem for applications opening and closing many thousand databases. The main problem: a shutdown hook was added but never removed. Fixed. In JDK 1.4, there is <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4197876">an additionally problem</a> . A workaround has been implemented. @changelog_1278_li #Optimization for COLUMN IN(.., NULL) if the column does not allow NULL values. @changelog_1279_li #Using spaces in column and table aliases was not supported when used inside a view or temporary view. @changelog_1280_li #The version (build) number is now included in the manifest file. @changelog_1281_li #In some systems, SecureRandom.generateSeed is very slow (taking one minute or more). For those cases, an alternative method is used that takes less than one second. @changelog_1282_li #The database file sizes are now increased at most 32 MB at any time. @changelog_1283_li #New method DatabaseEventListener.opened that is called just after opening a database. @changelog_1284_li #When using the Console with Internet Explorer 6.0 or 7.0, a Javascript error was thrown after clearing the query. @changelog_1285_li #A database can now be opened even if class of a user defined function is not in the classpath. Trying to call the function will throws an exception. @changelog_1286_li #User defined functions and constants may not overload built-in functions and constants. This didn't work before, but now trying to create such an object will fail. @changelog_1287_li #Improved MultiDimension tool (for spatial queries): in the last few releases the tool was actually slower than using a regular query (because index lookup got faster, and because the tool didn't support prepared statements) Now the tool generates prepared statements, and the performance is better again (about 5 times faster for a reasonable amount of data). @changelog_1288_li #Adding a foreign key or when re-enabling referential integrity for a table failed when checking was enabled and the reference contained NULL. @changelog_1289_li #For PgServer, character encoding other than UTF-8 did not work correctly. Fixed. @changelog_1290_li #Using a function in a GROUP BY expression that is used in a view as a condition did not always work. @changelog_1291_h2 #Version 1.0.57 (2007-08-25) @changelog_1292_li #New experimental feature MVCC (multi version concurrency control). Can be set as a option when opening the database (jdbc:h2:~/test;MVCC=TRUE) or as a system property (-Dh2.mvcc=true). This is work-in-progress, use it at your own risk. Feedback is welcome. @changelog_1293_li #The version number is now major.minor.micro where micro is the build number. Not all version are public, so there may be gaps in the micro. The minor changes when there is a file format change. @changelog_1294_li #The backup tool (org.h2.tools.Backup) did not work. The restore tool did not work when the -db parameter was used. Fixed. The documentation of the backup tool has been changed: only one database may be backed up at any time. @changelog_1295_li #Opening large read-only databases was very slow. Fixed. @changelog_1296_li #New Japanese translation of the error messages thanks to Ikemoto Masahiro. Thanks a lot! @changelog_1297_li #Disabling / enabling referential integrity for a table can now be used inside a transaction. @changelog_1298_li #Rights checking for dynamic tables (SELECT * FROM (SELECT ...)) did not work. Fixed. @changelog_1299_li #Creating more than 10 views that depend on each other was very slow. Reconnecting was slow as well. Fixed. @changelog_1300_li #When used as as Servlet, the H2 Console did not work with SSL (using Tomcat). Fixed. @changelog_1301_li #When altering a table with foreign key constraint, if there was no manual index created for the referenced columns, the automatically created index was dropped while still being used. Fixed. @changelog_1302_li #Check and foreign key constraints now checks if the existing data is consistent (this can be disabled by appending NOCHECK). It is also possible to check existing data when re-enabling referential integrity for a table. @changelog_1303_li #Some unit tests failed on Linux because the file system works differently. The unit tests are fixed and should work now. @changelog_1304_li #Can now incrementally translate the documentation. See also FAQ. @changelog_1305_li #Improved error messages: some tools can't show the root cause of an exception. Adding the message of the root cause to the message of the thrown exception now where it makes sense. @changelog_1306_li #The H2 Console can now connect to databases using JNDI. The driver class name must be a javax.naming.Context, (for example javax.naming.InitialContext), and the URL the resource name (for example java:comp/env/jdbc/Test). This should also work for linked tables. @changelog_1307_li #Google translate did not work for the H2 homepage. It should be fixed now. @changelog_1308_li #The CONVERT function did not work with views when using UNION. @changelog_1309_li #The build now issues a warning if the source code is switched to the wrong version. @changelog_1310_li #The default lock mode is now read committed instead of serialized. @changelog_1311_li #PG server: data was truncated when reading large VARCHAR columns and decimal columns. @changelog_1312_li #PG server: when the same database was accessed multiple times using the PostgreSQL ODBC driver, the pg_catalog schema update failed, and connecting to the database was not possible. Fixed. @changelog_1313_li #Some file operations didn't work for files in the root directory. Fixed. @changelog_1314_li #In the Restore tool, the parameter -file did not work. Fixed. @changelog_1315_li #Two-phase commit: commit with transaction name was only supported in the recovery scan. Now it is always supported. @changelog_1316_li #The column name C_CURRENT_TIMESTAMP did not work in the last release. @changelog_1317_li #OpenOffice compatibility: support database name in column names. @download_1000_h1 ダウンロード @download_1001_h3 #Version 1.0.73 (2008-05-31, Current) @download_1002_a Windows Installer @download_1003_a Platform-Independent Zip @download_1004_h3 #Version 1.0.72 (2008-05-10, Last Stable) @download_1005_a Windows Installer @download_1006_a Platform-Independent Zip @download_1007_h3 #Download Mirror and Older Versions @download_1008_a Platform-Independent Zip @download_1009_h3 サブバージョンのソースリポジトリ @download_1010_a Google Code @download_1011_p #For details about changes, see the <a href="changelog.html">Change Log</a> . @faq_1000_h1 F A Q @faq_1001_a #Are there Known Bugs? When is the Next Release? @faq_1002_a このデータベースエンジンはオープンソースですか? @faq_1003_a #My Query is Slow @faq_1004_a 新規データベースの構築方法は? @faq_1005_a データベースへの接続方法は? @faq_1006_a データベースのファイルはどこに保存されますか? @faq_1007_a #What is the Size Limit (Maximum Size) of a Database? @faq_1008_a これは信頼できるデータベースですか? @faq_1009_a #Is the GCJ Version Stable? Faster? @faq_1010_a このプロジェクトの翻訳方法は? @faq_1011_h3 #Are there Known Bugs? When is the Next Release? @faq_1012_p #Usually, bugs get fixes as they are found. There is a release every few weeks. Here is the list of known and confirmed issues: @faq_1013_li ライトアウタージョイン(右外部結合)時に一部問題が発生。内部において、他の結合と組み合わせて使用される時、他のデータベースと同様に、常に同じ結果を引き起こすとは限らないレフトアウタージョイン(左外部結合)に変換される @faq_1014_h3 このデータベースエンジンはオープンソースですか? @faq_1015_p はい、H2DBはフリーウェアであり、再配布も可能です。ソースコードも含まれています。ライセンスページも合わせてご確認ください。 @faq_1016_h3 #My Query is Slow @faq_1017_p SELECT (または DELETE、UPDATE、MERGE) ステートメント実行に時間がかかるのはいくつかの理由が考えられます。以下のチェックリストをご確認ください: @faq_1018_li ANALYZEを実行する (詳細はドキュメントをご覧下さい) @faq_1019_li クエリにEXPLAINオプションを付けて実行し、インデックスが利用されているかどうか確認する (詳細はドキュメントをご覧下さい) @faq_1020_li 必要に応じてインデックスを追加し、ANALYZE、EXPLAINオプションを用いて再度クエリを実行する @faq_1021_li それでも解決しない場合は、ご連絡ください @faq_1022_h3 新規データベースの構築方法は? @faq_1023_p データベースがまだ存在しない場合、デフォルト設定では自動的に新規作成されます @faq_1024_h3 データベースへの接続方法は? @faq_1025_p データベースドライバは <code>org.h2.Driver</code> で、データベースURLは <code>jdbc:h2:</code> で始まります。JDBCを利用してデータベースに接続する場合は、以下のコードを利用して下さい: @faq_1026_h3 データベースのファイルはどこに保存されますか? @faq_1027_p jdbc:h2:~/test のようなデータベースURLを利用している場合は、データベースはユーザーディレクトリに保存されます。Windowsでは通常、C:\Documents and Settings\<ユーザー名> です。もしベースディレクトリが設定されていない場合 (jdbc:h2:test 内に)、データベースファイルはアプリケーションが起動されるディレクトリ (作業中のディレクトリ) に保存されます。スタートメニューからH2コンソールアプリケーションを起動している場合、[インストール先ディレクトリ]/bin下に保存されます。ベースディレクトリはデータベースURLで設定できます。絶対パス、または相対パスが利用できます。jdbc:h2:file:data/sample のURLを利用している場合、データベースはディレクトリデータの中に保存されます (現在作業中のディレクトリに関連します)。ディレクトリは必ず存在するものでなければいけません。また、完全に適切なディレクトリ名(Windows、ドライバ名)を利用することも可能です。例: jdbc:h2:file:C:/data/test @faq_1028_h3 #What is the Size Limit (Maximum Size) of a Database? @faq_1029_p 理論上のデータの制限は現在256GBです。これはBLOBとCLOBデータを含まない状態での値です: BLOB、CLOBの最大値はそれぞれ256GB以上の設定が可能です。インデックスデータのサイズ制限も同様に256GBです。 @faq_1030_p FAT、FAT32ファイルシステムの最大ファイルサイズは4GBです。よって、FATやFAT32を利用する場合は、データの制限は4GBということになります。 @faq_1031_h3 これは信頼できるデータベースですか? @faq_1032_p #That is not easy to say. It is still a quite new product. A lot of tests have been written, and the code coverage of these tests is very high. Randomized stress tests are run regularly. But as this is a relatively new product, there are probably some problems that have not yet been found. Areas that are not fully tested: @faq_1033_li WindowsXP以外のプラットフォーム、及びSUN JVM1.4、1.5での動作確認 @faq_1034_li #The MVCC (multi version concurrency) mode @faq_1035_li #The persistent linear hash index @faq_1036_li クラスタモード、2フェーズコミット、セーブポイント @faq_1037_li マルチスレッドと複数接続の利用 @faq_1038_li 24/7オペレーション、大容量データベース (500MB以上) @faq_1039_li Updatable result sets @faq_1040_li 参照整合性とCHECK制約、トリガー @faq_1041_li ALTER TABLE ステートメント、ビュー、リンクテーブル、スキーマ、UNION @faq_1042_li すべての組み込み関数が完全にテストされたわけではありません @faq_1043_li オプティマイザが必ずしも最良を選択するとは限らない @faq_1044_li データ型 BLOB、CLOB、VARCHAR_IGNORECASE、OTHER @faq_1045_li サーバーモード(十分にテストはしてありますが、組み込みモードほどではありません) @faq_1046_li 大きなVARCHAR、VARBINARYカラム、または多数のカラムによる幅の広いインデックス @faq_1047_p 試験的に考慮された箇所は以下の通り: @faq_1048_li #The PostgreSQL server @faq_1049_li ライナーハッシュインデックス @faq_1050_li 他のデータベースとの互換モード (一部の特徴のみ提供される) @faq_1051_li #The ARRAY data type and related functionality @faq_1052_h3 #Is the GCJ Version Stable? Faster? @faq_1053_p GCJバージョンは、Javaバージョンほどは安定していません。GCJバージョンでリグレッションテストを実行した時、アプリケーションはランダムポイントと思われるところで、エラーメッセージなしで停止する場合があります。現在、GCJバージョンはSun VMの使用時よりも低速です。しかし、GCJバージョンの起動はVM使用時よりも高速です。 @faq_1054_h3 このプロジェクトの翻訳方法は? @faq_1055_p #For more information, see <a href="build.html#translating">Build/Translating</a> . @features_1000_h1 特徴 @features_1001_a 特徴一覧 @features_1002_a #Limitations @features_1003_a 他のデータベースエンジンと比較する @features_1004_a #H2 in Use @features_1005_a 接続モード @features_1006_a データベースURL概要 @features_1007_a メモリオンリーデータベース @features_1008_a 暗号化ファイルと共にデータベースへ接続する @features_1009_a データベースファイルロック @features_1010_a すでに存在する場合のみ、データベースを開く @features_1011_a データベースを終了する @features_1012_a ログインデックスの修正 @features_1013_a カスタムファイル アクセスモード @features_1014_a 複数の接続 @features_1015_a データベースファイルレイアウト @features_1016_a ログとリカバリー @features_1017_a 互換性 @features_1018_a トレースオプションを使用する @features_1019_a #Using Other Logging APIs @features_1020_a 読み取り専用データベース @features_1021_a #Read Only Databases in Zip or Jar File @features_1022_a バイナリーとテキストストレージフォーマット @features_1023_a ディスクスペースが少ない状況での正しい取り扱い @features_1024_a computed column / ベースインデックスの機能 @features_1025_a 多次元インデックス @features_1026_a パスワードを使用する @features_1027_a ユーザー定義の関数とストアドプロシージャ @features_1028_a トリガー @features_1029_a データベースをコンパクトにする @features_1030_a キャッシュの設定 @features_1031_h2 特徴一覧 @features_1032_h3 主な特徴 @features_1033_li 非常に高速なデータベースエンジン @features_1034_li 無料、ソースコード付き @features_1035_li Javaで記載 @features_1036_li 標準規格のSQL、JDBC APIをサポート @features_1037_li エンベッドモードとサーバーモード、クラスタリングをサポート @features_1038_li 強力なセキュリティ機能 @features_1039_li #The PostgreSQL ODBC driver can be used @features_1040_li #Multi version concurrency @features_1041_h3 追加された特徴 @features_1042_li ディスクベースデータベース、またはインメモリデータベースと、テーブル、読み取り専用データベースをサポート、テンポラリテーブル @features_1043_li トランザクションをサポート (トランザクション分離の serializable (直列化))、2フェーズコミット @features_1044_li 複数の接続、テーブルレベルのロック @features_1045_li コストベースオプティマイザ、複雑なクエリーのために遺伝的アルゴリズムを使用、zero-administration @features_1046_li スクロール可能result setと更新可能result setをサポート、大きなresult set、外部結果ソート、 関数はresult setを返す @features_1047_li 暗号化されたデータベース (AES または XTEA), SHA-256 パスワード暗号化、暗号化関数、SSL @features_1048_h3 SQLサポート @features_1049_li 複数のスキーマ、インフォメーションスキーマをサポート @features_1050_li 参照整合性 / カスケードでの外部キー制約、チェック制約 @features_1051_li 内部結合と外部結合、サブクエリー、読み取り専用ビューとインラインビュー @features_1052_li トリガーと Java関数 / ストアドプロシージャ @features_1053_li 多数の組み込み関数、XMLとlossless data compression (可逆圧縮) を含む @features_1054_li 大きなオブジェクト (BLOB/CLOB) とArrayを含む、広い範囲のデータ型 @features_1055_li シーケンスとautoincrement column、computed column、(関数ベースのインデックスに使用できます) @features_1056_li ORDER BY, GROUP BY, HAVING, UNION, LIMIT, TOP @features_1057_li Collationをサポート、users、roles @features_1058_li HSQLDB、MySQLとPostgreSQLのための互換モード @features_1059_h3 セキュリティの特徴 @features_1060_li SQLインジェクション問題の解決を含む @features_1061_li SHA-256とsaltを使ってユーザーパスワードが本物であることを証明する @features_1062_li ユーザーパスワードは決してプレーンテキストでネットワーク上に送信されることはない (たとえ不安定な接続を使用していたとしても) @features_1063_li AES-256とXTEA暗号化アルゴリズムを使用することで、全てのデータベースファイル (データのバックアップを取るのに使用できるスクリプトファイルを含む) を暗号化できる @features_1064_li リモートJDBCドライバは、SSL/TLS上のTCP/IP接続をサポート @features_1065_li 組み込みwebサーバーは、SSL/TLS上の接続をサポート @features_1066_li Stringの代わりにchar arrayを使うことで、パスワードをデータベースに送信可能 @features_1067_h3 他の特徴とツール @features_1068_li 省スペース (1MBより小さい)、少ないメモリが必要条件 @features_1069_li #Multiple index types (b-tree, tree, hash) @features_1070_li 多次元のインデックスをサポート @features_1071_li CSV (comma separated values) ファイルサポート @features_1072_li リンクテーブルと組み込み仮想 "range" テーブルのサポート @features_1073_li EXPLAIN PLANをサポート、 洗練されたトレースオプション @features_1074_li パフォーマンスを向上させるために、データベースの終了を遅らせるか割り込みを抑制する @features_1075_li Webベースのコンソールアプリケーション (英語、ドイツ語、部分的にフランス語とスペイン語) が自動完備 @features_1076_li データベースはSQLスクリプトファイルを生成 @features_1077_li データファイルのコンテンツを移動することができるリカバリーツールを含む @features_1078_li #Support for variables (for example to calculate running totals) @features_1079_li prepared statementの自動再編集 @features_1080_li 少数のデータベースファイル、バイナリー、テキストストレージ形式を使用、ディスクスペースが少ない状況での正しい取り扱い @features_1081_li 各レコードのためのチェックサムと、データ整合性のためのログエントリーを使用 @features_1082_li 十分なテスト済み (高いコードカバー率、ランダムストレステスト) @features_1083_h2 #Limitations @features_1084_p #For the list of limitations, please have a look at the road map page at: <a href="http://groups.google.com/group/h2-database/web/roadmap">http://groups.google.com/group/h2-database/web/roadmap</a> @features_1085_h2 他のデータベースエンジンと比較する @features_1086_th 特徴 @features_1087_th H2 @features_1088_th Derby @features_1089_th HSQLDB @features_1090_th MySQL @features_1091_th PostgreSQL @features_1092_td Pure Java @features_1093_td 対応 @features_1094_td 対応 @features_1095_td 対応 @features_1096_td 非対応 @features_1097_td 非対応 @features_1098_td エンベッドモード (Java) @features_1099_td 対応 @features_1100_td 対応 @features_1101_td 対応 @features_1102_td 非対応 @features_1103_td 非対応 @features_1104_td パフォーマンス (エンベッド) @features_1105_td 速い @features_1106_td 遅い @features_1107_td 速い @features_1108_td 該当なし @features_1109_td 該当なし @features_1110_td #In-Memory Mode @features_1111_td 対応 @features_1112_td 非対応 @features_1113_td 対応 @features_1114_td 非対応 @features_1115_td 非対応 @features_1116_td トランザクション分離 @features_1117_td 対応 @features_1118_td 対応 @features_1119_td 非対応 @features_1120_td 対応 @features_1121_td 対応 @features_1122_td コストベースオプティマイザ @features_1123_td 対応 @features_1124_td 対応 @features_1125_td 非対応 @features_1126_td 対応 @features_1127_td 対応 @features_1128_td クラスタリング @features_1129_td 対応 @features_1130_td 非対応 @features_1131_td 非対応 @features_1132_td 対応 @features_1133_td 対応 @features_1134_td 暗号化データベース @features_1135_td 対応 @features_1136_td 対応 @features_1137_td 非対応 @features_1138_td 非対応 @features_1139_td 非対応 @features_1140_td リンクテーブル @features_1141_td 対応 @features_1142_td 非対応 @features_1143_td #Partially *1 @features_1144_td #Partially *2 @features_1145_td 非対応 @features_1146_td ODBCドライバ @features_1147_td 対応 @features_1148_td #Yes? @features_1149_td 非対応 @features_1150_td 対応 @features_1151_td 対応 @features_1152_td フルテキストサーチ @features_1153_td 対応 @features_1154_td 非対応 @features_1155_td 非対応 @features_1156_td 対応 @features_1157_td 対応 @features_1158_td #User-Defined Datatypes @features_1159_td 対応 @features_1160_td 非対応 @features_1161_td 非対応 @features_1162_td 対応 @features_1163_td 対応 @features_1164_td データベースごとのファイル @features_1165_td 少 @features_1166_td 多 @features_1167_td 少 @features_1168_td 多 @features_1169_td 多 @features_1170_td テーブルレベルロック @features_1171_td 対応 @features_1172_td 対応 @features_1173_td 非対応 @features_1174_td 対応 @features_1175_td 対応 @features_1176_td #Row Level Locking @features_1177_td 非対応 @features_1178_td 対応 @features_1179_td 非対応 @features_1180_td 対応 @features_1181_td 対応 @features_1182_td #Multi Version Concurrency @features_1183_td 対応 @features_1184_td 非対応 @features_1185_td 非対応 @features_1186_td 非対応 @features_1187_td 対応 @features_1188_td #Role Based Security @features_1189_td 対応 @features_1190_td #Yes *3 @features_1191_td 対応 @features_1192_td 対応 @features_1193_td 対応 @features_1194_td #Updatable Result Sets @features_1195_td 対応 @features_1196_td 対応 @features_1197_td 非対応 @features_1198_td 対応 @features_1199_td 対応 @features_1200_td #Sequences @features_1201_td 対応 @features_1202_td 非対応 @features_1203_td 対応 @features_1204_td 非対応 @features_1205_td 対応 @features_1206_td #Limit and Offset @features_1207_td 対応 @features_1208_td 非対応 @features_1209_td 対応 @features_1210_td 対応 @features_1211_td 対応 @features_1212_td #Temporary Tables @features_1213_td 対応 @features_1214_td #Yes *4 @features_1215_td 対応 @features_1216_td 対応 @features_1217_td 対応 @features_1218_td #Custom Aggregate Functions @features_1219_td 対応 @features_1220_td 非対応 @features_1221_td 非対応 @features_1222_td 対応 @features_1223_td 対応 @features_1224_td フットプリント (jar/dll size) @features_1225_td #~1 MB *5 @features_1226_td #~2 MB @features_1227_td #~600 KB @features_1228_td #~4 MB @features_1229_td #~6 MB @features_1230_p #*1 HSQLDB supports text tables. @features_1231_p #*2 MySQL supports linked MySQL tables under the name 'federated tables'. @features_1232_p #*3 Derby support for roles based security and password checking as an option. @features_1233_p #*4 Derby only supports global temporary tables. @features_1234_p #*5 The default H2 jar file contains debug information. @features_1235_h3 DerbyとHSQLDB @features_1236_p 予期しない過程での終了後 (例:電源異常)、H2はユーザーの相互作用なしで安全に、自動的に回復することができます。DerbyとHSQLDBでは、いくつかの手動のステップが必要とされます ('Another instance of Derby may have already booted the database' / 'The database is already in use by another process')。 @features_1237_h3 DaffodilDbとOne$Db @features_1238_p このデータベースの開発は止まっているようです。最後のリリースは2006年2月でした。 @features_1239_h3 McKoi @features_1240_p このデータベースの開発は止まっているようです。最後のリリースは2004年8月でした。 @features_1241_h2 #H2 in Use @features_1242_p #For a list of applications that work with or use H2, see: <a href="links.html">Links</a> . @features_1243_h2 接続モード @features_1244_p 以下の接続モードがサポートされています: @features_1245_li #Embedded mode (local connections using JDBC) @features_1246_li #Remote mode (remote connections using JDBC or ODBC over TCP/IP) @features_1247_li #Mixed mode (local and remote connections at the same time) @features_1248_h3 エンベッドモード @features_1249_p #In embedded mode, an application opens a database from within the same JVM using JDBC. This is the fastest and easiest connection mode. The disadvantage is that a database may only be open in one virtual machine (and class loader) at any time. As in all modes, both persistent and in-memory databases are supported. There is no limit on the number of database open concurrently, or on the number of open connections. @features_1250_h3 #Remote Mode @features_1251_p #When using the remote mode (sometimes called client/server mode), an application opens a database remotely using the JDBC or ODBC API. A server needs to be started within the same or another virtual machine (or on another computer). Many applications can connect to the same database at the same time. The remote mode is slower than the embedded mode, because all data is transferred over TCP/IP. As in all modes, both persistent and in-memory databases are supported. There is no limit on the number of database open concurrently, or on the number of open connections. @features_1252_h3 #Mixed Mode @features_1253_p #The mixed mode is a combination of the embedded and the remote mode. The main application connects to a database in embedded mode, but also starts a server so that other applications (running in different virtual machines) can concurrently access the same data. @features_1254_h2 データベースURL概要 @features_1255_p #This database supports multiple connection modes and connection settings. This is achieved using different database URLs. Settings in the URLs are not case sensitive. @features_1256_th トピック @features_1257_th URLフォーマットと例 @features_1258_td エンベッド (ローカル) 接続 @features_1259_td jdbc:h2:[file:][<path>]<databaseName> @features_1260_td jdbc:h2:~/test @features_1261_td jdbc:h2:file:/data/sample @features_1262_td jdbc:h2:file:C:/data/sample (Windowsのみ) @features_1263_td インメモリ (プライベート) @features_1264_td jdbc:h2:mem: @features_1265_td インメモリ (名付ける) @features_1266_td jdbc:h2:mem:<databaseName> @features_1267_td jdbc:h2:mem:test_mem @features_1268_td TCP/IPを使用したリモート @features_1269_td jdbc:h2:tcp://<server>[:<port>]/<databaseName> @features_1270_td #jdbc:h2:tcp://localhost/~/test @features_1271_td #jdbc:h2:tcp://dbserv:8084/~/sample @features_1272_td SSL/TLSを使用したリモート @features_1273_td jdbc:h2:ssl://<server>[:<port>]/<databaseName> @features_1274_td #jdbc:h2:ssl://secureserv:8085/~/sample; @features_1275_td 暗号化ファイルの使用 @features_1276_td jdbc:h2:<url>;CIPHER=[AES|XTEA] @features_1277_td #jdbc:h2:ssl://secureserv/~/testdb;CIPHER=AES @features_1278_td jdbc:h2:file:~/secure;CIPHER=XTEA @features_1279_td ファイルロックメソッド @features_1280_td jdbc:h2:<url>;FILE_LOCK={NO|FILE|SOCKET} @features_1281_td jdbc:h2:file:~/quickAndDirty;FILE_LOCK=NO @features_1282_td jdbc:h2:file:~/private;CIPHER=XTEA;FILE_LOCK=SOCKET @features_1283_td すでに存在する場合は起動のみ @features_1284_td jdbc:h2:<url>;IFEXISTS=TRUE @features_1285_td jdbc:h2:file:~/sample;IFEXISTS=TRUE @features_1286_td VMが終了した時、データベースを終了しない @features_1287_td jdbc:h2:<url>;DB_CLOSE_ON_EXIT=FALSE @features_1288_td ユーザー名、及びパスワード @features_1289_td jdbc:h2:<url>[;USER=<username>][;PASSWORD=<value>] @features_1290_td jdbc:h2:file:~/sample;USER=sa;PASSWORD=123 @features_1291_td ログインデックスの修正 @features_1292_td jdbc:h2:<url>;LOG=2 @features_1293_td jdbc:h2:file:~/sample;LOG=2 @features_1294_td デバックトレースの設定 @features_1295_td jdbc:h2:<url>;TRACE_LEVEL_FILE=<level 0..3> @features_1296_td jdbc:h2:file:~/sample;TRACE_LEVEL_FILE=3 @features_1297_td 未知の設定を無視 @features_1298_td jdbc:h2:<url>;IGNORE_UNKNOWN_SETTINGS=TRUE @features_1299_td カスタムファイル アクセスモード @features_1300_td jdbc:h2:<url>;ACCESS_MODE_LOG=rws;ACCESS_MODE_DATA=rws @features_1301_td インメモリ (プライベート) @features_1302_td jdbc:h2:mem: @features_1303_td #Database in or Zip File @features_1304_td #jdbc:h2:zip:<zipFileName>!/<databaseName> @features_1305_td #jdbc:h2:zip:~/db.zip!/test @features_1306_td 他の設定の変更 @features_1307_td jdbc:h2:<url>;<setting>=<value>[;<setting>=<value>...] @features_1308_td jdbc:h2:file:~/sample;TRACE_LEVEL_SYSTEM_OUT=3 @features_1309_h3 エンベッド (ローカル) データベースに接続 @features_1310_p #The database URL for connecting to a local database is <code>jdbc:h2:[file:][<path>]<databaseName></code> . The prefix <code>file:</code> is optional. If no or only a relative path is used, then the current working directory is used as a starting point. The case sensitivity of the path and database name depend on the operating system, however it is recommended to use lowercase letters only. The database name must be at least three characters long (a limitation of File.createTempFile). To point to the user home directory, use ~/, as in: jdbc:h2:~/test. @features_1311_h2 メモリオンリーデータベース @features_1312_p 特定の使用方法では (例: rapid prototyping、テスト、高パフォーマンスオペレーション、読み取り専用データベース)、データは持続する (変化する) 必要は全くないかもしれません。このデータベースは、データが持続しない際にメモリオンリーモードをサポートします。 @features_1313_p 一部ケースでは、メモリオンリーデータベースへの接続はひとつの接続のみ必要とされます。これは、開かれるデータベースがプライベートだということを意味しています。このケースでは、データベースURLは <CODE>jdbc:h2:mem:</CODE> です。同じ仮想マシン内で二つの接続が開いているというのは、二つの異なった (プライベートの) データベースが開いているという意味です。 @features_1314_p 時々、複数の接続が同じメモリオンリーデータベースを必要とします。このケースでは、データベースのURLに名前が含まれていなければなりません。例: <code>jdbc:h2:mem:db1</code> この方法での同じデータベースのアクセスは、同じ仮想マシンとClassLoader環境内でのみ動作します。 @features_1315_p TCP/IPまたは、SSL/TLSを使用して、メモリオンリーデータベースに間接的に (または、同じマシンの複数のプロセスから) 接続することも可能です。データベースURLの例: <code>jdbc:h2:tcp://localhost/mem:db1</code> (プライベートデータベースを間接的に使用することも可能です) @features_1316_p #By default, when the last connection to a in-memory database is closed, the contents are lost. This can be disabled by adding ;DB_CLOSE_DELAY=-1 to the database URL. That means to keep the contents of an in-memory database as long as the virtual machine is alive, use jdbc:h2:mem:test;DB_CLOSE_DELAY=-1 @features_1317_h2 暗号化ファイルと共にデータベースへ接続する @features_1318_p ファイルを暗号化して使用するためには、暗号化アルゴリズム ("cipher") とファイルパスワードを指定することが必要です。アルゴリズムは、接続パラメータを使用することで指定される必要があります。二つのアルゴリズムがサポートされています: XTEAとAES です。ファイルパスワードは、ユーザーパスワードの前のパスワードフィールドで指定されます。ファイルパスワードとユーザーパスワードの間に、シングルスペースを加えることが必要です; ファイルパスワードそのものにはスペースは含まれません。ファイルパスワードは (ユーザーパスワードも同様) 大文字と小文字を区別しています。こちらがパスワードの暗号化されたデータベースに接続するための例です: @features_1319_h2 データベースファイルロック @features_1320_p データベースが開かれるときはいつも、データベースが使用中であると他のプロセスに合図するためにロックファイルが作成されます。もしデータベースが閉じられるか、データベースを開いたプロセスが終了するなら、ロックファイルは削除されます。 @features_1321_p 以下のファイルロックメソッドが提供されます: @features_1322_li デフォルトメソッドは "file" で、データベースファイルを保護するために、watchdogスレッドを使用します。watchdogは、ロックファイルをそれぞれ秒単位で読み込みます。 @features_1323_li 二つめのメソッドは "socket" で、サーバーソケットを開きます。ソケットメソッドは、ロックファイルを秒単位で読むことを必要としていません。ソケットメソッドは、データベースファイルがひとつの (いつも同じ) コンピューターのみによってアクセスされる場合にのみ使用されます。 @features_1324_li ファイルロッキングなしでデータベースを開始することも可能です; このケースでは、データベースファイルを保護するのはアプリケーション次第です。 @features_1325_p 異なったファイルロックメソッドでデータベースを開くには、"FILE_LOCK" パラメータを使用します。以下のコードは "socket" ロックメソッドのデータベースを開きます: @features_1326_p 以下のコードは、データベースにロックファイルを全く作らないよう強要させます。これは、データ破損を導く可能性のある、同じデータベースを開くことができる他のプロセスのように、安全ではないということに注意して下さい: @features_1327_p アルゴリズムについての詳しい情報は、進化したトピックス のファイルロックプロトコルをご覧下さい。 @features_1328_h2 すでに存在する場合のみ、データベースを開く @features_1329_p デフォルトでは、アプリケーションが <code>DriverManager.getConnection(url,...)</code> を呼び出し、URLで指定されたデータベースがまだ存在しない時、 新しい (空の) データベースが作成されます。ある状況では、もしすでにデータベースが存在するのであれば、新しいデータベースの作成を制限して、データベースを開くだけにした方がよいでしょう。<code>;ifexists=true</code> をURLに追加することによって可能になります。このケースでは、もしデータベースがまだ存在していなければ、接続しようとした時に例外が投げられます。接続は、データベースがすでに存在する時のみ成功します。完全なURLは次のようです: @features_1330_h2 データベースを終了する @features_1331_h3 データベースの遅延終了 @features_1332_p 通常、データベースへの最後の接続が閉じられた時、データベースが終了されます。一部状況では、例えば、可能ではない時に接続をつなげたままにしておくことは、アプリケーションを減速させます。SQLステートメントの SET DB_CLOSE_DELAY <seconds> でデータベースの自動終了を遅らせるか、または無効にすることができます。secondsには、最後の接続が閉じられた後データベースを接続したままの状態に保つため、秒数を指定します。例えば、次のステートメントはデータベースを10秒間開かれた状態に保ちます: @features_1333_p 値の-1は、データベースは決して自動的に閉じられないということを意味します。値の0はデフォルトで、最後の接続が終了した時データベースが終了するということを意味します。この設定は永続的で、管理者のみが設定することができます。データベースのURL内で値を設定することが可能です: <code>jdbc:h2:~/test;DB_CLOSE_DELAY=10</code> @features_1334_h3 VMが終了した時、データベースを終了しない @features_1335_p デフォルトでは、データベースは最後の接続が閉じられた時に終了されます。しかし、最後の接続が決して閉じられなければ、仮想マシンが正常に終了する時にデータベースは閉じられます。これはshutdown hookを使うことによって行われます。一部状況では、データベースはこのケースで終了されてはいけません。例えば、仮想マシンが終了している時にデータベースがまだ使われている場合です (例として、シャットダウンプロセスをデータベースに保存するため)。このケースでは、データベースURLでデータベースの自動終了を無効にすることが可能です。最初の接続は (ひとつはデータベースを開始するもの) データベースURLにオプションを設定する必要があります (設定を後で変更することは不可能です)。VMが終了する時、データベースの終了を無効にするためのデータベースURLです: @features_1336_h2 ログインデックスの修正 @features_1337_p 通常、インデックスファイルの変更はパフォーマンスのために記録されません。データベースを開いた時に、インデックスファイルが破損しているか、無くなっていたら、データから作り直されます。停電、またはプログラムの異常終了のため、データベースが正しく終了されなかった時、インデックスファイルは破損されます。一部状況では、例えば、非常に大きなデータベースを使用している時 (数百MB以上)、インデックスファイルが再作成されるのにはとても時間がかかります。それらの状況では、インデックスファイルの変更を記録しておいた方がよいでしょう。そうすることによって、破損されたインデックスファイルの回復が速くなります。ログインデックスの修正を可能にするためには、jdbc:h2:~/test;LOG=2 のように、URLに LOG=2 を追加して下さい。接続する時に、この設定が指定されます。このオプションを使用する時、データベースのアップデートパフォーマンスは低下するでしょう。 @features_1338_h3 未知の設定を無視 @features_1339_p データベースに接続する時、いくつかのアプリケーションが (例えば、OpenOffice.org Base) いくつかの追加パラメータを渡します。なぜそれらのパラメータが渡されるのかは知られていません。PREFERDOSLIKELINEENDS と IGNOREDRIVERPRIVILEGES はパラメータの例で、それらは、OpenOffice.orgとの互換性を改良するために単に無視されます。もしデータベースに接続する時、アプリケーションが他のパラメータを渡していたら、通常データベースは、 パラメータはサポートされていません、という例外を投げます。データベースURLに ;IGNORE_UNKNOWN_SETTINGS=TRUE を追加することで、このようなパラメータを無視することが可能です。 @features_1340_h3 接続が開始された時に他の設定を変更する @features_1341_p すでに記述された設定に加えて (暗号、ファイルロック、データベースの存在、ユーザー、パスワード)、他のデータベースの設定は、データベースURLの中で渡すことができます。<CODE>SET setting value</CODE>ステートメントを接続直後に実行するのと同じように 、<CODE>setting=value</CODE> をURLの最後に追加します。このデータベースによってサポートされている設定の一覧は、SQL文法のドキュメントをご覧下さい。 @features_1342_h2 カスタムファイル アクセスモード @features_1343_p #Usually, the database opens log, data and index files with the access mode 'rw', meaning read-write (except for read only databases, where the mode 'r' is used). To open a database in read-only mode if the files are not read-only, use ACCESS_MODE_DATA=r. Also supported are 'rws' and 'rwd'. The access mode used for log files is set via ACCESS_MODE_LOG; for data and index files use ACCESS_MODE_DATA. These settings must be specified in the database URL: @features_1344_p 詳細は <a href="advanced.html#durability_problems">永続性問題</a> をご覧下さい。 多くのオペレーティングシステムでは、アクセスモード "rws" において、データがディスクに書かれていることを保証しません。 @features_1345_h2 複数の接続 @features_1346_h3 同時に複数のデータベースを開く @features_1347_p アプリケーションは、同じデータベースへの複数の接続を含め、複数のデータベースを同時に開くことができます。開くデータベースの数は、利用可能なメモリによってのみ制限されています。 @features_1348_h3 >同じデータベースへの複数の接続: クライアント/サーバー @features_1349_p 異なったプロセス、またはコンピューターから同時に同じデータベースにアクセスしたい場合、クライアント/サーバー モードを使用することが必要です。このケースでは、ひとつのプロセスがサーバーとして動作し、他のプロセスは (同様に他のコンピューターに属することができます) TCP/IP (または改善されたセキュリティ用のTCP/IPの上のSSL/TLS) を通してサーバーに接続します。 @features_1350_h3 マルチスレッドサポート @features_1351_p このデータベースは安全なマルチスレッドです。これは、アプリケーションがマルチスレッドならば、データベースへの同時アクセスに関して心配する必要がない、ということを意味しています。本質的に、同じデータベースへのほとんどのリクエストは同時に動きます。アプリケーションは、同時に同じデータベースにアクセスするマルチスレッドを使用することができますが、ひとつのスレッドが処理時間の長いクエリーを実行しているなら、他のスレッドは待つ必要があります。 @features_1352_h3 ロック、ロックタイムアウト、デッドロック @features_1353_p データの一貫した状態をそれぞれの接続に与えるために、データベースはテーブルレベルでのロックを使用します。二種類のロックがあります: リードロック (共有ロック) とライトロック (排他ロック) です。もし、接続がテーブルから読み込みたい場合で、テーブルにライトロックがない場合に、リードロックをテーブルに追加します。もしライトロックがあれば、この接続はロックを解除するために他の接続を待ちます。接続が指定された時間までにロックを取得できなければ、ロックタイムアウトの例外が投げられます。 @features_1354_p 通常、SELECTステートメントはリードロックを生成します。これはサブクエリーも含まれます。データを修正するステートメントはライトロックを使用します。SELECT ... FOR UPDATE ステートメントを使用して、データの修正がなくても排他的にテーブルをロックすることも可能です。COMMITとROLLBACKステートメントは全ての周知のロックを解除します。SAVEPOINTとROLLBACK TO SAVEPOINTコマンドはロックに影響を及ぼしません。ロックはオートコミットモードに変更した時、オートコミットの接続がtrueにセットされた時 (この状態がデフォルトです) にも解除され、ロックはそれぞれのステートメントの後に解除されます。これは、どのステートメントでどんな種類のロックが生成されるかの概観です: @features_1355_th ロックの種類 @features_1356_th SQLステートメント @features_1357_td Read @features_1358_td SELECT * FROM TEST @features_1359_td CALL SELECT MAX(ID) FROM TEST @features_1360_td SCRIPT @features_1361_td Write @features_1362_td SELECT * FROM TEST WHERE 1=0 FOR UPDATE @features_1363_td Write @features_1364_td INSERT INTO TEST VALUES(1, 'Hello') @features_1365_td INSERT INTO TEST SELECT * FROM TEST @features_1366_td UPDATE TEST SET NAME='Hi' @features_1367_td DELETE FROM TEST @features_1368_td Write @features_1369_td ALTER TABLE TEST ... @features_1370_td CREATE INDEX ... ON TEST ... @features_1371_td DROP INDEX ... @features_1372_p SQLコマンド SET LOCK_TIMEOUT <milliseconds> を使用して、ロックタイムアウトの例外が投げられるまでの秒数を、それぞれの接続ごとに別々に設定することができます。SQLコマンド SET DEFAULT_LOCK_TIMEOUT <milliseconds> を使用して、初期のロックタイムアウト (新しい接続に使用されるタイムアウト) を設定することができます。デフォルトのロックタイムアウトは永続的です。 @features_1373_h2 データベースファイルレイアウト @features_1374_p 永続的なデータベースのために作成された多くのファイルがあります。一部のデータベースを除いて、全てのテーブルと (または) インデックスが自身のファイル内に保存されているわけではありません。その代りに、通常次のファイルのみが作成されます: データファイル、インデックスファイル、ログファイル、データベースロックファイル (データベースが使われている間のみ存在します)。それに加えて、ファイルはそれぞれの大きなオブジェクト (CLOB/BLOB) のために作成されます。各ライナーインデックスのためのファイル、大きなresult setのためのテンポラリーファイルです。データベーストレースオプションが有効の場合、トレースファイルが作成されます。次のファイルはデータベースによって作成されます: @features_1375_th ファイル名 @features_1376_th 説明 @features_1377_th ファイル数 @features_1378_td test.data.db @features_1379_td データファイル @features_1380_td 全てのテーブルのデータを含む @features_1381_td フォーマット: <database>.data.db @features_1382_td データベースごとに1ファイル @features_1383_td test.index.db @features_1384_td インデックスファイル @features_1385_td 全ての (btree) インデックスのデータを含む @features_1386_td フォーマット: <database>.index.db @features_1387_td データベースごとに1ファイル @features_1388_td test.0.log.db @features_1389_td ログファイル @features_1390_td ログファイルはリカバリーのために使われる @features_1391_td フォーマット: <database>.<id>.log.db @features_1392_td データベースごとに0ファイル以上 @features_1393_td test.lock.db @features_1394_td データベースロックファイル @features_1395_td データベースが開かれている時のみ存在 @features_1396_td フォーマット: <database>.lock.db @features_1397_td データベースごとに1ファイル @features_1398_td test.trace.db @features_1399_td トレースファイル @features_1400_td トレース情報を含む @features_1401_td フォーマット: <database>.trace.db @features_1402_td ファイルが大きすぎる場合、<database>.trace.db.old に改名される @features_1403_td データベースごとに1ファイル @features_1404_td test.14.15.lob.db @features_1405_td 大きなオブジェクト @features_1406_td BLOB、またはCLOBのデータを含む @features_1407_td フォーマット: <database>.<tableid>.<id>.lob.db @features_1408_td オブジェクトごとに1ファイル @features_1409_td test.123.temp.db @features_1410_td テンポラリーファイル @features_1411_td テンポラリーblob、または大きなresult setを含む @features_1412_td フォーマット: <database>.<session id>.<object id>.temp.db @features_1413_td オブジェクトごとに1ファイル @features_1414_td test.7.hash.db @features_1415_td ハッシュインデックスファイル @features_1416_td ライナーハッシュインデックスのデータを含む @features_1417_td フォーマット: <database>.<object id>.hash.db @features_1418_td ライナーハッシュインデックスごとに1ファイル @features_1419_h3 データベースファイルの移動と改名 @features_1420_p データベースの名前と位置は、データベース名の中には保存されません。 @features_1421_p データベースが閉じられている間、ファイルは他のディレクトリに移動することができ、同様にファイル名を変えることもできます (全てのファイルが同じ名前で始まる必要があります)。 @features_1422_p ファイルにはプラットホーム固有のデータがないので、問題なく他のオペレーティングシステムに移動することができます。 @features_1423_h3 バックアップ @features_1424_p データベースが閉じられている時、データベースファイルのバックアップをとることが可能です。インデックスファイルはバックアップをとる必要はありません。なぜなら、インデックスファイルは冗長なデータを含み、もしファイルが存在しなければ自動的に再作成されるからです。 @features_1425_p データベースが動作している間にバックアップデータをとるために、SQLコマンド SCRIPTを使うことができます。 @features_1426_h2 ログとリカバリー @features_1427_p データベースでデータが修正され、それらの変更がコミットされた時はいつでも、変更はディスクに記録されます (インメモリオブジェクトを除いて)。データファイル自体への変更は通常、ディスクアクセスを最適化するために後で書かれています。もし電源異常があった場合、データファイルとインデックスファイルはアップデートされません。しかし、変更がログファイルに書かれていれば、次回データベースを開いた時に、ログファイルに書かれた変更は自動的に再び適用されます。 @features_1428_p インデックスファイルのアップデートはデフォルトでは記録されないことに注意して下さい。もしデータベースが開かれて、リカバリーが必要だとされたら、インデックスファイルは最初から作り替えられます。 @features_1429_p 通常、データベースごとにたったひとつのログファイルがあります。このファイルは、データベースが正常に終了されるまで増大し、削除されます。また、ファイルが大きくなりすぎたら、データベースは別のログファイルに交換します (より大きなIDで)。CHECKPOINT コマンドを使用することによって、ログの切り替えを強制することが可能です。 @features_1430_p checksumのレコードが合わないために (例えば、別のアプリケーションからファイルが編集された場合) データベースファイルが破損したら、データベースをリカバリーモードで開くことができます。このケースでは、データベースのエラーは記録されますが、投げられません。データベースはスクリプトまでバックアップをとり、可能な限り早く再構築します。データベースをリカバリーモードで開くために、jdbc:h2:~/test;RECOVER=1 のように、RECOVER=1 を含むデータベースURLを使用します。この場合、インデックスは再構築され、サマリー (アロケーションテーブルのオブジェクト)は読まれないため、データベースを開くのに時間がかかります。 @features_1431_h2 互換性 @features_1432_p #All database engines behave a little bit different. Where possible, H2 supports the ANSI SQL standard, and tries to be compatible to other databases. There are still a few differences however: @features_1433_p #In MySQL text columns are case insensitive by default, while in H2 they are case sensitive. However H2 supports case insensitive columns as well. To create the tables with case insensitive texts, append IGNORECASE=TRUE to the database URL (example: jdbc:h2:~/test;IGNORECASE=TRUE). @features_1434_h3 互換モード @features_1435_p #For certain features, this database can emulate the behavior of specific databases. Not all features or differences of those databases are implemented. Currently, this feature is mainly used for randomized comparative testing (where random statements are executed against multiple databases and the results are compared). The mode can be changed by specifying the mode in the database URL, or using the SQL statement SET MODE. To use the HSQLDB mode, you can use the database URL <code>jdbc:h2:~/test;MODE=HSQLDB</code> or the SQL statement <code>SET MODE HSQLDB</code> . Here is the list of currently supported modes and the difference to the regular mode: @features_1436_th モード @features_1437_th 相違 @features_1438_td PostgreSQL @features_1439_td 別の値にNULLをもたらすNULL連結。通常、オペレータのうちひとつがNULLであるなら空のストリングとしてNULLを扱い、両方の値がNULLである場合にだけNULLを返します。 @features_1440_td MySQL @features_1441_td データを挿入する時、もしカラムにNOT NULLが定義されていて、NULLが挿入されたら、0 (または空のストリング、またはtimestampカラムのための現在のtimestamp) の値が使用されます。通常、このオペレーションは許可されていないので、例外が投げられます。 @features_1442_td HSQLDB @features_1443_td デシマルデータを変換する時、新しいスケールが現在のスケールより小さい時のみ、数字は変換されます。通常、スケールは変換されて、必要であれば 0 が追加されます。 @features_1444_h2 トレースオプションを使用する @features_1445_p アプリケーション内の問題を見つけるために、時々、何のデータベースオペレーションがどこで実行されているかを知るのは良い方法です。このデータベースは次のトレースの特徴を提供します: @features_1446_li System.out と (または) ファイルをトレースする @features_1447_li トレースレベル OFF、ERROR、INFO と DEBUG をサポート @features_1448_li トレースファイルの最大サイズの設定が可能 @features_1449_li Javaコード生成が可能 @features_1450_li 手動でファイルを作成することによって、ランタイムでトレースが可能 @features_1451_h3 トレースオプション @features_1452_p トレースオプションを可能にする簡単な方法は、データベースURLにトレースオプションを設定することです。二つの設定があり、ひとつは、System.out (TRACE_LEVEL_SYSTEM_OUT) トレーシングで、もうひとつはファイルトレーシング(TRACE_LEVEL_FILE)です。トレースレベルは、0 が OFF、1 が ERROR (デフォルト)、2 が INFO で 3 が DEBUGです。両方のレベルがDEBUGに設定されたデータベースURLです: @features_1453_p トレースレベルは、SQLコマンド <CODE>SET TRACE_LEVEL_SYSTEM_OUT level</CODE> (System.out トレーシング) または <CODE>SET TRACE_LEVEL_FILE level</CODE> (ファイルトレーシング) を実行することによってランタイムで変更できます。例: @features_1454_h3 トレースファイルの最大サイズを設定 @features_1455_p 高いトレースレベルを使用する時、トレースファイルは早くサイズが非常に大きくなります。SQLステートメント <CODE>SET TRACE_MAX_FILE_SIZE maximumFileSizeInMB</CODE> を実行することによりファイルのサイズを制限することができます。ログファイルが制限を超えたら、ファイルは ".old" にファイル名を変えて、新しいファイルが作成されます。もしもうひとつの .oldファイルが存在する場合は、それは削除されます。デフォルトの設定は16 MBです。例: @features_1456_h3 Javaコード生成 @features_1457_p トレースレベルをINFOかDEBUGに設定した時、同様にJavaのソースコードが生成されるので、問題はより簡単に再生されます。トレースファイルはこのようなものです: @features_1458_p Javaのソースコードを得るために、 /**/ のない行を取り除く必要があります。 Windowsでの簡単な方法は: @features_1459_p その後、コンパイルされる前にTrace.javaファイルを完全にする必要があります。例: @features_1460_p また、トレースファイルに載せられていないため、ユーザー名とパスワードが設定されている必要があります。 @features_1461_h3 手動でファイルを作成し、ランタイムでトレースオプションを可能にする @features_1462_p 時々、アプリケーション、またはデータベースのURLを変えられない、変えたくない場合があります。このような場合に、ランタイムであっても (データベースの接続が開かれている間) トレースモードを可能にできる方法がまだあります。必要なことは、データベースファイルが保存されているディレクトリに特別なファイルを作るだけです。データベースエンジンは、このファイルが存在する場合に (ステートメントが実行されている間のみ) 4秒ごとにチェックしています。このファイル名は、データベース名 プラス ".trace.db.start" です。この特徴はデータベースが暗号化されている場合は無効になります。 @features_1463_p 例: データベース名が "test"の場合、 トレーシングを開始するファイルは "test.trace.db.start"です。データベースエンジンは、このファイルを見つけた時、ファイルを削除しようとします。スタートファイルを使用することでトレースが可能になるなら、トレースレベルはデータベースに対して永続的ではなく、トレースはデータベースに接続する以前のレベルに戻されます。しかし、スタートファイルが読み取り専用なら、データベースエンジンはファイルを削除することができず、接続するときはいつもトレースモードになります。 @features_1464_h2 #Using Other Logging APIs @features_1465_p #By default, this database uses its own native 'trace' facility. This facility is called 'trace' and not 'log' within this database to avoid confusion with the transaction log. Trace messages can be written to both file and System.out. In most cases, this is sufficient, however sometimes it is better to use the same facility as the application, for example Log4j. To do that, this database support SLF4J. @features_1466_a #SLF4J @features_1467_p #is a simple facade for various logging APIs and allows to plug in the desired implementation at deployment time. SLF4J supports implementations such as Logback, Log4j, Jakarta Commons Logging (JCL), JDK 1.4 logging, x4juli, and Simple Log. @features_1468_p #To enable SLF4J, set the file trace level to 4 in the database URL: @features_1469_p #Changing the log mechanism is not possible after the database is open, that means executing the SQL statement SET TRACE_LEVEL_FILE 4 when the database is already open will not have the desired effect. To use SLF4J, all required jar files need to be in the classpath. If it does not work, check in the file <database>.trace.db for error messages. @features_1470_h2 読み取り専用データベース @features_1471_p データベースファイルが読み取り専用なら、同様にデータベースも読み取り専用です。このデータベースで新しいテーブルを作成したり、データを追加したり変更したりすることはできません。SELECTステートメントのみ許可されています。読み取り専用データベースを作成するには、データベースを終了してログファイルを小さくします。ログファイルを削除してはいけません。そして、オペレーティングシステムを使用してデータベースファイルを読み取り専用にします。これでデータベースを開くと、読み取り専用になっています。アプリケーションが、データベースが読み取り専用であることを判断する方法は二つあります: Connection.isReadOnly() を呼ぶか、SQLステートメント CALL READONLY() を実行します。 @features_1472_h2 #Read Only Databases in Zip or Jar File @features_1473_p #To create a read-only database in a zip, first create a regular persistent database, and then create a backup. If you are using a database named 'test', an easy way to do that is using the Backup tool or the BACKUP SQL statement: @features_1474_p #The database must not have pending changes, that means you need to close all connections to the database, open one single connection, and then execute the statement. Afterwards, you can log out, and directly open the database in the zip file using the following database URL: @features_1475_p #Databases in a zip file are read-only. The performance for some queries will be slower than when using a regular database, because random access in zip files is not supported (only streaming). How much this affects the performance depends on the queries and the data. The database is not read in memory; so large databases are supported as well. The same indexes are used than when using a regular database. @features_1476_h2 バイナリーとテキストストレージフォーマット @features_1477_p このデータベースエンジンは、バイナリーとテキストストレージフォーマットの両方をサポートしています。バイナリーはより高速ですが、テキストストレージフォーマットは同様に役立つ場合があります。例えば、データベースエンジンをデバッグする場合です。データベースがすでに存在するなら、ストレージフォーマットは自動的に推奨されます。新しいデータベースはデフォルトでバイナリーストレージフォーマットで作られます。テキストストレージフォーマットで新しいデータベースを作成するには、データベースURLに、パラメータ STORAGE=TEXT が含まれていなければなりません。例: jdbc:h2:~/test;STORAGE=TEXT @features_1478_h2 ディスクスペースが少ない状況での正しい取り扱い @features_1479_p データベースは、利用可能なディスクスペースが少なくなっている状況に対処することができます。データベースを開始する時はいつも、"emergency space" ファイルが作られ (サイズは 1 MB)、利用可能なスペースがもうない場合には、ファイルは小さくなります。利用可能なスペースが 128 KB以下になった場合、データベースは特別な読み取り専用モードになり、全ての書き込み操作はもはや許可されません: この時点から全ての書き込み操作は、"No disk space available" を例外に投げます。通常のオペレーションモードに戻るためには、最初にデータベースへの全ての接続を終了し、スペースを空ける必要があります。 @features_1480_p 早くからディスクスペースの少ない状況を把握するために、データベースイベントリスナーをインストールすることは可能です (ディスクスペースが 1MB のみ利用可能な時)。SQLステートメント SET DATABASE_EVENT_LISTENER を使用します。フォームのURLを使用して、接続時にリスナーを設定することが可能です jdbc:h2:~/test;DATABASE_EVENT_LISTENER='com.acme.DbListener' (クラス名の周りの引用文は必要です)。APIのDatabaseEventListenerもご覧下さい。 @features_1481_h3 破損したデータベースを開く @features_1482_p boot info (始動時に実行されるSQLスクリプト) が破損しているため、データベースを開くことができない場合、データベースイベントリスナーを指定することでデータベースを開くことができます。例外は記録されますが、データベースの開始は続行します。 @features_1483_h2 computed column / ベースインデックスの機能 @features_1484_p インデックスの機能は、このデータベースによって直接サポートはされていませんが、computed columnsを使用することによって、簡単にエミュレートすることができます。例えば、カラムのupper-caseバージョンのインデックスが必要なら、原形のカラムのupper-caseバージョンのcomputed columnを作成し、このカラムにインデックスをつけます: @features_1485_p 値は生成されているので、データを挿入する時、カラムのupper-caseバージョンのための値を指定する必要はありません (許可されていません)。 しかし、テーブルを呼ぶ時、このカラムを使用することはできます。: @features_1486_h2 多次元インデックス @features_1487_p 効率的な多次元の (空間的) 領域のクエリーを実行するためにツールを提供します。このデータベースは専門的な空間的インデックス (R-Tree またはより小さいもの) をサポートしていません。代わりに、B-Treeインデックスが使われています。それぞれのレコードに対して、多次元のキーは、単数範囲 (スカラー) の値に変換 (位置づけ) されます。この値は、space-filling curve (空間充填曲線) で位置を指定します。 @features_1488_p 現在、Z-order (N-order または Morton-order とも呼ばれています) が使用されています; Hilbert curveも使用できますが、実装はより複雑です。多次元の値を変換するアルゴリズムは、bit-interleavingと呼ばれています。B-Treeインデックス (通常は computed columnを使用します)を使用することで、スカラーの値はインデックスをつけられます。 @features_1489_p 最初のカラムにインデックスを使用する上で、メソッドは徹底的なパフォーマンスの改良をもたらすことができます。データと次元の数によりますが、改良は通常、factor 5よりも高いものです。指定された多次元の範囲から、ツールはSQLクエリーを生成します。使用されたメソッドは、データベースに依存しておらず、ツールは簡単に他のデータベースに移植することができます。ツールの使用方法の例は、TestMultiDimension.java で提供されているサンプルコードをご覧下さい。 @features_1490_h2 パスワードを使用する @features_1491_h3 安全なパスワードを使用する @features_1492_p 弱いパスワードは、暗号化やセキュリティプロトコルに取るに足らず、解読されてしまうことを覚えておいて下さい。辞書で見つけられるようなパスワードは使用しないでください。また、数字を付け足してもそのようなパスワードは安全にはなりません。良いパスワードを作る方法は、覚えやすい、文章の最初の文字を使う、大文字と小文字を使う、特別な文字が含まれているものを作る、です。例: @features_1493_p i'sE2rtPiUKtT (もしトリックを知っていれば、このパスワードは覚えやすいものです) @features_1494_h3 パスワード: Stringの代わりにChar Arraysを使用する @features_1495_p Java Stringは不変のオブジェクトであり、アプリケーションによって安全に壊されることはできません。Stringの作成後、Stringは少なくともガベージコレクションになるまで、コンピューターのメインメモリ内にとどまるでしょう。ガベージコレクションはアプリケーションによって制御されず、ガベージコレクションであっても、データはまだメモリにとどまっているでしょう。パスワードが含まれるメモリの一部をディスクと取り換えることも可能でしょう (十分でないメインメモリも使用可能のため)。 @features_1496_p アタッカーはオペレーティングシステムのスワップファイルにアクセスするでしょう。したがって、パスワードを保存するために、Stringの代わりにchar arrayを使用するのは良い方法です。char arrayは使用後クリアにされるので (0で埋められます)、パスワードはスワップファイルに保存されません。 @features_1497_p このデータベースは、ユーザーパスワードとファイルパスワードを認証するために、Stringの代わりにchar arrayを使用することをサポートしています。次のコードはこのように使用されます: @features_1498_p このサンプルでは、パスワードはアプリケーションでのハードコードで、もちろん安全ではありません。しかし、Java Swingはchar arrayを使用してパスワードを得る方法をサポートしています (JPasswordField)。 @features_1499_h3 ユーザー名 と (または) パスワードをURLで認証する @features_1500_p ユーザー名を <code>Connection conn = DriverManager. getConnection("jdbc:h2:~/test", "sa", "123");</code> のように切り離されたパラメータとして認証する代わりに、URLそのもので <code>Connection conn = DriverManager. getConnection("jdbc:h2:~/test;USER=sa;PASSWORD=123");</code> ユーザー名 (と (または) パスワード)を提供することができます。URL内の設定は、切り離されたパラメータとして認証させる設定より優先されます。 @features_1501_h2 ユーザー定義の関数とストアドプロシージャ @features_1502_p 組み込み関数に加えて、このデータベースはユーザー定義のJava関数をサポートしています。同様に、このデータベースではJava関数はストアドプロシージャとして使用されています。関数は、使用される前に宣言 (登録) されていなければなりません。static Javaメソッドのみサポートされています; クラスとメソッドの両方が public である必要があります。Javaメソッドの例: @features_1503_p Java関数は、CREATE ALIAS と呼ばれるデータベースに登録されていなければなりません: @features_1504_p 完全なサンプルアプリケーションは src/test/org/h2/samples/Function.java をご覧下さい。 @features_1505_h3 データタイプマッピング関数 @features_1506_p "int" のような non-nullable (NULL可能ではない) パラメータを受け入れる関数は、パラメータのうちひとつがNULLであるなら呼ばれないでしょう。このケースでは、NULLの値は結果として使用されます。このケースで関数を呼び出したいのなら、"int" の代わりに "java.lang.Integer" を使用する必要があります。 @features_1507_h3 接続を必要とする関数 @features_1508_p もしJava関数の最初のパラメータが java.sql.Connection なら、データベースへの接続は与えられています。返す前にこの接続を閉じる必要はありません。 @features_1509_h3 例外を投げる関数 @features_1510_p 関数が例外を投げたら、現在のステートメントはロールバックされ、例外はアプリケーションに投げられます。 @features_1511_h3 Result Setを返す関数 @features_1512_p 関数はresult setを返します。このような関数はCALLステートメントと一緒に呼ばれます: @features_1513_h3 SimpleResultSetを使用する @features_1514_p result setを返す関数は、SimpleResultSetツールを使用して最初からこのresult setを作成することができます: @features_1515_h3 関数をテーブルとして使用する @features_1516_p result setを返す関数はテーブルのようになれます。しかし、このケースでは関数は少なくとも二回は呼ばれます: 最初はカラム名を集めるために構文解析している間です (コンパイル時に未知のところでパラメータはNULLに設定)。そして、データを取得するためにステートメントを実行している間です (これが結合なら繰り返されます)。関数がカラム一覧を取得するためだけに呼ばれたのなら、関数を認証する接続URLは jdbc:columnlist:connection です。そうでなければ、接続URLは jdbc:default:connection です。 @features_1517_h2 トリガー @features_1518_p このデータベースは、行が更新、挿入、または削除された前後に呼ばれるJavaトリガーをサポートしています。トリガーは複雑な一貫性チェックか、データベース内の関連したデータをアップデートするのに使用されます。マテリアライズドビューをシミュレートするためにトリガーを使用することも可能です。完全なサンプルアプリケーションは src/test/org/h2/samples/TriggerSample.java をご覧下さい。Javaトリガーは、インターフェイス org.h2.api.Trigger を実装しなければなりません: @features_1519_p 他のテーブルのクエリーかデータのアップデートに接続を使用することができます。トリガーはその時データベースで定義されている必要があります: @features_1520_p トリガーはSQL Exceptionを投げることによって、変更を禁止させることができます。 @features_1521_h2 データベースをコンパクトにする @features_1522_p データベースファイルの空のスペースは自動的に再利用されます。インデックスを再構築するもっとも簡単な方法は、データベースが閉じられている間に .index.db ファイルを削除します。しかし、一部状況では (例えば、データベースの多数のデータを削除した後)、データベースのサイズを縮小したい場合があります (データベースをコンパクトにする)。そのためのサンプルです: @features_1523_p サンプルアプリケーション org.h2.samples.Compact もご覧下さい。データベースのバックアップを作るのと、スクリプトからデータベースを再構築するのにSCRIPT / RUNSCRIPT コマンドを使用することができます。 @features_1524_h2 キャッシュの設定 @features_1525_p データベースは最も頻繁に使われるデータやインデックスページをメインメモリに保存します。キャッシュに使用されるメモリ量を CACHE_SIZE 設定を使用して変更することができます。この設定は、データベース接続URL (jdbc:h2:~/test;CACHE_SIZE=131072) か、ランタイムにSET CACHE_SIZE を使用してサイズを変更できます。 @features_1526_p このデータベースは二つのcache page replacement algorithms (キャッシュページ置換アルゴリズム) をサポートしています: LRU (デフォルト) と2Qです。LRUは、キャッシュがいっぱいになったら、頻繁に使用されていないページをキャッシュから削除します。2Qアルゴリズムは少し複雑で、基本的に二つのクエリーが使用されます。2Qアルゴリズムはテーブルスキャンに、より抵抗がありますが、LRUと比較してオーバーヘッドは少し高めです。キャッシュアルゴリズム 2Qを使用するためには、フォームのデータベースURL jdbc:h2:~/test;CACHE_TYPE=TQ を使用します。キャッシュアルゴリズムは、一度データベースが開かれたら変更することはできません。 @features_1527_p 読んだり書いたりしたページや、現在使用されているキャッシュアルゴリズムの情報を得るためには、SELECT * FROM INFORMATION_SCHEMA.SETTINGS を呼びます。データとインデックスファイルに読み書きしたページ数が書かれています。 @frame_1000_p H2 (for 'Hypersonic 2') is free a Java SQL DBMS. Clustering, embedded and server mode, transactions, referential integrity, views, subqueries, triggers, encryption, and disk based or in-memory operation are supported. A browser based console application is included. If you see this page your browser does not support frames. Please click here to view the<a href="search_ja.html">index</a>. @history_1000_h1 歴史とロードマップ @history_1001_a このデータベースエンジンの歴史 @history_1002_a なぜJavaなのか @history_1003_a 変更履歴 @history_1004_a ロードマップ @history_1005_a 支援者 @history_1006_h2 このデータベースエンジンの歴史 @history_1007_p H2DBの開発は2004年の5月に開始されましたが、初めて世に出たのは、2005年12月14日の事でした。生みの親であるThomas Muellerは、Hypersonic SQLの初期の開発者でもあります。2001年、彼はPointBaseMicroを生み出したPointBaseInc.に入社しました。この時点で彼はHypersonic SQLの開発を断念しなければなりませんでしたが、引き続きHypersonic SQLのコードベース開発を進める目的でHSQLDBグループが設立されました。H2DBの H2 は、このHypersonic 2を意味しています。とはいえ、H2DBはHypersonic SQLやHSQLDBとはコードの共有を一切行わず、すべてゼロから開発されました。 @history_1008_h2 なぜJavaなのか @history_1009_p Javaデータベースを使用するいくつかの理由: @history_1010_li Javaアプリケーションの統合は非常に簡単 @history_1011_li 多数の異なったプラットフォームのサポート @history_1012_li ネイティブアプリケーションより、より安全 (バッファーのオーバーフローがない) @history_1013_li #User defined functions (or triggers) run very fast @history_1014_li Unicodeをサポート @history_1015_p 低いレベルでのオペレーションでは、Javaはまだ低速すぎると思う方もいますが、そうではありません (それ以上でもありません)。一般的に、C、またはC++を使用するよりもずっと速くコードを書くことができます。このように、コードを移植して、低レベルのもの (スレッドのメモリ管理か取り扱いのような) に対処するよりもむしろ、アルゴリズムの改良(アプリケーションをより速くする) に集中することが可能です。ガーベジコレクションは今や手動でのメモリ管理よりおそらく速いでしょう。 @history_1016_p #A lot of features are already built in (for example Unicode, network libraries). It is very easy to write secure code because buffer overflows can not occur. Some features such as the reflection mechanism can be used for randomized testing. @history_1017_p Javaは将来への証明でもあります: 多くの会社がJavaをサポートし、今ではオープンソースです。 @history_1018_p このソフトウェアは、移植性の増加と使いやすさのため、そしてパフォーマンスの理由から、多くのJavaライブラリ、または他のソフトウェアを信頼していません。例えば、暗号化アルゴリズムと多数のライブラリ関数は、存在するライブラリを使用する代わりにデータベースに実装されています。SwingのようなオープンソースのJava実装が有効でないライブラリは使用されていないか、特定の特徴のみに使用されます。 @history_1019_h2 変更履歴 @history_1020_p #The up-to-date change log is available here: <a href="http://www.h2database.com/html/changelog.html">http://www.h2database.com/html/changelog.html</a> @history_1021_h2 ロードマップ @history_1022_p #The current roadmap is available here: <a href="http://www.h2database.com/html/roadmap.html">http://www.h2database.com/html/roadmap.html</a> @history_1023_h2 支援者 @history_1024_p #Many thanks for those who helped by finding and reporting bugs, gave valuable feedback, spread the word and have translated this project. Also many thanks to the donors who contributed via PayPal: @history_1025_li #Florent Ramiere, France @history_1026_li #Pete Haidinyak, USA @history_1027_li #Jun Iyama, Japan @history_1028_li #Antonio Casqueiro, Portugal @history_1029_li #lumber-mill.co.jp, Japan @history_1030_li #Oliver Computing LLC, USA @history_1031_li #Harpal Grover Consulting Inc., USA @history_1032_li #Elisabetta Berlini, Italy @history_1033_li #William Gilbert, USA @history_1034_li #Antonio Dieguez, Chile @history_1035_a #Ontology Works, USA @installation_1000_h1 インストール @installation_1001_a 必要条件 @installation_1002_a サポートされているプラットフォーム @installation_1003_a ソフトウェアのインストール @installation_1004_a ディレクトリ構成 @installation_1005_h2 必要条件 @installation_1006_p データベースを実行するために、以下のソフトウェアが動作することを確認します。 @installation_1007_li Windows XP、MacOS、またはLinux @installation_1008_li 推奨されるWindowsファイルシステム: NTFS (FAT32は4GB以上ファイルをサポートします) @installation_1009_li Sun JDK 1.4以降 @installation_1010_li Mozilla Firefox 1.5以降 @installation_1011_h2 サポートされているプラットフォーム @installation_1012_p このデータベースはJavaで書かれているため、多くの異なったプラットフォームで実行することができます。 Java 1.4、1.5、1.6でテストされましたが、GCJを使用することでネイティブコードにコンパイルすることもできます。 ソースコードはJava 1.5の特徴は使われていません。現在、データベースはWindows XPでSun JDK 1.4を使用して開発、テストされていますが、恐らく他の多くのOSと他のJava Runtime Environmentを使用しても動作するでしょう。 @installation_1013_h2 ソフトウェアのインストール @installation_1014_p ソフトウェアをインストールするために、インストーラーを実行するか 選択したディレクトリにソフトウェアを解凍します。 @installation_1015_h2 ディレクトリ構成 @installation_1016_p インストール後、下記のディレクトリ構成が作られます: @installation_1017_th ディレクトリ @installation_1018_th コンテンツ @installation_1019_td bin @installation_1020_td JARとbatchファイル @installation_1021_td docs @installation_1022_td ドキュメント @installation_1023_td docs/html @installation_1024_td HTMLページ @installation_1025_td docs/javadoc @installation_1026_td Javadocファイル @installation_1027_td #ext @installation_1028_td #External dependencies (downloaded when building) @installation_1029_td service @installation_1030_td Windows Serviceとしてデータベースを実行するツール @installation_1031_td src @installation_1032_td Sourceファイル @license_1000_h1 ライセンス @license_1001_h2 #Summary and License FAQ @license_1002_p #H2 is dual licensed and available under a modified version of the MPL 1.1 ( <a href="http://www.mozilla.org/MPL">Mozilla Public License</a> ) or EPL 1.0 ( <a href="http://opensource.org/licenses/eclipse-1.0.php">Eclipse Public License</a> ). The changes are @license_1003_em #underlined</em> . There is a License FAQ for both the MPL and the EPL, most of that is applicable to the H2 License as well. @license_1004_li #You can use H2 for free. You can integrate it into your application (including commercial applications), and you can distribute it. @license_1005_li #Files containing only your code are not covered by this license (it is 'commercial friendly'). @license_1006_li #Modifications to the H2 source code must be published. @license_1007_li #You don't need to provide the source code of H2 if you did not modify anything. @license_1008_p #However, nobody is allowed to rename H2, modify it a little, and sell it as a database engine without telling the customers it is in fact H2. This happened to HSQLDB, when a company called 'bungisoft' copied HSQLDB, renamed it to 'RedBase', and tried to sell it, hiding the fact that it was, in fact, just HSQLDB. At this time, it seems 'bungisoft' does not exist any more, but you can use the Wayback Machine of http://www.archive.org and look for old web pages of http://www.bungisoft.com . @license_1009_p #About porting the source code to another language (for example C# or C++): Converted source code (even if done manually) stays under the same copyright and license as the original code. The copyright of the ported source code does not (automatically) go to the person who ported the code. @license_1010_h2 #H2 License, Version 1.0 @license_1011_h3 #1. Definitions @license_1012_b #1.0.1. "Commercial Use" @license_1013_p #means distribution or otherwise making the Covered Code available to a third party. @license_1014_b #1.1. "Contributor" @license_1015_p #means each entity that creates or contributes to the creation of Modifications. @license_1016_b #1.2. "Contributor Version" @license_1017_p #means the combination of the Original Code, prior Modifications used by a Contributor, and the Modifications made by that particular Contributor. @license_1018_b #1.3. "Covered Code" @license_1019_p #means the Original Code or Modifications or the combination of the Original Code and Modifications, in each case including portions thereof. @license_1020_b #1.4. "Electronic Distribution Mechanism" @license_1021_p #means a mechanism generally accepted in the software development community for the electronic transfer of data. @license_1022_b #1.5. "Executable" @license_1023_p #means Covered Code in any form other than Source Code. @license_1024_b #1.6. "Initial Developer" @license_1025_p #means the individual or entity identified as the Initial Developer in the Source Code notice required by <a href="#exhibit-a">Exhibit A</a> . @license_1026_b #1.7. "Larger Work" @license_1027_p #means a work which combines Covered Code or portions thereof with code not governed by the terms of this License. @license_1028_b #1.8. "License" @license_1029_p #means this document. @license_1030_b #1.8.1. "Licensable" @license_1031_p #means having the right to grant, to the maximum extent possible, whether at the time of the initial grant or subsequently acquired, any and all of the rights conveyed herein. @license_1032_b #1.9. "Modifications" @license_1033_p #means any addition to or deletion from the substance or structure of either the Original Code or any previous Modifications. When Covered Code is released as a series of files, a Modification is: @license_1034_p #1.9.a. Any addition to or deletion from the contents of a file containing Original Code or previous Modifications. @license_1035_p #1.9.b. Any new file that contains any part of the Original Code or previous Modifications. @license_1036_b #1.10. "Original Code" @license_1037_p #means Source Code of computer software code which is described in the Source Code notice required by <a href="#exhibit-a">Exhibit A</a> as Original Code, and which, at the time of its release under this License is not already Covered Code governed by this License. @license_1038_b #1.10.1. "Patent Claims" @license_1039_p #means any patent claim(s), now owned or hereafter acquired, including without limitation, method, process, and apparatus claims, in any patent Licensable by grantor. @license_1040_b #1.11. "Source Code" @license_1041_p #means the preferred form of the Covered Code for making modifications to it, including all modules it contains, plus any associated interface definition files, scripts used to control compilation and installation of an Executable, or source code differential comparisons against either the Original Code or another well known, available Covered Code of the Contributor's choice. The Source Code can be in a compressed or archival form, provided the appropriate decompression or de-archiving software is widely available for no charge. @license_1042_b #1.12. "You" (or "Your") @license_1043_p #means an individual or a legal entity exercising rights under, and complying with all of the terms of, this License or a future version of this License issued under <a href="#section-6.1">Section 6.1.</a> For legal entities, "You" includes any entity which controls, is controlled by, or is under common control with You. For purposes of this definition, "control" means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity. @license_1044_h3 #2. Source Code License @license_1045_h4 #2.1. The Initial Developer Grant @license_1046_p #The Initial Developer hereby grants You a world-wide, royalty-free, non-exclusive license, subject to third party intellectual property claims: @license_1047_p #2.1.a. under intellectual property rights (other than patent or trademark) Licensable by Initial Developer to use, reproduce, modify, display, perform, sublicense and distribute the Original Code (or portions thereof) with or without Modifications, and/or as part of a Larger Work; and @license_1048_p #2.1.b. under Patents Claims infringed by the making, using or selling of Original Code, to make, have made, use, practice, sell, and offer for sale, and/or otherwise dispose of the Original Code (or portions thereof). @license_1049_p #2.1.c. the licenses granted in this Section 2.1 ( <a href="#section-2.1-a">a</a> ) and ( <a href="#section-2.1-b">b</a> ) are effective on the date Initial Developer first distributes Original Code under the terms of this License. @license_1050_p #2.1.d. Notwithstanding Section 2.1 ( <a href="#section-2.1-b">b</a> ) above, no patent license is granted: 1) for code that You delete from the Original Code; 2) separate from the Original Code; or 3) for infringements caused by: i) the modification of the Original Code or ii) the combination of the Original Code with other software or devices. @license_1051_h4 #2.2. Contributor Grant @license_1052_p #Subject to third party intellectual property claims, each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license @license_1053_p #2.2.a. under intellectual property rights (other than patent or trademark) Licensable by Contributor, to use, reproduce, modify, display, perform, sublicense and distribute the Modifications created by such Contributor (or portions thereof) either on an unmodified basis, with other Modifications, as Covered Code and/or as part of a Larger Work; and @license_1054_p #2.2.b. under Patent Claims infringed by the making, using, or selling of Modifications made by that Contributor either alone and/or in combination with its Contributor Version (or portions of such combination), to make, use, sell, offer for sale, have made, and/or otherwise dispose of: 1) Modifications made by that Contributor (or portions thereof); and 2) the combination of Modifications made by that Contributor with its Contributor Version (or portions of such combination). @license_1055_p #2.2.c. the licenses granted in Sections 2.2 ( <a href="#section-2.2-a">a</a> ) and 2.2 ( <a href="#section-2.2-b">b</a> ) are effective on the date Contributor first makes Commercial Use of the Covered Code. @license_1056_p #2.2.c. Notwithstanding Section 2.2 ( <a href="#section-2.2-b">b</a> ) above, no patent license is granted: 1) for any code that Contributor has deleted from the Contributor Version; 2) separate from the Contributor Version; 3) for infringements caused by: i) third party modifications of Contributor Version or ii) the combination of Modifications made by that Contributor with other software (except as part of the Contributor Version) or other devices; or 4) under Patent Claims infringed by Covered Code in the absence of Modifications made by that Contributor. @license_1057_h3 #3. Distribution Obligations @license_1058_h4 #3.1. Application of License @license_1059_p #The Modifications which You create or to which You contribute are governed by the terms of this License, including without limitation Section <a href="#section-2.2">2.2</a> . The Source Code version of Covered Code may be distributed only under the terms of this License or a future version of this License released under Section <a href="#section-6.1">6.1</a> , and You must include a copy of this License with every copy of the Source Code You distribute. You may not offer or impose any terms on any Source Code version that alters or restricts the applicable version of this License or the recipients' rights hereunder. However, You may include an additional document offering the additional rights described in Section <a href="#section-3.5">3.5</a> . @license_1060_h4 #3.2. Availability of Source Code @license_1061_p #Any Modification which You create or to which You contribute must be made available in Source Code form under the terms of this License either on the same media as an Executable version or via an accepted Electronic Distribution Mechanism to anyone to whom you made an Executable version available; and if made available via Electronic Distribution Mechanism, must remain available for at least twelve (12) months after the date it initially became available, or at least six (6) months after a subsequent version of that particular Modification has been made available to such recipients. You are responsible for ensuring that the Source Code version remains available even if the Electronic Distribution Mechanism is maintained by a third party. @license_1062_h4 #3.3. Description of Modifications @license_1063_p #You must cause all Covered Code to which You contribute to contain a file documenting the changes You made to create that Covered Code and the date of any change. You must include a prominent statement that the Modification is derived, directly or indirectly, from Original Code provided by the Initial Developer and including the name of the Initial Developer in (a) the Source Code, and (b) in any notice in an Executable version or related documentation in which You describe the origin or ownership of the Covered Code. @license_1064_h4 #3.4. Intellectual Property Matters @license_1065_b #3.4.a. Third Party Claims: @license_1066_p #If Contributor has knowledge that a license under a third party's intellectual property rights is required to exercise the rights granted by such Contributor under Sections <a href="#section-2.1">2.1</a> or <a href="#section-2.2">2.2</a> , Contributor must include a text file with the Source Code distribution titled "LEGAL" which describes the claim and the party making the claim in sufficient detail that a recipient will know whom to contact. If Contributor obtains such knowledge after the Modification is made available as described in Section <a href="#section-3.2">3.2</a> , Contributor shall promptly modify the LEGAL file in all copies Contributor makes available thereafter and shall take other steps (such as notifying appropriate mailing lists or newsgroups) reasonably calculated to inform those who received the Covered Code that new knowledge has been obtained. @license_1067_b #3.4.b. Contributor APIs: @license_1068_p #If Contributor's Modifications include an application programming interface and Contributor has knowledge of patent licenses which are reasonably necessary to implement that API, Contributor must also include this information in the legal file. @license_1069_b #3.4.c. Representations: @license_1070_p #Contributor represents that, except as disclosed pursuant to Section 3.4 ( <a href="#section-3.4-a">a</a> ) above, Contributor believes that Contributor's Modifications are Contributor's original creation(s) and/or Contributor has sufficient rights to grant the rights conveyed by this License. @license_1071_h4 #3.5. Required Notices @license_1072_p #You must duplicate the notice in <a href="#exhibit-a">Exhibit A</a> in each file of the Source Code. If it is not possible to put such notice in a particular Source Code file due to its structure, then You must include such notice in a location (such as a relevant directory) where a user would be likely to look for such a notice. If You created one or more Modification(s) You may add your name as a Contributor to the notice described in <a href="#exhibit-a">Exhibit A</a> . You must also duplicate this License in any documentation for the Source Code where You describe recipients' rights or ownership rights relating to Covered Code. You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Covered Code. However, You may do so only on Your own behalf, and not on behalf of the Initial Developer or any Contributor. You must make it absolutely clear than any such warranty, support, indemnity or liability obligation is offered by You alone, and You hereby agree to indemnify the Initial Developer and every Contributor for any liability incurred by the Initial Developer or such Contributor as a result of warranty, support, indemnity or liability terms You offer. @license_1073_h4 #3.6. Distribution of Executable Versions @license_1074_p #You may distribute Covered Code in Executable form only if the requirements of Sections <a href="#section-3.1">3.1</a> , <a href="#section-3.2">3.2</a> , <a href="#section-3.3">3.3</a> , <a href="#section-3.4">3.4</a> and <a href="#section-3.5">3.5</a> have been met for that Covered Code, and if You include a notice stating that the Source Code version of the Covered Code is available under the terms of this License, including a description of how and where You have fulfilled the obligations of Section <a href="#section-3.2">3.2</a> . The notice must be conspicuously included in any notice in an Executable version, related documentation or collateral in which You describe recipients' rights relating to the Covered Code. You may distribute the Executable version of Covered Code or ownership rights under a license of Your choice, which may contain terms different from this License, provided that You are in compliance with the terms of this License and that the license for the Executable version does not attempt to limit or alter the recipient's rights in the Source Code version from the rights set forth in this License. If You distribute the Executable version under a different license You must make it absolutely clear that any terms which differ from this License are offered by You alone, not by the Initial Developer or any Contributor. You hereby agree to indemnify the Initial Developer and every Contributor for any liability incurred by the Initial Developer or such Contributor as a result of any such terms You offer. @license_1075_h4 #3.7. Larger Works @license_1076_p #You may create a Larger Work by combining Covered Code with other code not governed by the terms of this License and distribute the Larger Work as a single product. In such a case, You must make sure the requirements of this License are fulfilled for the Covered Code. @license_1077_h3 #4. Inability to Comply Due to Statute or Regulation. @license_1078_p #If it is impossible for You to comply with any of the terms of this License with respect to some or all of the Covered Code due to statute, judicial order, or regulation then You must: (a) comply with the terms of this License to the maximum extent possible; and (b) describe the limitations and the code they affect. Such description must be included in the <b>legal</b> file described in Section <a href="#section-3.4">3.4</a> and must be included with all distributions of the Source Code. Except to the extent prohibited by statute or regulation, such description must be sufficiently detailed for a recipient of ordinary skill to be able to understand it. @license_1079_h3 #5. Application of this License. @license_1080_p #This License applies to code to which the Initial Developer has attached the notice in <a href="#exhibit-a">Exhibit A</a> and to related Covered Code. @license_1081_h3 #6. Versions of the License. @license_1082_h4 #6.1. New Versions @license_1083_p #The @license_1084_em #H2 Group</em> may publish revised and/or new versions of the License from time to time. Each version will be given a distinguishing version number. @license_1085_h4 #6.2. Effect of New Versions @license_1086_p #Once Covered Code has been published under a particular version of the License, You may always continue to use it under the terms of that version. You may also choose to use such Covered Code under the terms of any subsequent version of the License published by the @license_1087_em #H2 Group</em> . No one other than the @license_1088_em #H2 Group</em> has the right to modify the terms applicable to Covered Code created under this License. @license_1089_h4 #6.3. Derivative Works @license_1090_p #If You create or use a modified version of this License (which you may only do in order to apply it to code which is not already Covered Code governed by this License), You must (a) rename Your license so that the phrases @license_1091_em #"H2 Group", "H2"</em> or any confusingly similar phrase do not appear in your license (except to note that your license differs from this License) and (b) otherwise make it clear that Your version of the license contains terms which differ from the @license_1092_em #H2 License</em> . (Filling in the name of the Initial Developer, Original Code or Contributor in the notice described in <a href="#exhibit-a">Exhibit A</a> shall not of themselves be deemed to be modifications of this License.) @license_1093_h3 #7. Disclaimer of Warranty @license_1094_p #Covered code is provided under this license on an "as is" basis, without warranty of any kind, either expressed or implied, including, without limitation, warranties that the covered code is free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the covered code is with you. Should any covered code prove defective in any respect, you (not the initial developer or any other contributor) assume the cost of any necessary servicing, repair or correction. This disclaimer of warranty constitutes an essential part of this license. No use of any covered code is authorized hereunder except under this disclaimer. @license_1095_h3 #8. Termination @license_1096_p #8.1. This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such breach within 30 days of becoming aware of the breach. All sublicenses to the Covered Code which are properly granted shall survive any termination of this License. Provisions which, by their nature, must remain in effect beyond the termination of this License shall survive. @license_1097_p #8.2. If You initiate litigation by asserting a patent infringement claim (excluding declaratory judgment actions) against Initial Developer or a Contributor (the Initial Developer or Contributor against whom You file such action is referred to as "Participant") alleging that: @license_1098_p #8.2.a. such Participant's Contributor Version directly or indirectly infringes any patent, then any and all rights granted by such Participant to You under Sections <a href="#section-2.1">2.1</a> and/or <a href="#section-2.2">2.2</a> of this License shall, upon 60 days notice from Participant terminate prospectively, unless if within 60 days after receipt of notice You either: (i) agree in writing to pay Participant a mutually agreeable reasonable royalty for Your past and future use of Modifications made by such Participant, or (ii) withdraw Your litigation claim with respect to the Contributor Version against such Participant. If within 60 days of notice, a reasonable royalty and payment arrangement are not mutually agreed upon in writing by the parties or the litigation claim is not withdrawn, the rights granted by Participant to You under Sections <a href="#section-2.1">2.1</a> and/or <a href="#section-2.2">2.2</a> automatically terminate at the expiration of the 60 day notice period specified above. @license_1099_p #8.2.b. any software, hardware, or device, other than such Participant's Contributor Version, directly or indirectly infringes any patent, then any rights granted to You by such Participant under Sections 2.1( <a href="#section-2.1-b">b</a> ) and 2.2( <a href="#section-2.2-b">b</a> ) are revoked effective as of the date You first made, used, sold, distributed, or had made, Modifications made by that Participant. @license_1100_p #8.3. If You assert a patent infringement claim against Participant alleging that such Participant's Contributor Version directly or indirectly infringes any patent where such claim is resolved (such as by license or settlement) prior to the initiation of patent infringement litigation, then the reasonable value of the licenses granted by such Participant under Sections <a href="#section-2.1">2.1</a> or <a href="#section-2.2">2.2</a> shall be taken into account in determining the amount or value of any payment or license. @license_1101_p #8.4. In the event of termination under Sections <a href="#section-8.1">8.1</a> or <a href="#section-8.2">8.2</a> above, all end user license agreements (excluding distributors and resellers) which have been validly granted by You or any distributor hereunder prior to termination shall survive termination. @license_1102_h3 #9. Limitation of Liability @license_1103_p #Under no circumstances and under no legal theory, whether tort (including negligence), contract, or otherwise, shall you, the initial developer, any other contributor, or any distributor of covered code, or any supplier of any of such parties, be liable to any person for any indirect, special, incidental, or consequential damages of any character including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses, even if such party shall have been informed of the possibility of such damages. This limitation of liability shall not apply to liability for death or personal injury resulting from such party's negligence to the extent applicable law prohibits such limitation. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so this exclusion and limitation may not apply to you. @license_1104_h3 #10. United States Government End Users @license_1105_p #The Covered Code is a "commercial item", as that term is defined in 48 C.F.R. 2.101 (October 1995), consisting of "commercial computer software" and "commercial computer software documentation", as such terms are used in 48 C.F.R. 12.212 (September 1995). Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June 1995), all U.S. Government End Users acquire Covered Code with only those rights set forth herein. @license_1106_h3 #11. Miscellaneous @license_1107_p #This License represents the complete agreement concerning subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This License shall be governed by @license_1108_em #Swiss</em> law provisions (except to the extent applicable law, if any, provides otherwise), excluding its conflict-of-law provisions. With respect to disputes in which at least one party is a citizen of, or an entity chartered or registered to do business in @license_1109_em #Switzerland</em> , any litigation relating to this License shall be subject to the jurisdiction of @license_1110_em #Switzerland</em> , with the losing party responsible for costs, including without limitation, court costs and reasonable attorneys' fees and expenses. The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not apply to this License. @license_1111_h3 #12. Responsibility for Claims @license_1112_p #As between Initial Developer and the Contributors, each party is responsible for claims and damages arising, directly or indirectly, out of its utilization of rights under this License and You agree to work with Initial Developer and Contributors to distribute such responsibility on an equitable basis. Nothing herein is intended or shall be deemed to constitute any admission of liability. @license_1113_h3 #13. Multiple-Licensed Code @license_1114_p #Initial Developer may designate portions of the Covered Code as "Multiple-Licensed". "Multiple-Licensed" means that the Initial Developer permits you to utilize portions of the Covered Code under Your choice of this or the alternative licenses, if any, specified by the Initial Developer in the file described in <a href="#exhibit-a">Exhibit A</a> . @license_1115_h3 #Exhibit A @license_1116_h2 #Eclipse Public License - Version 1.0 @license_1117_p #THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT. @license_1118_h3 #1. DEFINITIONS @license_1119_p #"Contribution" means: @license_1120_p #a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and @license_1121_p #b) in the case of each subsequent Contributor: @license_1122_p #i) changes to the Program, and @license_1123_p #ii) additions to the Program; @license_1124_p #where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program. @license_1125_p #"Contributor" means any person or entity that distributes the Program. @license_1126_p #"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program. @license_1127_p #"Program" means the Contributions distributed in accordance with this Agreement. @license_1128_p #"Recipient" means anyone who receives the Program under this Agreement, including all Contributors. @license_1129_h3 #2. GRANT OF RIGHTS @license_1130_p #a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form. @license_1131_p #b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder. @license_1132_p #c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program. @license_1133_p #d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement. @license_1134_h3 #3. REQUIREMENTS @license_1135_p #A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that: @license_1136_p #a) it complies with the terms and conditions of this Agreement; and @license_1137_p #b) its license agreement: @license_1138_p #i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose; @license_1139_p #ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits; @license_1140_p #iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and @license_1141_p #iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange. @license_1142_p #When the Program is made available in source code form: @license_1143_p #a) it must be made available under this Agreement; and @license_1144_p #b) a copy of this Agreement must be included with each copy of the Program. @license_1145_p #Contributors may not remove or alter any copyright notices contained within the Program. @license_1146_p #Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution. @license_1147_h3 #4. COMMERCIAL DISTRIBUTION @license_1148_p #Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense. @license_1149_p #For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages. @license_1150_h3 #5. NO WARRANTY @license_1151_p #EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations. @license_1152_h3 #6. DISCLAIMER OF LIABILITY @license_1153_p #EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. @license_1154_h3 #7. GENERAL @license_1155_p #If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable. @license_1156_p #If Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed. @license_1157_p #All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive. @license_1158_p #Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. The Eclipse Foundation is the initial Agreement Steward. The Eclipse Foundation may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved. @license_1159_p #This Agreement is governed by the laws of @license_1160_em #Switzerland</em> and the intellectual property laws of @license_1161_em #Switzerland</em> . No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation. @links_1000_h1 #H2 In Use and Links @links_1001_p #Those are just a few links to products using or supporting H2. If you want to add a link, please send it to the support email address or post it in the group. @links_1002_h2 #Books @links_1003_a #Seam In Action @links_1004_h2 #Extensions @links_1005_a #H2Sharp @links_1006_p #ADO.NET interface for the H2 database engine. @links_1007_a #Spatial capabilities @links_1008_h2 #Blogs @links_1009_a #H2 Database - Performance Tracing (2008-04-30) @links_1010_a #Testing your JDBC data access layer with DBUnit and H2 (2007-09-18) @links_1011_a #Open Source Databases Comparison (2007-09-11) @links_1012_a #The Codist: The Open Source Frameworks I Use (2007-07-23) @links_1013_a #The Codist: SQL Injections: How Not To Get Stuck (2007-05-08) @links_1014_a #One Man Band: (Helma + H2) == "to easy" (2007-03-11) @links_1015_a #David Coldrick's Weblog: New Version of H2 Database Released (2007-01-06) @links_1016_a #The Codist: Write Your Own Database, Again (2006-11-13) @links_1017_h2 #Project Pages @links_1018_a #Ohloh @links_1019_a #Freshmeat Project Page @links_1020_a #Wikipedia @links_1021_a #OSZone @links_1022_a #Java Source Net @links_1023_a #Linux Package Manager @links_1024_h2 #Products and Projects @links_1025_a #Apache Cayenne @links_1026_p #Open source persistence framework providing object-relational mapping (ORM) and remoting services. @links_1027_a #Apache Jackrabbit @links_1028_p #Open source implementation of the Java Content Repository API (JCR). @links_1029_a #Apache OpenJPA @links_1030_p #Open source implementation of the Java Persistence API (JPA). @links_1031_a #AppFuse @links_1032_p #Helps building web applications. @links_1033_a #Blojsom @links_1034_p #Java-based multi-blog, multi-user software package (Mac OS X Weblog Server). @links_1035_a #Bookmarks Portlet @links_1036_p #JSR 168 compliant bookmarks management portlet application. @links_1037_a #Claros inTouch @links_1038_p #Ajax communication suite with mail, addresses, notes, IM, and rss reader. @links_1039_a #CrashPlan PRO Server @links_1040_p #Easy and cross platform backup solution for business and service providers. @links_1041_a #DB Solo @links_1042_p #SQL query tool. @links_1043_a #DbVisualizer @links_1044_p #Database tool. @links_1045_a #Execute Query @links_1046_p #Database utility written in Java. @links_1047_a #Flux @links_1048_p #Java job scheduler, file transfer, workflow, and BPM. @links_1049_a #Golden T Studios @links_1050_p #Fun-to-play games with a simple interface. @links_1051_a #Group Session @links_1052_p #Open source web groupware. @links_1053_a #HA-JDBC @links_1054_p #High-Availability JDBC: A JDBC proxy that provides light-weight, transparent, fault tolerant clustering capability to any underlying JDBC driver. @links_1055_a #HenPlus @links_1056_p #HenPlus is a SQL shell written in Java. @links_1057_a #Hibernate @links_1058_p #Relational persistence for idiomatic Java (O-R mapping tool). @links_1059_a #Hibicius @links_1060_p #Online Banking Client for the HBCI protocol. @links_1061_a #H2 Spatial @links_1062_p #A project to add spatial functions to H2 database. @links_1063_a #JAMWiki @links_1064_p #Java-based Wiki engine. @links_1065_a #Jala @links_1066_p #Open source collection of JavaScript modules. @links_1067_a #JavaPlayer @links_1068_p #Pure Java MP3 player. @links_1069_a #JMatter @links_1070_p #Framework for constructing workgroup business applications based on the Naked Objects Architectural Pattern. @links_1071_a #JPOX @links_1072_p #Java persistent objects. @links_1073_a #Liftweb @links_1074_p #A Scala-based, secure, developer friendly web framework. @links_1075_a #LiquiBase @links_1076_p #A tool to manage database changes and refactorings. @links_1077_a #Luntbuild @links_1078_p #Build automation and management tool. @links_1079_a #MiniConnectionPoolManager @links_1080_p #A lightweight standalone JDBC connection pool manager. @links_1081_a #Mr. Persister @links_1082_p #Simple, small and fast object relational mapping. @links_1083_a #Myna Application Server @links_1084_p #Java web app that provides dynamic web content and Java libraries access from JavaScript. @links_1085_a #MyTunesRss @links_1086_p #MyTunesRSS lets you listen to your music wherever you are. @links_1087_a #NCGC CurveFit @links_1088_p #From: NIH Chemical Genomics Center, National Institutes of Health, USA. An open source application in the life sciences research field. This application handles chemical structures and biological responses of thousands of compounds with the potential to handle million+ compounds. It utilizes an embedded H2 database to enable flexible query/retrieval of all data including advanced chemical substructure and similarity searching. The application highlights an automated curve fitting and classification algorithm that outperforms commercial packages in the field. Commercial alternatives are typically small desktop software that handle a few dose response curves at a time. A couple of commercial packages that do handle several thousand curves are very expensive tools (>60k USD) that require manual curation of analysis by the user; require a license to Oracle; lack advanced query/retrieval; and the ability to handle chemical structures. @links_1089_a #Orion @links_1090_p #J2EE Application Server. @links_1091_a #P5H2 @links_1092_p #A library for the <a href="http://www.processing.org">Processing</a> programming language and environment. @links_1093_a #Phase-6 @links_1094_p #A computer based learning software. @links_1095_a #Pickle @links_1096_p #Pickle is a Java library containing classes for persistence, concurrency, and logging. @links_1097_a #PolePosition @links_1098_p #Open source database benchmark. @links_1099_a #Rutema @links_1100_p #Rutema is a test execution and management tool for heterogeneous development environments written in Ruby. @links_1101_a #Scriptella @links_1102_p #ETL (Extract-Transform-Load) and script execution tool. @links_1103_a #Sesar @links_1104_p #Dependency Injection Container with Aspect Oriented Programming. @links_1105_a #SemmleCode @links_1106_p #Eclipse plugin to help you improve software quality. @links_1107_a #Shellbook @links_1108_p #Desktop publishing application. @links_1109_a #Signsoft intelliBO @links_1110_p #Persistence middleware supporting the JDO specification. @links_1111_a #SmartFoxServer @links_1112_p #Platform for developing multiuser applications and games with Macromedia Flash. @links_1113_a #SQL Developer @links_1114_p #Universal Database Frontend. @links_1115_a #SQL Workbench/J @links_1116_p #Free DBMS-independent SQL tool. @links_1117_a #SQuirreL SQL Client @links_1118_p #Graphical tool to view the structure of a database, browse the data, issue SQL commands etc. @links_1119_a #SQuirreL DB Copy Plugin @links_1120_p #Tool to copy data from one database to another. @links_1121_a #StorYBook @links_1122_p #A summary-based tool for novelist and script writers. It helps to keep the overview over the various traces a story has. @links_1123_a #StreamCruncher @links_1124_p #Event (stream) processing kernel. @links_1125_a #Tamava @links_1126_p #Newsgroups Reader. @links_1127_a #Tune Backup @links_1128_p #Easy-to-use backup solution for your iTunes library. @links_1129_a #Web of Web @links_1130_p #Collaborative and realtime interactive media platform for the web. @links_1131_a #Werkzeugkasten @links_1132_p #Minimum Java Toolset. @links_1133_a #Volunteer database @links_1134_p #A database front end to register volunteers, partnership and donation for a Non Profit organization. @mainWeb_1000_h1 H2 データベース エンジン @mainWeb_1001_p #Welcome to H2, the Java SQL database. The main feature of H2 are: @mainWeb_1002_li 速度がとても速く、全ての方が無料で使用でき、ソースコードが含まれています @mainWeb_1003_li #Embedded, server and cluster modes @mainWeb_1004_li #JDBC and ODBC API; browser based Console application @mainWeb_1005_li #Written in Java; can be compiled with GCJ and IKVM.NET @mainWeb_1006_li #Small footprint: around 1 MB @mainWeb_1007_h3 ダウンロード @mainWeb_1008_td #Version 1.0.73 (2008-05-31): @mainWeb_1009_a #Windows Installer (3.1 MB) @mainWeb_1010_a #All platforms (zip, 4.5 MB) @mainWeb_1011_a 全てダウンロード @mainWeb_1012_td @mainWeb_1013_h3 サポート @mainWeb_1014_a Google グループ (English) @mainWeb_1015_a Google グループ (Japanese) @mainWeb_1016_p e-mail はこちらから: @mainWeb_1017_td @mainWeb_1018_h3 パフォーマンス @mainWeb_1019_td 操作/秒 (高い方がより良い) - <a href="performance.html">このテストについての詳しい情報</a> @mainWeb_1020_td @mainWeb_1021_h3 ニュース @mainWeb_1022_b ニュースフィード: @mainWeb_1023_a #Full text (Atom) @mainWeb_1024_p #or <a href="http://www.h2database.com/html/newsfeed-rss.xml" target="_blank">Header only (RSS)</a> . @mainWeb_1025_b Email ニュースレター: @mainWeb_1026_p <a href="http://groups.google.com/group/h2database-news/subscribe"> H2 データベース ニュース</a> (Googleアカウントが必要です) に署名し、ニューリリースについての情報を入手して下さい。 あなたのemailアドレスはこのコンテンツでのみ使用されます。 @mainWeb_1027_td @mainWeb_1028_h3 寄稿する @mainWeb_1029_p H2の発展のため、フィードバックやバグ報告を送ったり、H2コンソールアプリケーション (ファイル h2/src/main/org/h2/server/web/res/_text_*.properties)を訳すなど、 投稿することができます。また、下にある PayPal ボタンをクリックすることで 寄付することもできます。 支援者として、あなたの名前が載ります: @main_1000_h1 H2 データベース エンジン @main_1001_p ようこそ、無料のSQLデータベース、H2へ @main_1002_a クイックスタート @main_1003_p Click here to get a fast overview. @main_1004_a チュートリアル @main_1005_p Go through the samples. @main_1006_a 特徴 @main_1007_p See what this database can do and how to use these features. @performance_1000_h1 パフォーマンス @performance_1001_a #Performance Comparison @performance_1002_a #PolePosition Benchmark @performance_1003_a #Application Profiling @performance_1004_a #Performance Tuning @performance_1005_h2 #Performance Comparison @performance_1006_p #In most cases H2 is a lot faster than all other (open source and not open source) database engines. Please note this is mostly a single connection benchmark run on one computer. @performance_1007_h3 #Embedded @performance_1008_th #Test Case @performance_1009_th #Unit @performance_1010_th H2 @performance_1011_th HSQLDB @performance_1012_th Derby @performance_1013_td #Simple: Init @performance_1014_td #ms @performance_1015_td #719 @performance_1016_td #1344 @performance_1017_td #2906 @performance_1018_td #Simple: Query (random) @performance_1019_td #ms @performance_1020_td #328 @performance_1021_td #328 @performance_1022_td #1578 @performance_1023_td #Simple: Query (sequential) @performance_1024_td #ms @performance_1025_td #250 @performance_1026_td #250 @performance_1027_td #1484 @performance_1028_td #Simple: Update (random) @performance_1029_td #ms @performance_1030_td #688 @performance_1031_td #1828 @performance_1032_td #14922 @performance_1033_td #Simple: Delete (sequential) @performance_1034_td #ms @performance_1035_td #203 @performance_1036_td #265 @performance_1037_td #10235 @performance_1038_td #Simple: Memory Usage @performance_1039_td #MB @performance_1040_td #6 @performance_1041_td #9 @performance_1042_td #11 @performance_1043_td #BenchA: Init @performance_1044_td #ms @performance_1045_td #422 @performance_1046_td #672 @performance_1047_td #4328 @performance_1048_td #BenchA: Transactions @performance_1049_td #ms @performance_1050_td #6969 @performance_1051_td #3531 @performance_1052_td #16719 @performance_1053_td #BenchA: Memory Usage @performance_1054_td #MB @performance_1055_td #10 @performance_1056_td #10 @performance_1057_td #9 @performance_1058_td #BenchB: Init @performance_1059_td #ms @performance_1060_td #1703 @performance_1061_td #3937 @performance_1062_td #13844 @performance_1063_td #BenchB: Transactions @performance_1064_td #ms @performance_1065_td #2360 @performance_1066_td #1328 @performance_1067_td #5797 @performance_1068_td #BenchB: Memory Usage @performance_1069_td #MB @performance_1070_td #8 @performance_1071_td #9 @performance_1072_td #8 @performance_1073_td #BenchC: Init @performance_1074_td #ms @performance_1075_td #718 @performance_1076_td #468 @performance_1077_td #5328 @performance_1078_td #BenchC: Transactions @performance_1079_td #ms @performance_1080_td #2688 @performance_1081_td #60828 @performance_1082_td #7109 @performance_1083_td #BenchC: Memory Usage @performance_1084_td #MB @performance_1085_td #10 @performance_1086_td #14 @performance_1087_td #9 @performance_1088_td #Executed Statements @performance_1089_td ## @performance_1090_td #594255 @performance_1091_td #594255 @performance_1092_td #594255 @performance_1093_td #Total Time @performance_1094_td #ms @performance_1095_td #17048 @performance_1096_td #74779 @performance_1097_td #84250 @performance_1098_td #Statement per Second @performance_1099_td ## @performance_1100_td #34857 @performance_1101_td #7946 @performance_1102_td #7053 @performance_1103_h3 #Client-Server @performance_1104_th #Test Case @performance_1105_th #Unit @performance_1106_th H2 @performance_1107_th HSQLDB @performance_1108_th Derby @performance_1109_th PostgreSQL @performance_1110_th MySQL @performance_1111_td #Simple: Init @performance_1112_td #ms @performance_1113_td #2516 @performance_1114_td #3109 @performance_1115_td #7078 @performance_1116_td #4625 @performance_1117_td #2859 @performance_1118_td #Simple: Query (random) @performance_1119_td #ms @performance_1120_td #2890 @performance_1121_td #2547 @performance_1122_td #8843 @performance_1123_td #7703 @performance_1124_td #3203 @performance_1125_td #Simple: Query (sequential) @performance_1126_td #ms @performance_1127_td #2953 @performance_1128_td #2407 @performance_1129_td #8516 @performance_1130_td #6953 @performance_1131_td #3516 @performance_1132_td #Simple: Update (random) @performance_1133_td #ms @performance_1134_td #3141 @performance_1135_td #3671 @performance_1136_td #18125 @performance_1137_td #7797 @performance_1138_td #4687 @performance_1139_td #Simple: Delete (sequential) @performance_1140_td #ms @performance_1141_td #1000 @performance_1142_td #1219 @performance_1143_td #12891 @performance_1144_td #3547 @performance_1145_td #1938 @performance_1146_td #Simple: Memory Usage @performance_1147_td #MB @performance_1148_td #6 @performance_1149_td #10 @performance_1150_td #14 @performance_1151_td #0 @performance_1152_td #1 @performance_1153_td #BenchA: Init @performance_1154_td #ms @performance_1155_td #2266 @performance_1156_td #2484 @performance_1157_td #7797 @performance_1158_td #4234 @performance_1159_td #4703 @performance_1160_td #BenchA: Transactions @performance_1161_td #ms @performance_1162_td #11078 @performance_1163_td #8875 @performance_1164_td #26328 @performance_1165_td #18641 @performance_1166_td #11187 @performance_1167_td #BenchA: Memory Usage @performance_1168_td #MB @performance_1169_td #8 @performance_1170_td #13 @performance_1171_td #10 @performance_1172_td #0 @performance_1173_td #1 @performance_1174_td #BenchB: Init @performance_1175_td #ms @performance_1176_td #8422 @performance_1177_td #12531 @performance_1178_td #27734 @performance_1179_td #18609 @performance_1180_td #12312 @performance_1181_td #BenchB: Transactions @performance_1182_td #ms @performance_1183_td #4125 @performance_1184_td #3344 @performance_1185_td #7875 @performance_1186_td #7922 @performance_1187_td #3266 @performance_1188_td #BenchB: Memory Usage @performance_1189_td #MB @performance_1190_td #9 @performance_1191_td #10 @performance_1192_td #8 @performance_1193_td #0 @performance_1194_td #1 @performance_1195_td #BenchC: Init @performance_1196_td #ms @performance_1197_td #1781 @performance_1198_td #1609 @performance_1199_td #6797 @performance_1200_td #2453 @performance_1201_td #3328 @performance_1202_td #BenchC: Transactions @performance_1203_td #ms @performance_1204_td #8453 @performance_1205_td #62469 @performance_1206_td #19859 @performance_1207_td #11516 @performance_1208_td #7062 @performance_1209_td #BenchC: Memory Usage @performance_1210_td #MB @performance_1211_td #10 @performance_1212_td #15 @performance_1213_td #9 @performance_1214_td #0 @performance_1215_td #1 @performance_1216_td #Executed Statements @performance_1217_td ## @performance_1218_td #594255 @performance_1219_td #594255 @performance_1220_td #594255 @performance_1221_td #594255 @performance_1222_td #594255 @performance_1223_td #Total Time @performance_1224_td #ms @performance_1225_td #48625 @performance_1226_td #104265 @performance_1227_td #151843 @performance_1228_td #94000 @performance_1229_td #58061 @performance_1230_td #Statement per Second @performance_1231_td ## @performance_1232_td #12221 @performance_1233_td #5699 @performance_1234_td #3913 @performance_1235_td #6321 @performance_1236_td #10235 @performance_1237_h3 #Benchmark Results and Comments @performance_1238_h4 H2 @performance_1239_p #Version 1.0.67 (2008-02-22) was used for the test. For simpler operations, the performance of H2 is about the same as for HSQLDB. For more complex queries, the query optimizer is very important. However H2 is not very fast in every case, certain kind of queries may still be slow. One situation where is H2 is slow is large result sets, because they are buffered to disk if more than a certain number of records are returned. The advantage of buffering is, there is no limit on the result set size. The open/close time is almost fixed, because of the file locking protocol: The engine waits 20 ms after opening a database to ensure the database files are not opened by another process. @performance_1240_h4 HSQLDB @performance_1241_p #Version 1.8.0.8 was used for the test. Cached tables are used in this test (hsqldb.default_table_type=cached), and the write delay is 1 second (SET WRITE_DELAY 1). HSQLDB is fast when using simple operations. HSQLDB is very slow in the last test (BenchC: Transactions), probably because is has a bad query optimizer. One query where HSQLDB is slow is a two-table join: @performance_1242_p #The PolePosition benchmark also shows that the query optimizer does not do a very good job for some queries. A disadvantage in HSQLDB is the slow startup / shutdown time (currently not listed) when using bigger databases. The reason is, a backup of the database is created whenever the database is opened or closed. @performance_1243_h4 Derby @performance_1244_p #Version 10.3.1.4 was used for the test. Derby is clearly the slowest embedded database in this test. This seems to be a structural problem, because all operations are really slow. It will not be easy for the developers of Derby to improve the performance to a reasonable level. A few problems have been identified: Leaving autocommit on is a problem for Derby. If it is switched off during the whole test, the results are about 20% better for Derby. @performance_1245_h4 PostgreSQL @performance_1246_p #Version 8.1.4 was used for the test. The following options where changed in postgresql.conf: fsync = off, commit_delay = 1000. PostgreSQL is run in server mode. It looks like the base performance is slower than MySQL, the reason could be the network layer. The memory usage number is incorrect, because only the memory usage of the JDBC driver is measured. @performance_1247_h4 MySQL @performance_1248_p #Version 5.0.22 was used for the test. MySQL was run with the InnoDB backend. The setting innodb_flush_log_at_trx_commit (found in the my.ini file) was set to 0. Otherwise (and by default), MySQL is really slow (around 140 statements per second in this test) because it tries to flush the data to disk for each commit. For small transactions (when autocommit is on) this is really slow. But many use cases use small or relatively small transactions. Too bad this setting is not listed in the configuration wizard, and it always overwritten when using the wizard. You need to change this setting manually in the file my.ini, and then restart the service. The memory usage number is incorrect, because only the memory usage of the JDBC driver is measured. @performance_1249_h4 #Firebird @performance_1250_p #Firebird 1.5 (default installation) was tested, but the results are not published currently. It is possible to run the performance test with the Firebird database, and any information on how to configure Firebird for higher performance are welcome. @performance_1251_h4 #Why Oracle / MS SQL Server / DB2 are Not Listed @performance_1252_p #The license of these databases does not allow to publish benchmark results. This doesn't mean that they are fast. They are in fact quite slow, and need a lot of memory. But you will need to test this yourself. SQLite was not tested because the JDBC driver doesn't support transactions. @performance_1253_h3 #About this Benchmark @performance_1254_h4 #Number of Connections @performance_1255_p #This is mostly a single-connection benchmark. BenchB uses multiple connections; the other tests use one connection. @performance_1256_h4 #Real-World Tests @performance_1257_p #Good benchmarks emulate real-world use cases. This benchmark includes 3 test cases: A simple test case with one table and many small updates / deletes. BenchA is similar to the TPC-A test, but single connection / single threaded (see also: www.tpc.org). BenchB is similar to the TPC-B test, using multiple connections (one thread per connection). BenchC is similar to the TPC-C test, but single connection / single threaded. @performance_1258_h4 #Comparing Embedded with Server Databases @performance_1259_p #This is mainly a benchmark for embedded databases (where the application runs in the same virtual machine than the database engine). However MySQL and PostgreSQL are not Java databases and cannot be embedded into a Java application. For the Java databases, both embedded and server modes are tested. @performance_1260_h4 #Test Platform @performance_1261_p #This test is run on Windows XP with the virus scanner switched off. The VM used is Sun JDK 1.5. @performance_1262_h4 #Multiple Runs @performance_1263_p #When a Java benchmark is run first, the code is not fully compiled and therefore runs slower than when running multiple times. A benchmark should always run the same test multiple times and ignore the first run(s). This benchmark runs three times, but only the last run is measured. @performance_1264_h4 #Memory Usage @performance_1265_p #It is not enough to measure the time taken, the memory usage is important as well. Performance can be improved in databases by using a bigger in-memory cache, but there is only a limited amount of memory available on the system. HSQLDB tables are kept fully in memory by default; this benchmark uses 'disk based' tables for all databases. Unfortunately, it is not so easy to calculate the memory usage of PostgreSQL and MySQL, because they run in a different process than the test. This benchmark currently does not print memory usage of those databases. @performance_1266_h4 #Delayed Operations @performance_1267_p #Some databases delay some operations (for example flushing the buffers) until after the benchmark is run. This benchmark waits between each database tested, and each database runs in a different process (sequentially). @performance_1268_h4 #Transaction Commit / Durability @performance_1269_p #Durability means transaction committed to the database will not be lost. Some databases (for example MySQL) try to enforce this by default by calling fsync() to flush the buffers, but most hard drives don't actually flush all data. Calling fsync() slows down transaction commit a lot, but doesn't always make data durable. When comparing the results, it is important to think about the effect. Many database suggest to 'batch' operations when possible. This benchmark switches off autocommit when loading the data, and calls commit after each 1000 inserts. However many applications need 'short' transactions at runtime (a commit after each update). This benchmark commits after each update / delete in the simple benchmark, and after each business transaction in the other benchmarks. For databases that support delayed commits, a delay of one second is used. @performance_1270_h4 #Using Prepared Statements @performance_1271_p #Wherever possible, the test cases use prepared statements. @performance_1272_h4 #Currently Not Tested: Startup Time @performance_1273_p #The startup time of a database engine is important as well for embedded use. This time is not measured currently. Also, not tested is the time used to create a database and open an existing database. Here, one (wrapper) connection is opened at the start, and for each step a new connection is opened and then closed. That means the Open/Close time listed is for opening a connection if the database is already in use. @performance_1274_h2 #PolePosition Benchmark @performance_1275_p #The PolePosition is an open source benchmark. The algorithms are all quite simple. It was developed / sponsored by db4o. @performance_1276_th #Test Case @performance_1277_th #Unit @performance_1278_th H2 @performance_1279_th HSQLDB @performance_1280_th MySQL @performance_1281_td #Melbourne write @performance_1282_td #ms @performance_1283_td #369 @performance_1284_td #249 @performance_1285_td #2022 @performance_1286_td #Melbourne read @performance_1287_td #ms @performance_1288_td #47 @performance_1289_td #49 @performance_1290_td #93 @performance_1291_td #Melbourne read_hot @performance_1292_td #ms @performance_1293_td #24 @performance_1294_td #43 @performance_1295_td #95 @performance_1296_td #Melbourne delete @performance_1297_td #ms @performance_1298_td #147 @performance_1299_td #133 @performance_1300_td #176 @performance_1301_td #Sepang write @performance_1302_td #ms @performance_1303_td #965 @performance_1304_td #1201 @performance_1305_td #3213 @performance_1306_td #Sepang read @performance_1307_td #ms @performance_1308_td #765 @performance_1309_td #948 @performance_1310_td #3455 @performance_1311_td #Sepang read_hot @performance_1312_td #ms @performance_1313_td #789 @performance_1314_td #859 @performance_1315_td #3563 @performance_1316_td #Sepang delete @performance_1317_td #ms @performance_1318_td #1384 @performance_1319_td #1596 @performance_1320_td #6214 @performance_1321_td #Bahrain write @performance_1322_td #ms @performance_1323_td #1186 @performance_1324_td #1387 @performance_1325_td #6904 @performance_1326_td #Bahrain query_indexed_string @performance_1327_td #ms @performance_1328_td #336 @performance_1329_td #170 @performance_1330_td #693 @performance_1331_td #Bahrain query_string @performance_1332_td #ms @performance_1333_td #18064 @performance_1334_td #39703 @performance_1335_td #41243 @performance_1336_td #Bahrain query_indexed_int @performance_1337_td #ms @performance_1338_td #104 @performance_1339_td #134 @performance_1340_td #678 @performance_1341_td #Bahrain update @performance_1342_td #ms @performance_1343_td #191 @performance_1344_td #87 @performance_1345_td #159 @performance_1346_td #Bahrain delete @performance_1347_td #ms @performance_1348_td #1215 @performance_1349_td #729 @performance_1350_td #6812 @performance_1351_td #Imola retrieve @performance_1352_td #ms @performance_1353_td #198 @performance_1354_td #194 @performance_1355_td #4036 @performance_1356_td #Barcelona write @performance_1357_td #ms @performance_1358_td #413 @performance_1359_td #832 @performance_1360_td #3191 @performance_1361_td #Barcelona read @performance_1362_td #ms @performance_1363_td #119 @performance_1364_td #160 @performance_1365_td #1177 @performance_1366_td #Barcelona query @performance_1367_td #ms @performance_1368_td #20 @performance_1369_td #5169 @performance_1370_td #101 @performance_1371_td #Barcelona delete @performance_1372_td #ms @performance_1373_td #388 @performance_1374_td #319 @performance_1375_td #3287 @performance_1376_td #Total @performance_1377_td #ms @performance_1378_td #26724 @performance_1379_td #53962 @performance_1380_td #87112 @performance_1381_h2 #Application Profiling @performance_1382_h3 #Analyze First @performance_1383_p #Before trying to optimize the performance, it is important to know where the time is actually spent. The same is true for memory problems. Premature or 'blind' optimization should be avoided, as it is not an efficient way to solve the problem. There are various ways to analyze the application. In some situations it is possible to compare two implementations and use System.currentTimeMillis() to find out which one is faster. But this does not work for complex applications with many modules, and for memory problems. A very good tool to measure both the memory and the CPU is the <a href="http://www.yourkit.com">YourKit Java Profiler</a> . This tool is also used to optimize the performance and memory footprint of this database engine. @performance_1384_h2 #Database Performance Tuning @performance_1385_h3 #Virus Scanners @performance_1386_p #Some virus scanners scan files every time they are accessed. It is very important for performance that database files are not scanned for viruses. The database engine does never interprets the data stored in the files as programs, that means even if somebody would store a virus in a database file, this would be harmless (when the virus does not run, it cannot spread). Some virus scanners allow excluding file endings. Make sure files ending with .db are not scanned. @performance_1387_h3 トレースオプションを使用する @performance_1388_p #If the main performance hot spots are in the database engine, in many cases the performance can be optimized by creating additional indexes, or changing the schema. Sometimes the application does not directly generate the SQL statements, for example if an O/R mapping tool is used. To view the SQL statements and JDBC API calls, you can use the trace options. For more information, see <a href="features.html#trace_options">Using the Trace Options</a> . @performance_1389_h3 #Index Usage @performance_1390_p #This database uses indexes to improve the performance of SELECT, UPDATE and DELETE statements. If a column is used in the WHERE clause of a query, and if an index exists on this column, then the index can be used. Multi-column indexes are used if all or the first columns of the index are used. Both equality lookup and range scans are supported. Indexes are not used to order result sets: The results are sorted in memory if required. Indexes are created automatically for primary key and unique constraints. Indexes are also created for foreign key constraints, if required. For other columns, indexes need to be created manually using the CREATE INDEX statement. @performance_1391_h3 #Optimizer @performance_1392_p #This database uses a cost based optimizer. For simple and queries and queries with medium complexity (less than 7 tables in the join), the expected cost (running time) of all possible plans is calculated, and the plan with the lowest cost is used. For more complex queries, the algorithm first tries all possible combinations for the first few tables, and the remaining tables added using a greedy algorithm (this works well for most joins). Afterwards a genetic algorithm is used to test at most 2000 distinct plans. Only left-deep plans are evaluated. @performance_1393_h3 #Expression Optimization @performance_1394_p #After the statement is parsed, all expressions are simplified automatically if possible. Operations are evaluated only once if all parameters are constant. Functions are also optimized, but only if the function is constant (always returns the same result for the same parameter values). If the WHERE clause is always false, then the table is not accessed at all. @performance_1395_h3 #COUNT(*) Optimization @performance_1396_p #If the query only counts all rows of a table, then the data is not accessed. However, this is only possible if no WHERE clause is used, that means it only works for queries of the form SELECT COUNT(*) FROM table. @performance_1397_h3 #Updating Optimizer Statistics / Column Selectivity @performance_1398_p #When executing a query, at most one index per joined table can be used. If the same table is joined multiple times, for each join only one index is used. Example: for the query SELECT * FROM TEST T1, TEST T2 WHERE T1.NAME='A' AND T2.ID=T1.ID, two index can be used, in this case the index on NAME for T1 and the index on ID for T2. @performance_1399_p #If a table has multiple indexes, sometimes more than one index could be used. Example: if there is a table TEST(ID, NAME, FIRSTNAME) and an index on each column, then two indexes could be used for the query SELECT * FROM TEST WHERE NAME='A' AND FIRSTNAME='B', the index on NAME or the index on FIRSTNAME. It is not possible to use both indexes at the same time. Which index is used depends on the selectivity of the column. The selectivity describes the 'uniqueness' of values in a column. A selectivity of 100 means each value appears only once, and a selectivity of 1 means the same value appears in many or most rows. For the query above, the index on NAME should be used if the table contains more distinct names than first names. @performance_1400_p #The SQL statement ANALYZE can be used to automatically estimate the selectivity of the columns in the tables. This command should be run from time to time to improve the query plans generated by the optimizer. @quickstart_1000_h1 クイックスタート @quickstart_1001_a アプリケーションのエンベッドH2 @quickstart_1002_a H2 コンソール アプリケーション @quickstart_1003_h2 アプリケーションのエンベッドH2 @quickstart_1004_p このデータベースはエンベッドモード、またはサーバーモードで使用可能です。エンベッドモードで使用する場合、以下を行う必要があります: @quickstart_1005_li クラスパスに <code>h2.jar</code> を追加する @quickstart_1006_li JDBCドライバークラスを使用する: <code>org.h2.Driver</code> @quickstart_1007_li データベースURL <code>jdbc:h2:~/test</code> ユーザーホームディレクトリ内の "test" でデータベースを開く @quickstart_1008_h2 H2 コンソール アプリケーション @quickstart_1009_p このコンソールはブラウザインターフェースを使ってSQL データベースにアクセスします。 @quickstart_1010_p Windows XPをご使用でなかったり、期待通りに機能しない場合は、<a href="tutorial.html">チュートリアル</a>内の詳細説明をご覧下さい。 @quickstart_1011_h3 手順 @quickstart_1012_h4 インストール @quickstart_1013_p Windows インストーラーを使用してソフトウェアをインストールしましょう (まだインストールされていない場合)。 @quickstart_1014_h4 コンソールを起動する @quickstart_1015_p <span class="button">スタート</span>、 <span class="button">すべてのプログラム</span>、 <span class="button">H2</span>、 <span class="button">H2 Console (Command Line)</span>をクリックします: @quickstart_1016_p コンソールウィンドウが 開きます: @quickstart_1017_p #Also, a new browser page should open with the URL <a href="http://localhost:8082">http://localhost:8082</a> . You may get a security warning from the firewall. If you don't want other computers in the network to access the database on your machine, you can let the firewall block these connections. Only local connections are required at this time. @quickstart_1018_h4 ログイン @quickstart_1019_p <span class="button">Generic H2</span>を選び、<span class="button">Connect</span>をクリックします: @quickstart_1020_p ログインされました。 @quickstart_1021_h4 サンプル @quickstart_1022_p <span class="button">Sample SQL Script</span>をクリックします。: @quickstart_1023_p SQLコマンドがコマンドエリアに表示されます。 @quickstart_1024_h4 実行する @quickstart_1025_p <span class="button">Run</span>をクリックします: @quickstart_1026_p 左側のデータベースアイコンの下に、 新しいテーブル TEST が追加されます。動作とステートメントの結果は、スクリプトの下に表示されます。 @quickstart_1027_h4 切断 @quickstart_1028_p <span class="button">Disconnect</span>をクリックします: @quickstart_1029_p データベースを閉じます @quickstart_1030_h4 終了 @quickstart_1031_p コンソールウィンドウを閉じます。詳細は<a href="tutorial.html">チュートリアル</a>をご覧下さい。 @roadmap_1000_h1 ロードマップ @roadmap_1001_h2 #Highest Priority @roadmap_1002_li #Improve test code coverage @roadmap_1003_li #More fuzz tests @roadmap_1004_li #Test very large databases and LOBs (up to 256 GB) @roadmap_1005_li #Test multi-threaded in-memory db access @roadmap_1006_h2 #In Version 1.1 @roadmap_1007_li #Add version number. Install directory: h2-1.0, jar file: h2-1.0.jar. Micro version: use build number, staring with 1.1.100 @roadmap_1008_li #Automatic upgrade if there is a file format change @roadmap_1009_li #Change Constants.DEFAULT_MAX_MEMORY_UNDO to 10000 (and change the docs). Test. @roadmap_1010_li #Enable and document optimizations, LOB files in directories @roadmap_1011_li #Special methods for DataPage.writeByte / writeShort and so on @roadmap_1012_li #Index organized tables CREATE TABLE...(...) ORGANIZATION INDEX (store in data file) (probably file format changes are required for rowId) @roadmap_1013_li #Change the default for NULL || 'x' to NULL @roadmap_1014_h2 #Priority 1 @roadmap_1015_li #Write more tests and documentation for MVCC (Multi Version Concurrency Control) @roadmap_1016_li #Row level locking @roadmap_1017_li #RECOVER=1 should automatically recover, =2 should run the recovery tool if required @roadmap_1018_li #More tests with MULTI_THREADED=1 @roadmap_1019_li #Test with Spatial DB in a box / JTS (http://docs.codehaus.org/display/GEOS/SpatialDBBox) @roadmap_1020_li #Optimization: result set caching (like MySQL) @roadmap_1021_li #Server side cursors @roadmap_1022_li #Long running queries / errors / trace system table @roadmap_1023_li #Migrate database tool (also from other database engines) @roadmap_1024_li #Shutdown compact @roadmap_1025_h2 #Priority 2 @roadmap_1026_li #Automatic mode: jdbc:h2:auto: (embedded mode if possible, if not use server mode). Keep the server running until all have disconnected. @roadmap_1027_li #Support function overloading as in Java (multiple functions with the same name, but different parameter count or data types). @roadmap_1028_li #Linked tables that point to the same database should share the connection ([SHARED CONNECTION]). Serialize access to the connection. @roadmap_1029_li #Procedural language / script language (Javascript) @roadmap_1030_li #Linked tables should support a schema name: CREATE LINKED TABLE ... (... [schemaName, ] originalTableString) - DB2: SET SCHEMA after connecting @roadmap_1031_li #Option to shutdown all the running servers (on the same VM). @roadmap_1032_li #Support OSGi: http://oscar-osgi.sourceforge.net, http://incubator.apache.org/felix/index.html @roadmap_1033_li #H2 Console: new option 'Open a browser when starting the H2 Console'. @roadmap_1034_li #Better space re-use in the files after deleting data: shrink the data file without closing the database (if the end of the file is empty) @roadmap_1035_li #Full outer joins @roadmap_1036_li #Support hints for the optimizer (which index to use, enforce the join order). @roadmap_1037_li #Change LOB mechanism (less files, keep index of lob files, point to files and row, delete unused files earlier, maybe bundle files into a tar file) @roadmap_1038_li #Clustering: recovery needs to becomes fully automatic. Global write lock feature. @roadmap_1039_li #Option for Java functions: constant/isDeterministic/readonly/pure (always return the same value) to allow early evaluation when all parameters are constant @roadmap_1040_li #Deferred integrity checking (DEFERRABLE INITIALLY DEFERRED) @roadmap_1041_li #Groovy Stored Procedures (http://groovy.codehaus.org/Groovy+SQL) @roadmap_1042_li #System table / function: cache usage @roadmap_1043_li #Add a migration guide (list differences between databases) @roadmap_1044_li #Optimization: automatic index creation suggestion using the trace file? @roadmap_1045_li #Compression performance: don't allocate buffers, compress / expand in to out buffer @roadmap_1046_li #Start / stop server with database URL @roadmap_1047_li #Sequence: add features [NO] MINVALUE, MAXVALUE, CYCLE @roadmap_1048_li #Rebuild index functionality (other than delete the index file) @roadmap_1049_li #Don't use deleteOnExit (bug 4513817: File.deleteOnExit consumes memory) @roadmap_1050_li #Console: add accesskey to most important commands (A, AREA, BUTTON, INPUT, LABEL, LEGEND, TEXTAREA) @roadmap_1051_li #Feature: a setting to delete the the log or not (for backup) @roadmap_1052_li #Test with Sun ASPE1_4; JEE Sun AS PE1.4 @roadmap_1053_li #Test performance again with SQL Server, Oracle, DB2 @roadmap_1054_li #Test with dbmonster (http://dbmonster.kernelpanic.pl/) @roadmap_1055_li #Test with dbcopy (http://dbcopyplugin.sourceforge.net) @roadmap_1056_li #Find a tool to view a text file >100 MB, with find, page up and down (like less) @roadmap_1057_li #Implement, test, document XAConnection and so on @roadmap_1058_li #Web site: get rid of frame set @roadmap_1059_li #Pluggable data type (for compression, validation, conversion, encryption) @roadmap_1060_li #CHECK: find out what makes CHECK=TRUE slow, move to CHECK2 @roadmap_1061_li #Improve recovery: improve code for log recovery problems (less try/catch) @roadmap_1062_li #Index usage for (ID, NAME)=(1, 'Hi'); document @roadmap_1063_li #Suggestion: include Jetty as Servlet Container (like LAMP) @roadmap_1064_li #Trace shipping to server @roadmap_1065_li #Performance / server mode: use UDP optionally? @roadmap_1066_li #Version check: docs / web console (using Javascript), and maybe in the library (using TCP/IP) @roadmap_1067_li #Web server classloader: override findResource / getResourceFrom @roadmap_1068_li #Cost for embedded temporary view is calculated wrong, if result is constant @roadmap_1069_li #Comparison: pluggable sort order: natural sort @roadmap_1070_li #Count index range query (count(*) where id between 10 and 20) @roadmap_1071_li #Eclipse plugin @roadmap_1072_li #Asynchronous queries to support publish/subscribe: SELECT ... FOR READ WAIT [maxMillisToWait] @roadmap_1073_li #iReport to support H2 @roadmap_1074_li #Implement missing JDBC API (CallableStatement,...) @roadmap_1075_li #Compression of the cache @roadmap_1076_li #Include SMPT (mail) server (at least client) (alert on cluster failure, low disk space,...) @roadmap_1077_li #Drop with restrict (currently cascade is the default) @roadmap_1078_li #JSON parser and functions @roadmap_1079_li #Automatic collection of statistics (auto ANALYZE) @roadmap_1080_li #Server: client ping from time to time (to avoid timeout - is timeout a problem?) @roadmap_1081_li #Copy database: Tool with config GUI and batch mode, extensible (example: compare) @roadmap_1082_li #Document, implement tool for long running transactions using user-defined compensation statements @roadmap_1083_li #Support SET TABLE DUAL READONLY @roadmap_1084_li #Linked schema using CSV files: one schema for a directory of files; support indexes for CSV files @roadmap_1085_li #Don't write stack traces for common exceptions like duplicate key to the log by default @roadmap_1086_li #GCJ: what is the state now? @roadmap_1087_li #Use Janino to convert Java to C++ @roadmap_1088_li #Reduce disk space usage (Derby uses less disk space?) @roadmap_1089_li #Events for: Database Startup, Connections, Login attempts, Disconnections, Prepare (after parsing), Web Server (see http://docs.openlinksw.com/virtuoso/fn_dbev_startup.html) @roadmap_1090_li #Optimization: Log compression @roadmap_1091_li #Support standard INFORMATION_SCHEMA tables, as defined in http://www.contrib.andrew.cmu.edu/~shadow/sql/sql1992.txt; specially KEY_COLUMN_USAGE (http://dev.mysql.com/doc/refman/5.0/en/information-schema.html, http://www.xcdsql.org/Misc/INFORMATION_SCHEMA%20With%20Rolenames.gif) @roadmap_1092_li #Compatibility: in MySQL, HSQLDB, /0.0 is NULL; in PostgreSQL, Derby: Division by zero @roadmap_1093_li #Functional tables should accept parameters from other tables (see FunctionMultiReturn) SELECT * FROM TEST T, P2C(T.A, T.R) @roadmap_1094_li #Custom class loader to reload functions on demand @roadmap_1095_li #Test http://mysql-je.sourceforge.net/ @roadmap_1096_li #Close all files when closing the database (including LOB files that are open on the client side) @roadmap_1097_li #EXE file: maybe use http://jsmooth.sourceforge.net @roadmap_1098_li #Performance: Automatically build in-memory indexes if the whole table is in memory @roadmap_1099_li #H2 Console: The webclient could support more features like phpMyAdmin. @roadmap_1100_li #The HELP information schema can be directly exposed in the Console @roadmap_1101_li #Maybe use the 0x1234 notation for binary fields, see MS SQL Server @roadmap_1102_li #Support Oracle CONNECT BY in some way: http://www.adp-gmbh.ch/ora/sql/connect_by.html, http://philip.greenspun.com/sql/trees.html @roadmap_1103_li #SQL 2003 (http://www.wiscorp.com/sql_2003_standard.zip) @roadmap_1104_li #http://www.jpackage.org @roadmap_1105_li #Version column (number/sequence and timestamp based) @roadmap_1106_li #Optimize getGeneratedKey: send last identity after each execute (server). @roadmap_1107_li #Date: default date is '1970-01-01' (is it 1900-01-01 in the standard / other databases?) @roadmap_1108_li #Test and document UPDATE TEST SET (ID, NAME) = (SELECT ID*10, NAME || '!' FROM TEST T WHERE T.ID=TEST.ID); @roadmap_1109_li #Max memory rows / max undo log size: use block count / row size not row count @roadmap_1110_li #Support 123L syntax as in Java; example: SELECT (2000000000*2) @roadmap_1111_li #Implement point-in-time recovery @roadmap_1112_li #Include the version name in the jar file name @roadmap_1113_li #Optimize ID=? OR ID=?: convert to IN(...) @roadmap_1114_li #LIKE: improved version for larger texts (currently using naive search) @roadmap_1115_li #Auto-reconnect on lost connection to server (even if the server was re-started) except if autocommit was off and there was pending transaction @roadmap_1116_li #The Script tool should work with other databases as well @roadmap_1117_li #Automatically convert to the next 'higher' data type whenever there is an overflow. @roadmap_1118_li #Throw an exception when the application calls getInt on a Long (optional) @roadmap_1119_li #Default date format for input and output (local date constants) @roadmap_1120_li #ValueInt.convertToString and so on (remove Value.convertTo) @roadmap_1121_li #Support custom Collators @roadmap_1122_li #Document ROWNUM usage for reports: SELECT ROWNUM, * FROM (subquery) @roadmap_1123_li #Clustering: Reads should be randomly distributed or to a designated database on RAM @roadmap_1124_li #Clustering: When a database is back alive, automatically synchronize with the master @roadmap_1125_li #Standalone tool to get relevant system properties and add it to the trace output. @roadmap_1126_li #Support mixed clustering mode (one embedded, the other server mode) @roadmap_1127_li #Support 'call proc(1=value)' (PostgreSQL, Oracle) @roadmap_1128_li #JAMon (proxy jdbc driver) @roadmap_1129_li #Console: Improve editing data (Tab, Shift-Tab, Enter, Up, Down, Shift+Del?) @roadmap_1130_li #Console: Autocomplete Ctrl+Space inserts template @roadmap_1131_li #Simplify translation ('Donate a translation') @roadmap_1132_li #Option to encrypt .trace.db file @roadmap_1133_li #Write Behind Cache on SATA leads to data corruption See also http://sr5tech.com/write_back_cache_experiments.htm and http://www.jasonbrome.com/blog/archives/2004/04/03/writecache_enabled.html @roadmap_1134_li #Functions with unknown return or parameter data types: serialize / deserialize @roadmap_1135_li #Test if idle TCP connections are closed, and how to disable that @roadmap_1136_li #Try using a factory for Row, Value[] (faster?), http://javolution.org/, alternative ObjectArray / IntArray @roadmap_1137_li #Auto-Update feature for database, .jar file @roadmap_1138_li #ResultSet SimpleResultSet.readFromURL(String url): id varchar, state varchar, released timestamp @roadmap_1139_li #RANK() and DENSE_RANK(), Partition using OVER() @roadmap_1140_li #ROW_NUMBER (not the same as ROWNUM) @roadmap_1141_li #Partial indexing (see PostgreSQL) @roadmap_1142_li #The build should fail if the test fails @roadmap_1143_li #http://rubyforge.org/projects/hypersonic/ @roadmap_1144_li #DbVisualizer profile for H2 @roadmap_1145_li #Add comparator (x === y) : (x = y or (x is null and y is null)) @roadmap_1146_li #Try to create trace file even for read only databases @roadmap_1147_li #Add a sample application that runs the H2 unit test and writes the result to a file (so it can be included in the user app) @roadmap_1148_li #Count on a column that can not be null would be optimized to COUNT(*) @roadmap_1149_li #Table order: ALTER TABLE TEST ORDER BY NAME DESC (MySQL compatibility) @roadmap_1150_li #Backup tool should work with other databases as well @roadmap_1151_li #Console: -ifExists doesn't work for the console. Add a flag to disable other dbs @roadmap_1152_li #Improved full text search (supports LOBs, reader / tokenizer / filter). @roadmap_1153_li #Performance: Update in-place @roadmap_1154_li #Check if 'FSUTIL behavior set disablelastaccess 1' improves the performance (fsutil behavior query disablelastaccess) @roadmap_1155_li #Java static code analysis: http://pmd.sourceforge.net/ @roadmap_1156_li #Java static code analysis: http://www.eclipse.org/tptp/ @roadmap_1157_li #Compatibility for CREATE SCHEMA AUTHORIZATION @roadmap_1158_li #Implement Clob / Blob truncate and the remaining functionality @roadmap_1159_li #Maybe close LOBs after closing connection @roadmap_1160_li #Tree join functionality @roadmap_1161_li #Support alter table add column if table has views defined @roadmap_1162_li #Add multiple columns at the same time with ALTER TABLE .. ADD .. ADD .. @roadmap_1163_li #Support trigger on the tables information_schema.tables and ...columns @roadmap_1164_li #Add H2 to Gem (Ruby install system) @roadmap_1165_li #API for functions / user tables @roadmap_1166_li #Order conditions inside AND / OR to optimize the performance @roadmap_1167_li #Support linked JCR tables @roadmap_1168_li #Make sure H2 is supported by Execute Query: http://executequery.org/ @roadmap_1169_li #Read InputStream when executing, as late as possible (maybe only embedded mode). Problem with re-execute. @roadmap_1170_li #Full text search: min word length; store word positions @roadmap_1171_li #FTP Server: Implement a client to send / receive files to server (dir, get, put) @roadmap_1172_li #FTP Server: Implement SFTP / FTPS @roadmap_1173_li #Add an option to the SCRIPT command to generate only portable / standard SQL @roadmap_1174_li #Test Dezign for Databases (http://www.datanamic.com) @roadmap_1175_li #Fast library for parsing / formatting: http://javolution.org/ @roadmap_1176_li #Updatable Views (simple cases first) @roadmap_1177_li #Improve create index performance @roadmap_1178_li #Support ARRAY data type @roadmap_1179_li #Implement more JDBC 4.0 features @roadmap_1180_li #Support TRANSFORM / PIVOT as in MS Access @roadmap_1181_li #SELECT * FROM (VALUES (...), (...), ....) AS alias(f1, ...) @roadmap_1182_li #Support updatable views with join on primary keys (to extend a table) @roadmap_1183_li #Public interface for functions (not public static) @roadmap_1184_li #Autocomplete: if I type the name of a table that does not exist (should say: syntax not supported) @roadmap_1185_li #Document FTP server, including -ftpTask option to execute / kill remote processes @roadmap_1186_li #Eliminate undo log records if stored on disk (just one pointer per block, not per record) @roadmap_1187_li #Feature matrix like in <a href="http://www.inetsoftware.de/products/jdbc/mssql/features/default.asp">i-net software</a> . @roadmap_1188_li #Updatable result set on table without primary key or unique index @roadmap_1189_li #Use LinkedList instead of ArrayList where applicable @roadmap_1190_li #Support % operator (modulo) @roadmap_1191_li #Support 1+'2'=3, '1'+'2'='12' (MS SQL Server compatibility) @roadmap_1192_li #Support nested transactions @roadmap_1193_li #Add a benchmark for big databases, and one for many users @roadmap_1194_li #Compression in the result set (repeating values in the same column) @roadmap_1195_li #Support curtimestamp (like curtime, curdate) @roadmap_1196_li #Support ANALYZE {TABLE|INDEX} tableName COMPUTE|ESTIMATE|DELETE STATISTICS ptnOption options @roadmap_1197_li #Support Sequoia (Continuent.org) @roadmap_1198_li #Dynamic length numbers / special methods for DataPage.writeByte / writeShort / Ronni Nielsen @roadmap_1199_li #Pluggable ThreadPool, (AvalonDB / deebee / Paul Hammant) @roadmap_1200_li #Recursive Queries (see details) @roadmap_1201_li #Add GUI to build a custom version (embedded, fulltext,...) @roadmap_1202_li #Release locks (shared or exclusive) on demand @roadmap_1203_li #Support OUTER UNION @roadmap_1204_li #Support Parameterized Views (similar to CSVREAD, but using just SQL for the definition) @roadmap_1205_li #A way (JDBC driver) to map an URL (jdbc:h2map:c1) to a connection object @roadmap_1206_li #Option for SCRIPT to only process one or a set of tables, and append to a file @roadmap_1207_li #Support using a unique index for IS NULL (including linked tables) @roadmap_1208_li #Support linked tables to the current database @roadmap_1209_li #Support dynamic linked schema (automatically adding/updating/removing tables) @roadmap_1210_li #Compatibility with Derby: VALUES(1), (2); SELECT * FROM (VALUES (1), (2)) AS myTable(c1) @roadmap_1211_li #Compatibility: # is the start of a single line comment (MySQL) but date quote (Access). Mode specific @roadmap_1212_li #Run benchmarks with JDK 1.5, JDK 1.6, java -server @roadmap_1213_li #Optimizations: Faster hash function for strings, byte arrays, big decimal @roadmap_1214_li #DatabaseEventListener: callback for all operations (including expected time, RUNSCRIPT) and cancel functionality @roadmap_1215_li #H2 Console / large result sets: use 'streaming' instead of building the page in-memory @roadmap_1216_li #Benchmark: add a graph to show how databases scale (performance/database size) @roadmap_1217_li #Implement a SQLData interface to map your data over to a custom object @roadmap_1218_li #Make DDL (Data Definition) operations transactional @roadmap_1219_li #Allow execution time prepare for SELECT * FROM CSVREAD(?, 'columnNameString') @roadmap_1220_li #Support multiple directories (on different hard drives) for the same database @roadmap_1221_li #Server protocol: use challenge response authentication, but client sends hash(user+password) encrypted with response @roadmap_1222_li #Support EXEC[UTE] (doesn't return a result set, compatible to MS SQL Server) @roadmap_1223_li #GROUP BY and DISTINCT: support large groups (buffer to disk), do not keep large sets in memory @roadmap_1224_li #Support native XML data type @roadmap_1225_li #Support triggers with a string property or option: SpringTrigger, OSGITrigger @roadmap_1226_li #Clustering: adding a node should be very fast and without interrupting clients (very short lock) @roadmap_1227_li #Support materialized views (using triggers) @roadmap_1228_li #Store dates in local time zone (portability of database files) @roadmap_1229_li #Ability to resize the cache array when resizing the cache @roadmap_1230_li #Time based cache writing (one second after writing the log) @roadmap_1231_li #Check state of H2 driver for DDLUtils: https://issues.apache.org/jira/browse/DDLUTILS-185 @roadmap_1232_li #Index usage for REGEXP LIKE. @roadmap_1233_li #Add a role DBA (like ADMIN). @roadmap_1234_li #Better support multiple processors for in-memory databases. @roadmap_1235_li #Access rights: remember the owner of an object. COMMENT: allow owner of object to change it. @roadmap_1236_li #Implement INSTEAD OF trigger. @roadmap_1237_li #Access rights: Finer grained access control (grant access for specific functions) @roadmap_1238_li #Support N'text' @roadmap_1239_li #Support SCOPE_IDENTITY() to avoid problems when inserting rows in a trigger @roadmap_1240_li #Set a connection read only (Connection.setReadOnly) @roadmap_1241_li #In MySQL mode, for AUTO_INCREMENT columns, don't set the primary key @roadmap_1242_li #Use JDK 1.4 file locking to create the lock file (but not yet by default); writing a system property to detect concurrent access from the same VM (different classloaders). @roadmap_1243_li #Support compatibility for jdbc:hsqldb:res: @roadmap_1244_li #In the MySQL and PostgreSQL, use lower case identifiers by default (DatabaseMetaData.storesLowerCaseIdentifiers = true) @roadmap_1245_li #Provide a simple, lightweight O/R mapping tool @roadmap_1246_li #Provide an Java SQL builder with standard and H2 syntax @roadmap_1247_li #Trace: write OS, file system, JVM,... when opening the database @roadmap_1248_li #Support indexes for views (probably requires materialized views) @roadmap_1249_li #Document SET SEARCH_PATH, BEGIN, EXECUTE, parameters @roadmap_1250_li #Browser: use Desktop.isDesktopSupported and browse when using JDK 1.6 @roadmap_1251_li #Server: use one listener (detect if the request comes from an PG or TCP client) @roadmap_1252_li #Store dates as 'local'. Existing files use GMT. Use escape syntax for compatibility. @roadmap_1253_li #Support data type INTERVAL @roadmap_1254_li #NATURAL JOIN: MySQL and PostgreSQL don't repeat columns when using SELECT * ... @roadmap_1255_li #Optimize SELECT MIN(ID), MAX(ID), COUNT(*) FROM TEST WHERE ID BETWEEN 100 AND 200 @roadmap_1256_li #Support Oracle functions: TRUNC, NVL2, TO_CHAR, TO_DATE, TO_NUMBER @roadmap_1257_li #Sequence: PostgreSQL compatibility (rename, create) (http://www.postgresql.org/docs/8.2/static/sql-altersequence.html) @roadmap_1258_li #DISTINCT: Support large result sets by sorting on all columns (additionally) and then removing duplicates. @roadmap_1259_li #File system that writes to two file systems (replicating file system) @roadmap_1260_li #File system with a background writer thread; test if this is faster @roadmap_1261_li #FTP access to a database (.csv for a table, a directory for a schema, a file for a lob, a script.sql file). @roadmap_1262_li #LIMIT and OFFSET for GROUP_CONCAT @roadmap_1263_li #Support triggers for INFORMATION_SCHEMA tables (to better support PostgreSQL catalog: rebuild after creating new tables) @roadmap_1264_li #Better document the source code @roadmap_1265_li #Support select * from dual a left join dual b on b.x=(select max(x) from dual) @roadmap_1266_li #Optimization: don't lock when the database is read-only @roadmap_1267_li #Integrate spatial functions from http://geosysin.iict.ch/irstv-trac/wiki/H2spatial/Download @roadmap_1268_li #Support COSH, SINH, and TANH functions @roadmap_1269_li #Native search: support "phrase search", wildcard search (* and ?), case-insensitive search, boolean operators, and grouping @roadmap_1270_li #Improve documentation of access rights @roadmap_1271_li #Support ENUM data type (see MySQL, PostgreSQL, MS SQL Server, maybe others) @roadmap_1272_li #Command line option for the H2 Console and TCP configuration (which .h2.server.properties and .h2.keystore to use) @roadmap_1273_li #Support a schema name for Java functions @roadmap_1274_li #Remember the domain of a column @roadmap_1275_li #Support Jackcess (MS Access databases) @roadmap_1276_li #Built-in methods to write large objects (BLOB and CLOB): FILE_WRITE('test.txt', 'Hello World') @roadmap_1277_li #Change package name in version 2.0: org.h2database @roadmap_1278_li #MVCC: support transactionally consistent backups using SCRIPT @roadmap_1279_li #Improve time to open large databases (see mail 'init time for distributed setup') @roadmap_1280_li #Use ARRAY for fulltext search return value, at least internally in the native implementation (and as an option for the user) @roadmap_1281_li #Move Maven 2 repository from hsql.sf.net to h2database.sf.net @roadmap_1282_li #Java 1.5 tool: JdbcUtils.closeSilently(s1, s2,...) @roadmap_1283_li #Javadoc: document design patterns used @roadmap_1284_li #Triggers for metadata tables; use for PostgreSQL catalog @roadmap_1285_li #Does the FTP server has problems with multithreading? @roadmap_1286_li #Write an article about SQLInjection (h2\src\docsrc\html\images\SQLInjection.txt) @roadmap_1287_li #Convert SQL-injection-2.txt to html document, include SQLInjection.java sample @roadmap_1288_li #Send SQL Injection solution proposal to MySQL, Derby, HSQLDB,... @roadmap_1289_li #Improve LOB in directories performance @roadmap_1290_li #Web site design: http://www.igniterealtime.org/projects/openfire/index.jsp @roadmap_1291_li #HSQLDB compatibility: Openfire server uses: CREATE SCHEMA PUBLIC AUTHORIZATION DBA; CREATE USER SA PASSWORD ""; GRANT DBA TO SA; SET SCHEMA PUBLIC @roadmap_1292_li #Web site: Rename Performance to Comparison [/Compatibility], move Comparison to Other Database Engines to Comparison, move Products that Work with H2 to Comparison, move Performance Tuning to Advanced Topics @roadmap_1293_li #Translation: use ?? in help.csv @roadmap_1294_li #Translated .pdf @roadmap_1295_li #Cluster: hot deploy (adding a node on runtime) @roadmap_1296_li #Test with PostgreSQL Version 8.2 @roadmap_1297_li #Website: Don't use frames. @roadmap_1298_li #Try again with Lobo browser (pure Java) @roadmap_1299_li #Recovery tool: bad blocks should be converted to INSERT INTO SYSTEM_ERRORS(...), and things should go into the .trace.db file @roadmap_1300_li #RECOVER=2 to backup the database, run recovery, open the database @roadmap_1301_li #Recovery should work with encrypted databases @roadmap_1302_li #Corruption: new error code, add help @roadmap_1303_li #Space reuse: after init, scan all storages and free those that don't belong to a live database object @roadmap_1304_li #SysProperties: change everything to H2_... @roadmap_1305_li #Use FilterIn / FilterOut putStream? @roadmap_1306_li #Access rights: add missing features (users should be 'owner' of objects; missing rights for sequences; dropping objects) @roadmap_1307_li #Support NOCACHE table option (Oracle) @roadmap_1308_li #Index usage for UPDATE ... WHERE .. IN (SELECT...) @roadmap_1309_li #Add regular javadocs (using the default doclet, but another css) to the homepage. @roadmap_1310_li #The database should be kept open for a longer time when using the server mode. @roadmap_1311_li #Javadocs: for each tool, add a copy & paste sample in the class level. @roadmap_1312_li #Javadocs: add @author tags. @roadmap_1313_li #Fluent API for tools: Server.createTcpServer().setPort(9081).setPassword(password).start(); @roadmap_1314_li #MySQL compatibility: real SQL statements for SHOW TABLES, DESCRIBE TEST (then remove from Shell) @roadmap_1315_li #Use a default delay of 1 second before closing a database. @roadmap_1316_li #Maven: upload source code and javadocs as well. @roadmap_1317_li #Write (log) to system table before adding to internal data structures. @roadmap_1318_li #Support very large deletes and updates. @roadmap_1319_li #Doclet (javadocs): constructors are not listed. @roadmap_1320_li #Support direct lookup for MIN and MAX when using WHERE (see todo.txt / Direct Lookup). @roadmap_1321_li #Support other array types (String[], double[]) in PreparedStatement.setObject(int, Object); @roadmap_1322_li #MVCC should not be memory bound (uncommitted data is kept in memory in the delta index; maybe using a regular btree index solves the problem). @roadmap_1323_li #Support CREATE TEMPORARY LINKED TABLE. @roadmap_1324_li #MySQL compatibility: SELECT @variable := x FROM SYSTEM_RANGE(1, 50); @roadmap_1325_li #Oracle compatibility: support NLS_DATE_FORMAT. @roadmap_1326_li #Support flashback queries as in Oracle. @roadmap_1327_li #Import / Export of fixed with text files. @roadmap_1328_li #Support for OUT parameters in user-defined procedures. @roadmap_1329_li #Support getGeneratedKeys to return multiple rows when used with batch updates. This is supported by MySQL, but not Derby. Both PostgreSQL and HSQLDB don't support getGeneratedKeys. Also support it when using INSERT ... SELECT. @roadmap_1330_li #HSQLDB compatibility: automatic data type for SUM if value is the value is too big (by default use the same type as the data). @roadmap_1331_li #Improve the optimizer to select the right index for special cases: where id between 2 and 4 and booleanColumn @roadmap_1332_li #Enable warning for 'Local variable declaration hides another field or variable'. @roadmap_1333_li #Linked tables: make hidden columns available (Oracle: rowid and ora_rowscn columns). @roadmap_1334_li #Support merge join. @roadmap_1335_li #H2 Console: in-place autocomplete (need to merge query and result frame, use div). @roadmap_1336_h2 #Not Planned @roadmap_1337_li #HSQLDB (did) support this: select id i from test where i>0 (other databases don't). Supporting it may break compatibility. @roadmap_1338_li #String.intern (so that Strings can be compared with ==) will not be used because some VMs have problems when used extensively. @search_1000_b 検索: @search_1001_td Highlight keyword(s) @search_1002_a ホーム @search_1003_a クイックスタート @search_1004_a インストール @search_1005_a チュートリアル @search_1006_a 特徴 @search_1007_a パフォーマンス @search_1008_a 進歩したトピックス @search_1009_b 参照 @search_1010_a SQL文法 @search_1011_a 関数 @search_1012_a データ型 @search_1013_a Javadoc @search_1014_a PDFドキュメント @search_1015_a #Error Analyzer @search_1016_b 付録 @search_1017_a ビルド @search_1018_a 歴史とロードマップ @search_1019_a #Links @search_1020_a FAQ @search_1021_a ライセンス @sourceError_1000_h1 #Online Error Analyzer @sourceError_1001_a #Input @sourceError_1002_h2 # <a href="javascript:select('details')" id="detailsTab">Details</a> <a href="javascript:select('source')" id="sourceTab">Source Code</a> @sourceError_1003_p #Fill in the error message and stack trace and click on 'Details' or 'Source Code': @sourceError_1004_b #Error Code: @sourceError_1005_b #Product Version: @sourceError_1006_b メッセージ: @sourceError_1007_b #More Information: @sourceError_1008_b #Stack Trace: @sourceError_1009_b #Source File: @sourceError_1010_p #Raw file @sourceError_1011_p #(fast; only Firefox) @tutorial_1000_h1 チュートリアル @tutorial_1001_a 起動とH2コンソールの使用 @tutorial_1002_a JDBCを使用してデータベースに接続 @tutorial_1003_a 新しいデータベースを作成する @tutorial_1004_a サーバーを使用する @tutorial_1005_a Hibernateを使用する @tutorial_1006_a Webアプリケーションで データベースを使用する @tutorial_1007_a CSV (Comma Separated Values) サポート @tutorial_1008_a アップグレード、 バックアップ、修復 @tutorial_1009_a #Command Line Tools @tutorial_1010_a OpenOffice Baseを使用する @tutorial_1011_a Java Web Start / JNLP @tutorial_1012_a #Using a Connection Pool @tutorial_1013_a フルテキストサーチ @tutorial_1014_a #User-Defined Variables @tutorial_1015_a #Date and Time @tutorial_1016_h2 起動とH2コンソールの使用 @tutorial_1017_p このアプリケーションはブラウザインターフェースを使ってSQLデータベースにアクセスします。 これは、H2データベース、またはJDBC APIをサポートする別のデータベースであるかもしれません。 @tutorial_1018_p これはクライアント / サーバーアプリケーションで、サーバーとクライアントの両方実行されることが必要です。 @tutorial_1019_p プラットフォームと環境によって、アプリケーションの起動方法が多数あります: @tutorial_1020_th OS @tutorial_1021_th 起動 @tutorial_1022_td Windows @tutorial_1023_td [スタート]、 [すべてのプログラム]、 [H2]、 [H2 Console]をクリックします @tutorial_1024_td 正しく動作したら、 システムトレイにアイコンが追加されます: @tutorial_1025_td システムトレイアイコンが表示されなかったら、 Javaが正しくインストールされていないのかもしれません。 (この場合は、 他のアプリケーション起動方法を試して下さい) ブラウザウィンドウが開き、ログインページが表示されます。 (URL: http://localhost:8082/) @tutorial_1026_td Windows @tutorial_1027_td ファイルブラウザを開き、h2/binフォルダまで進み、h2.batをダブルクリックします。 @tutorial_1028_td 正しく動作したら、システムトレイにアイコンが追加されます。 問題があれば、コンソールウィンドウにエラーメッセージが表示されます。 ブラウザウィンドウが開き、ログインページが表示されます。 (URL: http://localhost:8082/) @tutorial_1029_td Any @tutorial_1030_td コンソールウィンドウを開き、'h2/lib'ディレクトリまで進み、下記を実行します: @tutorial_1031_h3 ファイアウォール @tutorial_1032_p サーバーを起動させたら、ファイアウォールによるセキュリティ警告を受けるでしょう (1度インストールした場合)。外部ネットワークからあなたのマシンのデータベースにアクセスされたくないのであれば、ファイアーウォールが他の接続を遮断します。ローカルマシンからの接続はまだつながっています。他のコンピュータから、このコンピューターのデータベースにアクセスしたい場合のみ、 ファイアウォールでリモート接続を許可する必要があります。 @tutorial_1033_p 小さなファイアーウォールはすでにサーバーに組み込まれています。 デフォルトによるこの構造は、他のコンピューターがサーバーにアクセスすることを許可していません。 これは、好きなように変更することができます (他のコンピューターからの接続を許可します)。 @tutorial_1034_h3 ネイティブ バージョン @tutorial_1035_p ネイティブ バージョンはJavaを必要としていません。なぜなら、これはGCJを使用してコンパイルされるからです。しかし、H2は現在、Windows上のGCJプロジェクトでは実行されません。異なったプラットフォームでソフトウェアをコンパイルすることが可能です。 @tutorial_1036_h3 Javaをテストする @tutorial_1037_p インストールしたJavaのバージョンを調べるためには、 コマンドプロンプトを開き、 下記を入力します: @tutorial_1038_p もしエラーメッセージが表示されたら、Javaのバイナリディレクトリを環境変数のPathに追加します。 @tutorial_1039_h3 エラーメッセージ 'Port is in use' @tutorial_1040_p ひとつのH2コンソールのみ起動することができます。 そうでなければ、次のようなエラーメッセージが表示されます: <code>Port is in use, maybe another ... server already running on...</code> 複数のコンソールアプリケーションを同じコンピューターで起動することは可能です (異なったポートを使用します)、しかし、コンソールが複数の同時接続を維持するということは、普通は必要とされていません。 @tutorial_1041_h3 他のポートを使用する @tutorial_1042_p もしポートが他のアプリケーションによって使用されている場合は、H2コンソールを異なったポートで起動したいはずです。これは、.h2.server.properties.ファイル内のポートを変更することにより実行できます。このファイルはユーザディレクトリ内に格納されています (Windowsでは通常、"Documents and Settings/<ユーザ名>")。関連する項目はwebPortです。 @tutorial_1043_h3 起動成功 @tutorial_1044_p コンソールウィンドウからのサーバー起動が成功したら、新しいウィンドウが開き、 下記のように表示されます: @tutorial_1045_p ウィンドウ内をクリックしないで下さい; アプリケーションが遮断されてしまいます (Fast-Edit モードが有効の場合)。 @tutorial_1046_h3 ブラウザを使用してサーバーに接続 @tutorial_1047_p #If the server started successfully, you can connect to it using a web browser. The browser needs to support JavaScript, frames and cascading stylesheets (css). If you started the server on the same computer as the browser, go to http://localhost:8082 in the browser. If you want to connect to the application from another computer, you need to provide the IP address of the server, for example: <a href="http://192.168.0.2:8082">http://192.168.0.2:8082</a> . If you enabled SSL on the server side, the URL needs to start with HTTPS. @tutorial_1048_h3 複数の同時セッション @tutorial_1049_p 複数の同時ブラウザセッションがサポートされています。 データベースオブジェクトはサーバーに属しているため、同時接続の数はサーバーアプリケーションの利用可能メモリによって制限されています。 @tutorial_1050_h3 アプリケーションプロパティ @tutorial_1051_p サーバーを起動するとローカルのホームディレクトリに .h2.server.properties と呼ばれるファイル構成が作成されます。Windowsのインストールでは、このファイルは will be in the directory C:\Documents and Settings\[ユーザ名]のディレクトリ内にあります。このファイルはアプリケーションのセッティングに含まれています。 @tutorial_1052_h3 ログイン @tutorial_1053_p ログインページでは、データベースに接続するための接続情報を設定する必要があります。 JDBCドライバをデータベースのクラスに設定し、JDBCのURL、ユーザ名とパスワードを入力します。 完了したら [Connect] をクリックします。 @tutorial_1054_p 保存された設定をあらかじめ保存し、再び使用することができます。設定はアプリケーションプロパティファイルに記憶されます。 @tutorial_1055_h3 エラーメッセージ @tutorial_1056_p エラーメッセージは赤で表示されます。 メッセージをクリックすることによって、例外の記録の表示、非表示を切り替えることができます。 @tutorial_1057_h3 データベースドライバの追加 @tutorial_1058_p H2DRIVERSかCLASSPATHの環境変数に、ドライバのJarファイルの位置を追加することにより、データベースドライバの追加を行うことができます。 例 (Windowsの場合): データベースドライバのライブラリに C:\Programs\hsqldb\lib\hsqldb.jar を追加し、H2DRIVERSの環境変数に C:\Programs\hsqldb\lib\hsqldb.jar を設定します。 @tutorial_1059_p 複数のドライバを設定することも可能です; それぞれのパスは ';' (Windows) や ':' (他のOS) で区切ります。 パス名内のスペースは有効です。設定は引用されません。 @tutorial_1060_h3 アプリケーションを使用する @tutorial_1061_p アプリケーションは3つのメインパネルを保持しています。上部のツールバー、左側のツリーとクエリ、右側の結果表示パネルです。データベースオブジェクト (例; テーブル) は左側のパネルに一覧表示されます。クエリパネルにSQLコマンドを打ち、 'Run' をクリックします。 コマンドの結果は、コマンドのすぐ下に表示されます。 @tutorial_1062_h3 テーブル名、またはカラム名をインサートする @tutorial_1063_p テーブル名やカラム名は、ツリー内のテーブル名、カラム名をクリックすることによってスクリプトにインサートすることができます。クエリが空の時にテーブルをクリックすると、 'SELECT * FROM ...' も同様に追加されます。 クエリを入力している間、使用されているテーブルはツリー内で自動的に拡張されます。例えば、 'SELECT * FROM TEST T WHERE T.' と入力すると、ツリー内のTESTテーブルは自動的に拡張されます。 @tutorial_1064_h3 切断とアプリケーションの終了 @tutorial_1065_p ブラウザでは、ツールバーパネルの 'Disconnect' をクリックします。データベースからログアウトします。しかし、サーバーはまだ接続されていて、 新しいセッションを受け入れる準備をしています。 @tutorial_1066_p サーバーを止めるためには、システムトレイアイコンを右クリックし、 [Exit] を選択します。もしアイコンが表示されていないのであれば、 (別の方法で実行した場合) サーバーが実行されたコンソール上で [Ctrl]+[C] を押すか (Windowsの場合)、コンソールウィンドウを閉じます。 @tutorial_1067_h2 JDBCを使用してデータベースに接続 @tutorial_1068_p #To connect to a database, a Java application first needs to load the database driver, and then get a connection. A simple way to do that is using the following code: @tutorial_1069_p このコードは最初にドライバをロードして (Class.forName())、 接続を開始します (DriverManager.getConnection())。 このドライバの名前は全てのケースにおいて "org.h2.Driver" です。 データベースに認識されるため、データベースのURLは常に jdbc:h2: から始まります。 getConnection() 内の2番目のパラメーターはユーザ名を指しています ('sa' はこの場合、システム管理者を表しています)。3番目のパラメーターはパスワードです。このデータベースでは、ユーザ名は大文字と小文字を区別していませんが、パスワードは大文字と小文字を区別しています。 @tutorial_1070_h2 新しいデータベースを作成する @tutorial_1071_p 初期設定では、データベースの指定されたURLがまだ存在しない場合、自動的に新しい (空の) データベースが作られます。 @tutorial_1072_h2 サーバーを使用する @tutorial_1073_p H2は現在、3つのサーバーをサポートしています: Webサーバー、TCPサーバー、ODBCサーバーです。 これらのサーバーは異なった方法で起動します。 @tutorial_1074_h3 コマンドラインから起動する @tutorial_1075_p 初期設定でコマンドラインからサーバーを起動させるには、次のように実行します。 @tutorial_1076_p サーバーはデフォルトオプションで起動します。オプションの一覧を取得するには、次のように実行します。 @tutorial_1077_p 異なったポートの使用が可能なオプションや、サーバーの一部を起動、終了させるオプションなどがあります。 詳細はサーバーツールのAPIドキュメントをご覧下さい。 @tutorial_1078_h3 TCPサーバーに接続する @tutorial_1079_p データベースへリモート接続するためには、TCPサーバーを使用します。次のドライバとデータベースURLを利用します: @tutorial_1080_li JDBCドライバクラス: org.h2.Driver @tutorial_1081_li データベースURL: jdbc:h2:tcp://localhost/~/test @tutorial_1082_p データベースURLについての詳細は、特徴内のページをご覧下さい。 @tutorial_1083_h3 アプリケーション内で起動する @tutorial_1084_p アプリケーション内からサーバーを起動、終了することも可能です。 以下はサンプルコードです: @tutorial_1085_h3 他の過程からTCPサーバーを終了する @tutorial_1086_p TCPサーバーは他の過程から終了することができます。 コマンドラインからサーバーを終了するには、次のように実行します: @tutorial_1087_p ユーザアプリケーションからサーバーを終了するには、次のコードを使用します: @tutorial_1088_p この機能はサーバー上の System.exit を呼んでいます。この機能は、データベースが次回起動された時のリカバリーを回避するため、データベースへの全ての接続が切断された後に呼ばれます。リモートサーバーを終了するには、サーバー上でリモート接続が可能である必要があります。 @tutorial_1089_h2 Hibernateを使用する @tutorial_1090_p このデータベースはHibernate version 3.1 と以降の新しいバージョンをサポートしています。 HSQLDB Dialect、または H2 Dialectは src/tools/org/h2/tools/hibernate/H2Dialect.txt ファイル内で使用可能です。 H2 dialectは Hibernateのより新しいバージョンに含まれています。H2 dialectが含まれていないバージョンでは、 src\org\hibernate\dialect (Hibernate 3.1の場合) フォルダ内のファイルをコピーし、 H2Dialect.java にファイル名を変更し、 Hibernateを再びコンパイルします。 @tutorial_1091_h2 Webアプリケーションで データベースを使用する @tutorial_1092_p Webアプリケーション内からデータベースに接続するには様々な方法があります。 以下はTomcatかJBossを使用の場合のいくつかの例です。 @tutorial_1093_h3 エンベッドモード @tutorial_1094_p (現在)最も簡単なソリューションはエンベッドモードでデータベースを使用することです。 それは、アプリケーションが起動する時や (良いソリューションは Servletリスナーを使用します。下記参照)、セッションが起動する時、アプリケーションにおける接続が開始するということを意味します。データベースは、セッションやアプリケーションが同じ過程で実行している限り、多様なセッションやアプリケーションから同時に接続されることが可能です。 多くのServletコンテナは (例; Tomcat) ただひとつのプロセスで利用されるので、問題はありません。 (Tomcatをクラスターモードで起動している場合を除いて)。 Tomcatはマルチスレッドとマルチクラスローダーを使用しています。もし複数のアプリケーションが同じデータベースに同時にアクセスする場合、データベースjarをshared/lib、またはserver/libディレクトリに置く必要があります。 webアプリケーションが起動した時にデータベースを開き、webアプリケーションが終了した時にデータベースを閉じるのが良い方法です。もし複数のアプリケーションを使用する場合、そのうちひとつのアプリケーションをこのように動作することが必要です。アプリケーションでは、セッションごとにひとつの接続を使うか、リクエスト(アクション)ごとにひとつの接続を使うという概念があります。これらの接続はできる限り、使用後に終了させます(しかし、終了させなくても悪くはありません)。 @tutorial_1095_h3 サーバーモード @tutorial_1096_p サーバーモードは類似していますが、他のプロセスでサーバーを起動させることを許可しています。 @tutorial_1097_h3 データベースの起動と終了にServletリスナーを使用する @tutorial_1098_p 以下を web.xmlファイルに追記して下さい。 (context-paramとfilterの間): @tutorial_1099_p データベースへのアクセス方法についての詳細は、DbStarter.javaコードをご覧下さい。 @tutorial_1100_h2 CSV (Comma Separated Values) サポート @tutorial_1101_p データベースにCSVREADとCSVWRITEの関数を使用することで、 CSVファイルサポートを使用することができ、スタンドアロンツールとしてデータベースの外でCSVライブラリを使用することができます。 @tutorial_1102_h3 データベース内からCSVファイルに書き込む @tutorial_1103_p クエリからCSVファイルを作成するのに、組込み関数 CSVWRITEを使用することができます。例: @tutorial_1104_h3 データベース内からCSVファイルを読み込む @tutorial_1105_p CSVREAD関数を使用してCSVファイルを読み込むことができます。 例: @tutorial_1106_h3 JavaアプリケーションからCSVファイルに書き込む @tutorial_1107_p データベースを全く使用しなくても、JavaアプリケーションでCSVツールを使用することができます。 例: @tutorial_1108_h3 JavaアプリケーションからCSVファイルを読み込む @tutorial_1109_p データベースを開かなくてもCSVファイルを読み込むことができます。 例: @tutorial_1110_h2 アップグレード、 バックアップ、修復 @tutorial_1111_h3 データベースのアップグレー @tutorial_1112_p あるバージョンのデータベースエンジンを次のバージョンにアップグレードする際の推奨する方法は、 古いエンジンを使って(SQLスクリプトのフォームでの)データベースのバックアップを作成し、新しいエンジンを使ってSQLスクリプトを実行します。 @tutorial_1113_h3 バックアップ @tutorial_1114_p 異なった方法のデータベースのバックアップがあります。例えば、データベースファイルをコピーすることが可能です。しかしながら、この方法はデータベースが使用されている間は推奨しません。データベースは人が判読しやすく、極めて大きいというわけではありません。データベースバックアップの推奨する方法は、圧縮したSQLスクリプトを作成することです。この方法は、バックアップツールを使用することで可能です: @tutorial_1115_p オプションについての情報は、SQLコマンドスクリプトをご覧下さい。バックアップは遠隔で行えますが、ファイルはサーバー側に作られます。サーバーからファイルを取るのに、ビルトインFTPサーバーを使用することができます。データベースのバックアップを作るのに、SQLコマンドスクリプトを 使用することもできます。 @tutorial_1116_h3 修復 @tutorial_1117_p SQLスクリプトファイルからデータベースを修復するには、RunScriptツールを使用する必要があります: @tutorial_1118_p オプションについての情報は、SQLコマンド RUNSCRIPTをご覧下さい。修復は遠隔で行えますが、サーバー側にファイルが存在する必要があります。サーバーからファイルをコピーするのに、ビルトインFTPサーバーを使用することができます。SQLスクリプトを実行するために、 SQLコマンド RUNSCRIPTを使用することができます。SQLスクリプトファイルには、RUNSCRIPTコマンドのフォーム内に他のスクリプトファイルのリファレンスが含まれています。しかしながら、サーバーモードを使用している時、リファレンススクリプトファイルはサーバー側で利用可能であることが必要です。 @tutorial_1119_h3 オンラインバックアップ @tutorial_1120_p BACKUP SQLステートメントとバックアップツールの両方が全てのデータベースファイルをzipファイル形式で作成します。しかし、このファイルのコンテンツは人間が解読可能なものではありません。SCRIPTステートメントを除いて、BACKUPステートメントはデータベースオブジェクトをロックしないため、他のユーザーをブロックしません。結果として、バックアップは一貫性のあるトランザクションです: @tutorial_1121_p バックアップツール (org.h2.tools.Backup) はオンラインバックアップを作成するために利用されません; このプログラムが実行されている間、データベースは使用されてはいけません。 @tutorial_1122_h2 #Command Line Tools @tutorial_1123_p #This database comes with a number of command line tools. To get more information about a tool, start it with the parameter '-?', for example: @tutorial_1124_p #The command line tools are: @tutorial_1125_b バックアップ @tutorial_1126_li #creates a backup of a database. @tutorial_1127_b #ChangePassword @tutorial_1128_li #allows changing the file password of a database. @tutorial_1129_b #Console @tutorial_1130_li #starts the browser based H2 Console. @tutorial_1131_b #ConvertTraceFile @tutorial_1132_li #converts a .trace.db file to a Java application and SQL script. @tutorial_1133_b #CreateCluster @tutorial_1134_li #creates a cluster from a standalone database. @tutorial_1135_b #DeleteDbFiles @tutorial_1136_li #deletes all files belonging to a database. @tutorial_1137_b #Script @tutorial_1138_li #allows converting a database to a SQL script for backup or migration. @tutorial_1139_b #Recover @tutorial_1140_li #helps recovering a corrupted database. @tutorial_1141_b #Restore @tutorial_1142_li #restores a backup of a database. @tutorial_1143_b #RunScript @tutorial_1144_li #runs a SQL script against a database. @tutorial_1145_b Server @tutorial_1146_li #is used in the server mode to start a H2 server. @tutorial_1147_b #Shell @tutorial_1148_li #is a command line database tool. @tutorial_1149_p #The tools can also be called from an application by calling the main or another public methods. For details, see the Javadoc documentation. @tutorial_1150_h2 OpenOffice Baseを使用する @tutorial_1151_p OpenOffice.org Base はJDBC API上のデータベースアクセスをサポートしています。 OpenOffice Baseを使ってH2データベースに接続するためには、最初にOpenOfficeにJDBCドライバを追加する必要があります。H2データベースに接続する手順: @tutorial_1152_li #Start OpenOffice Writer, go to [Tools], [Options] @tutorial_1153_li #Make sure you have selected a Java runtime environment in OpenOffice.org / Java @tutorial_1154_li #Click [Class Path...], [Add Archive...] @tutorial_1155_li #Select your h2.jar (location is up to you, could be wherever you choose) @tutorial_1156_li #Click [OK] (as much as needed), stop OpenOffice (including the Quickstarter) @tutorial_1157_li OpenOffice Base を起動する @tutorial_1158_li 存在するデータベースに接続し、JDBCを選択し、[Next] をクリックする @tutorial_1159_li #Example datasource URL: jdbc:h2:~/test @tutorial_1160_li JDBCドライバクラス: org.h2.Driver @tutorial_1161_p #Now you can access the database stored in the current users home directory. @tutorial_1162_p #To use H2 in NeoOffice (OpenOffice without X11): @tutorial_1163_li #In NeoOffice, go to [NeoOffice], [Preferences] @tutorial_1164_li #Look for the page under [NeoOffice], [Java] @tutorial_1165_li #Click [Classpath], [Add Archive...] @tutorial_1166_li #Select your h2.jar (location is up to you, could be wherever you choose) @tutorial_1167_li #Click [OK] (as much as needed), restart NeoOffice. @tutorial_1168_p #Now, when creating a new database using the "Database Wizard": @tutorial_1169_li #Select "connect to existing database" and the type "jdbc". Click next. @tutorial_1170_li #Enter your h2 database URL. The normal behavior of H2 is that a new db is created if it doesn't exist. @tutorial_1171_li #Next step - up to you... you can just click finish and start working. @tutorial_1172_p #Another solution to use H2 in NeoOffice is: @tutorial_1173_li #Package the h2 jar within an extension package @tutorial_1174_li #Install it as a Java extension in NeoOffice @tutorial_1175_p #This can be done by create it using the NetBeans OpenOffice plugin. See also <a href="http://wiki.services.openoffice.org/wiki/Extensions_development_java">Extensions Development</a> . @tutorial_1176_h2 Java Web Start / JNLP @tutorial_1177_p Java Web Start / JNLP (Java Network Launch Protocol) を使用している時、パーミッションタグは.jnlp ファイルに設定され、application.jarファイルは署名されていなければなりません。そうでなければ、ファイルシステムに書き込もうとした時、次の例外が発生するでしょう: java.security.AccessControlException: access denied (java.io.FilePermission ... read) パーミッションタグの例: @tutorial_1178_h2 #Using a Connection Pool @tutorial_1179_p #For many databases, opening a connection is slow, and it is a good idea to use a connection pool to re-use connections. For H2 however opening a connection usually is fast if the database is already open. Using a connection pool for H2 actually slows down the process a bit, except if file encryption is used (in this case opening a connection is about half as fast as using a connection pool). A simple connection pool is included in H2. It is based on the <a href="http://www.source-code.biz/snippets/java/8.htm">Mini Connection Pool Manager</a> from Christian d'Heureuse. There are other, more complex connection pools available, for example <a href="http://jakarta.apache.org/commons/dbcp/">DBCP</a> . The build-in connection pool is used as follows: @tutorial_1180_h2 フルテキストサーチ @tutorial_1181_p H2はLuceneフルテキストサーチとnativeフルテキストサーチの実装をサポートしています。 @tutorial_1182_h3 Nativeフルテキストサーチを使用する @tutorial_1183_p 初期化するには、次を呼び出します: @tutorial_1184_p #You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using: @tutorial_1185_p PUBLICはスキーマ、TESTはテーブル名です。カラム名のリスト (分離されたカラム) はオプションです。このケースでは、全てのカラムがインデックスです。インデックスはリードタイムに更新されます。インデックスを検索するには、次のクエリーを使用します: @tutorial_1186_p Javaアプリケーション内からインデックスを呼び出すことも可能です: @tutorial_1187_h3 Luceneフルテキストサーチを使用する @tutorial_1188_p #To use the Lucene full text search, you need the Lucene library in the classpath. How his is done depends on the application; if you use the H2 Console, you can add the Lucene jar file to the environment variables H2DRIVERS or CLASSPATH. To initialize the Lucene full text search in a database, call: @tutorial_1189_p #You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using: @tutorial_1190_p PUBLICはスキーマ、TESTはテーブル名です。カラム名のリスト (分離されたカラム) はオプションです。このケースでは、全てのカラムがインデックスです。インデックスはリードタイムに更新されます。インデックスを検索するには、次のクエリーを使用します: @tutorial_1191_p Javaアプリケーション内からインデックスを呼び出すことも可能です: @tutorial_1192_h2 #User-Defined Variables @tutorial_1193_p #This database supports user-defined variables. Variables start with @ and can be used wherever expressions or parameters are used. Variables not persisted and session scoped, that means only visible for the session where they are defined. A value is usually assigned using the SET command: @tutorial_1194_p #It is also possible to change a value using the SET() method. This is useful in queries: @tutorial_1195_p #Variables that are not set evaluate to NULL. The data type of a user-defined variable is the data type of the value assigned to it, that means it is not necessary (or possible) to declare variable names before using them. There are no restrictions on the assigned values; large objects (LOBs) are supported as well. @tutorial_1196_h2 #Date and Time @tutorial_1197_p #Date, time and timestamp values support ISO 8601 formatting, including time zone: @tutorial_1198_p #If the time zone is not set, the value is parsed using the current time zone setting of the system. Date and time information is stored in H2 database files in GMT (Greenwich Mean Time). If the database is opened using another system time zone, the date and time will change accordingly. If you want to move a database from one time zone to the other and don't want this to happen, you need to create a SQL script file using the SCRIPT command or Script tool, and then load the database using the RUNSCRIPT command or the RunScript tool in the new time zone.