# Change Log ## Next Version (unreleased) If a value of a result set was itself a result set, the result could only be read once. Column constraints are also visible in views (patch from Nicolas Fortin for H2GIS). Granting a additional right to a role that already had a right for that table was not working. Spatial index: a few bugs have been fixed (using spatial constraints in views, transferring geometry objects over TCP/IP). Issue 551: the datatype documentation was incorrect (found by Bernd Eckenfels). Issue 368: ON DUPLICATE KEY UPDATE did not work for multi-row inserts. Test case from Angus Macdonald. OSGi: the package javax.tools is now imported (as an optional). H2 Console: auto-complete is now disabled by default, but there is a hot-key (Ctrl+Space). H2 Console: auto-complete did not work with multi-line statements. CLOB and BLOB data was not immediately removed after a rollback. There is a new Aggregate API that supports the internal H2 data types (GEOMETRY for example). Thanks a lot to Nicolas Fortin for the patch! Referential integrity constraints sometimes used the wrong index, such that updating a row in the referenced table incorrectly failed with a constraint violation. The Polish translation was completed and corrected by Wojtek Jurczyk. Thanks a lot! Issue 545: Unnecessary duplicate code was removed. The profiler tool can now process files with full thread dumps. MVStore: the file format was changed slightly. MVStore mode: the CLOB and BLOB storage was re-implemented and is now much faster than with the PageStore (which is still the default storage). MVStore mode: creating indexes is now much faster (in many cases faster than with the default PageStore). Various bugs in the MVStore storage and have been fixed, including a bug in the R-tree implementation. The database could get corrupt if there were transient IO exceptions while storing. The method org.h2.expression.Function.getCost could throw a NullPointException. Storing LOBs in separate files (outside of the main database file) is no longer supported for new databases. Lucene 2 is no longer supported. Fix bug in calculating default MIN and MAX values for SEQUENCE. Fix bug in performing IN queries with multiple values when IGNORECASE=TRUE Add entry-point to org.h2.tools.Shell so it can be called from inside an application. patch by Thomas Gillet. Fix bug that prevented the PgServer from being stopped and started multiple times. Support some more DDL syntax for MySQL, patch from Peter Jentsch. Issue 548: TO_CHAR does not format MM and DD correctly when the month or day of the month is 1 digit, patch from "the.tucc" ## Version 1.3.175 (2014-01-18) EXPLAIN was incorrect for queries with "ANY" or "SOME" conditions. CallableStatement with "out" parameters: running the same statement twice could result in an exception ("parameter not set"). Union queries: duplicate rows could be returned if the sub-queries contained "order by". The GEOMETRY data type now works for user defined functions that return a result set. PostgreSQL compatibility: the PgServer was not working properly when the setting database_to_upper was set to false. JdbcDataSource: the methods setUrl and getUrl where added as aliases for setURL and getURL. This should solve problems with the HikariCP (Hikari connection pool). Issue 537: H2 Console: when loading the schema, incorrect JDBC calls where issued, which caused the exception "Column PRECISION not found". Improved Geometry processing (issue 535). The collation can now be set in the database URL, even if there are data tables, if the collection is the same as the current collation. Improved Oracle compatibility for CASE WHEN and DECODE. The statement "drop all objects" did not work if a table depends on a view via a constraint. Subqueries or views with "order by" an alias expression could not be executed due to a regression introduced in version 1.3.174. Issue 73: MySQL compatibility: support REPLACE, patch by Cemo Koc. The spatial index now works in MVCC mode when using the MVStore storage. MVStore: concurrency problems have been fixed. The API has been simplified. Improve error message when dropping an index that belongs to a constraint, specify constraint in error message. Issue 518: java.sql.Connection.commit() freezes after LOB modification with EXCLUSIVE connection Issue 517: Create or replace view statement has no effect on the others already existing JDBC connection Support 123L syntax as in Java; example: SELECT (2000000000L*2). Issue 520: Add support for sequence max value, min value and cycle, patch by Daniel Gredler. Issue 521: ScriptReader should implement Closeable Issue 524: RunScript.execute does not close its Statement, patch from Gaul. Add support for DB2 "WITH UR" clause, patch from litailang Added support for ON DUPLICATE KEY UPDATE like MySQL with the values() function to update with the value that was to be inserted. Patch from Jean-Francois Noel. Issue 522: Treat empty strings like NULL in Oracle compatibility mode, patch by Daniel Gredler. Issue 527: Oracle compatibility mode: incorrect scale behavior, patch by Daniel Gredler. Slightly reduce the memory cost of View metadata. Extend support of "GRANT ALTER ANY SCHEMA TO <user>" to allow grantee ability to manipulate tables Issue 532: Javadoc for ErrorCode.ROLES_AND_RIGHT_CANNOT_BE_MIXED looks wrong Issue 528: Add Oracle-compatible TO_CHAR function, patch by Daniel Gredler. Issue 534: CREATE ALIAS NOCACHE, Patch by Nicolas Fortin Fix an issue with storing Unicode surrogate pairs in CLOB columns. H2 console: add SHIFT+ENTER "run selected" functionality Fix bug in DB2 syntax "select * from test with ur", patch from litailang Fix bug in DROP ALL OBJECTS when dealing with inter-schema dependencies. ## Version 1.3.174 (2013-10-19) LIRS cache: bugfix for caches that only contain non-resident entries. For in-memory databases, queries with a "group by" column that is also a hash index threw a RuntimeException. Improved error message for some syntax errors. File system abstraction: if used directly, some file systems did not work correctly with spliced byte buffers (the database engine doesn't use those). To use the MVStore storage engine (which is still work in progress), append ";mv_store=true" to the database URL. Using the MVTableEngine when creating the table is no longer recommended. To compile user defined functions, the javax.tools.JavaCompiler is now used if available, and no temporary files are created. This should solve problems when multiple H2 database concurrently compile the same user defined functions. To disable, system the system property "h2.javaSystemCompiler" to false. Concurrently creating function aliases in different databases could result in the exception "javac: file not found". The function "regexp_replace" threw the wrong kind of exception if the replacement string was invalid. A checkpoint is now done every MAX_LOG_SIZE / 2 instead of every MAX_LOG_SIZE, so that the transaction log doesn't grow as large. MVStore table engine: new setting "retention_time" to configure the time to retain old data. The default is 45 seconds. The method TableEngine.createTable() now returns a Table object. For read-only databases, for the trace level "debug", the trace info is written to the temp directory. Closing the file lock will now wait until the background thread is stopped. In version 1.3.172, a performance regression was introduced when fixing the issue 389 (when there is a multi-column primary key, H2 does not seem to always pick the right index). This was related to boosting an index that matches the "order by" column list (the wrong index was used in some cases). Improved spatial index and data type. Issue 467: OSGi Class Loader (ability to create reference to class in other ClassLoader, for example in another OSGi bundle). Queries "group by" that contain a subquery with an aggregate function returned the wrong result in some cases. Fix bug in unique and non-unique hash indexes which manifested as incorrect results when the search key was a different cardinal type from the table index key. e.g. where the one was INT and the other was LONG Bug: Changes to the database structure did not result in the Session query cache being invalidated. New feature from Davide Cavestro - allow using custom Java object serialization engines on a per-DB basis. When running the Recover tool on very large (>6G) databases, some statistics were reported with negative numbers. Add a CONTAINS_UNCOMMITTED column to the SESSIONS metadata table, to allow detecting when rogue sessions are creating large transactions. Some small fixes to the GEOMETRY support, patches by Nicolas Fortin. The BNF tool and the autocomplete feature are exported in OSGi, which makes it possible for smart editors to do autocomplete. Patch from Nicolas Fortin. Fix DROP ALL OBJECTS and DROP SCHEMA in the presence of tables with computed column dependencies. Session-temporary LOB's could sometimes accumulate, increasing the size of the DB file until shutdown. Now they are cleared out at every commit. There was a bug where a hash index with more than one column would be silently converted to a regular index. It will now throw an exception. Query Statistics: new feature which stores the newest 100 SQL queries executed and their performance data. Useful for tracking down badly performing queries. Fix an LOB deadlock between reading and updating LOB columns. Support the JDBC DatabaseMetaData#getClientInfoProperties() method, in the sense of returning an empty result, in order to make WebSphere happy. Make Server#openBrowser respect the $BROWSER environment variable. Add "chromium" to the list of browsers tried. Patch from Felix Kaiser. Fix to org.h2.util.ScriptReader when handling unclosed block comments. Make org.h2.util.ScriptReader throw a better exception when handling broken scripts which generate extremely large statements. Fix bug with ALLOW_LITERALS=NONE, where the periodic analyze table on insert would throw an exception. A similar problem was fixed in the Console tool. Issue 510: Make org.h2.bnf public for consumption by external projects, patch by Nicolas Fortin Issue 509: Important fix on ValueGeometry, patch by Nicolas Fortin (with some tweaking) Make ValueGeometry#getDimensionCount more reliable. Add unit test to check for illegal ValueGeometry comparison Add unit test for conversion of Geometry object into Object Add optional export to MANIFEST.MF for JTS Geometry classes Validate that geometry values can be represented in WKB. Issue 506: RFE: Include Thread.getName() in case of a deadlock Adding support for "GRANT ALTER ANY SCHEMA TO <user>", patch by John Yates ## Version 1.3.173 (2013-07-28) Support empty statements that just contains a comment. Server mode: if there was an error while reading from a LOB, the session was closed in some cases. Issue 463: Driver name and version are now the same in OsgiDataSourceFactory and JdbcDatabaseMetaData. JaQu: The data type VARCHAR is now (again) used for Strings (no longer TEXT, except when explicitly set). For in-memory databases, creating an index on a CLOB or BLOB column is no longer supported. This is to simplify the MVTableEngine. New column "information_schema.tables.row_count_estimate". Issue 468: trunc(timestamp) could return the wrong value (+12 hours), and trunc(number) throw a NullPointerException. The expression trunc(number) threw a NullPointerException. Fixed a deadlock when updating LOB's concurrently. See TestLob.testDeadlock2(). Fixed a deadlock related to very large temporary result sets. Add "-list" command line option to Shell tool so that result-list-mode can be triggered when reading from a file. Issue 474: H2 MySQL Compatibility code fails to ignore "COMMENT" in CREATE TABLE, patch from Aaron Azeckoski. Issue 476: Broken link in jaqu.html Fix potential UTF8 encoding issue in org.h2.store.FileStore, reported by Juerg Spiess. Improve error message when check constraint is broken, test case from Gili (cowwoc). Improve error message when we have a unique constraint violation, displays the offending key in the error message. Issue 478: Support for "SHOW TRANSACTION ISOLATION LEVEL", patch from Andrew Franklin. Issue 475: PgServer: add support for CancelRequest, patch from Andrew Franklin. Issue 473: PgServer missing -key option, patch from Andrew Franklin. Issue 471: CREATE VIEW does not check user rights, patch from Andrew Franklin. Issue 477: PgServer binary transmission of query params is unimplemented, patch from Andrew Franklin. Issue 479: Support for SUBSTRING without a FROM condition, patch from Andrew Franklin. Issue 472: PgServer does not work with any recent Postgres JDBC driver, patch from Andrew Franklin. Add syntax for passing additional parameters into custom TableEngine implementations. Issue 480: Bugfix post issue 475, 477, patch from Andrew Franklin. Issue 481: Further extensions to PgServer to support better support PG JDBC, patch from Andrew Franklin. Add support for spatial datatype GEOMETRY. Add support for in-memory spatial index. change the PageStore#changeCount field from an int to a long, to cope with databases with very high transaction rates. Fix a NullPointerException when attempting to add foreign key reference to a view. Add sufficient ClientInfo support to our javax.sql.Connection implementation to make WebSphere happy. Issue 482: class LobStorageBackend$LobInputStream does not override the method InputStream.available(). Fix corruption resulting from a mix of the "WRITE_DELAY=0" option and "SELECT DISTINCT" queries that don't fit in memory. Fix the combination of updating a table which contains an LOB, and reading from the LOB at the same time. Previously it would throw an exception, now it works. Issue 484: In the H2 Console tool, all schemas starting with "INFO" where hidden. Now they are hidden only if the database is not H2. Patch from "mgcodeact"/"cumer d" MySQL compatibility, support the "AUTO_INCREMENT=3" part of the CREATE TABLE statement. Issue 486: MySQL compatibility, support the "DEFAULT CHARSET" part of the CREATE TABLE statement. Issue 487: support the MySQL "SET foreign_key_checks = 0" command Issue 490: support MySQL "USING BTREE" index declaration Issue 485: Database get corrupted when column is renamed for which check constraint was defined inside create table statement. Issue 499: support MySQL "UNIQUE KEY (ID) USING BTREE" constraint syntax Issue 501: "CREATE TABLE .. WITH" not serialized, patch from nico.devel Avoid problems with runtime-compiled ALIAS methods when people have set the JAVA_TOOL_OPTIONS environment variable. ## Version 1.3.172 (2013-05-25) Referential integrity: when adding a referential integrity constraint failed, and if creating the constraint automatically created an index, this index was not removed. The auto-analyze feature now only reads 1000 rows per table instead of 10000. The optimization for IN(...) queries combined with OR could result in a strange exception of the type "column x must be included in the group by list". Issue 454: Use Charset for type-safety. Queries with both LIMIT and OFFSET could throw an IllegalArgumentException. MVStore: multiple issues were fixed: 460, 461, 462, 464, 466. MVStore: larger stores (multiple GB) are now much faster. When using local temporary tables and not dropping them manually before closing the session, and then killing the process could result in a database that couldn't be opened (except when using the recover tool). Support TRUNC(timestamp) for improved Oracle compatibility. Add support for CREATE TABLE TEST (ID BIGSERIAL) for PostgreSQL compatibility. Patch from Jesse Long. Add new collation command SET BINARY_COLLATION UNSIGNED, helps with people testing BINARY columns in MySQL mode. Issue 453: ABBA race conditions in TABLE LINK connection sharing. Issue 449: Postgres Serial data type should not automatically be marked as primary key Issue 406: Support "select h2version()" Issue 389: When there is a multi-column primary key, H2 does not seem to always pick the right index Issue 305: Implement SELECT ... FOR FETCH ONLY Issue 274: Sybase/MSSQLServer compatibility - Add GETDATE and CHARINDEX system functions Issue 274: Sybase/MSSQLServer compatibility - swap parameters of CONVERT function. Issue 274: Sybase/MSSQLServer compatibility - support index clause e.g. "select * from test (index table1_index)" Fix bug in Optimizing SELECT * FROM A WHERE X=1 OR X=2 OR X=3 into SELECT * FROM A WHERE X IN (1,2,3) Issue 442: Groovy patch for SourceCompiler (function ALIAS) Issue 459: Improve LOB documentation ## Version 1.3.171 (2013-03-17) Security: the TCP server did not correctly restrict access rights of clients in some cases. This was specially a problem when using the flag "tcpAllowOthers". H2 Console: the session timeout can now be configured using the system property "h2.consoleTimeout". Issue 431: Improved compatibility with MySQL: support for "ENGINE=InnoDB charset=UTF8" when creating a table. Issue 249: Improved compatibility with MySQL in the MySQL mode: now the methods DatabaseMetaData methods stores*Case*Identifiers return the same as MySQL when using the MySQL mode. Issue 434: H2 Console didn't work in the Chrome browser due to a wrong viewport argument. There was a possibility that the .lock.db file was not deleted when the database was closed, which could slow down opening the database. The SQL script generated by the "script" command contained inconsistent newlines on Windows. When using trace level 4 (SLF4J) in the server mode, a directory "trace.db" and an empty file was created on the client side. This is no longer made. Optimize IN(...) queries: there was a bug in version 1.3.170 if the type of the left hand side didn't match the type of the right hand side. Fixed. Optimize IN(...) queries: there was a bug in version 1.3.170 for comparison of the type "X IN(NULL, NULL)". Fixed. Timestamps with timezone that were passed as a string were not always converted correctly. For example "2012-11-06T23:00:00.000Z" was converted to "2012-11-06" instead of to "2012-11-07" in the timezone CET. Thanks a lot to Steve Hruda for reporting the problem! New table engine "org.h2.mvstore.db.MVTableEngine" that internally uses the MVStore to persist data. To try it out, append ";DEFAULT_TABLE_ENGINE=org.h2.mvstore.db.MVTableEngine" to the database URL. This is still very experimental, and many features are not supported yet. The data is stored in a file with the suffix ".mv.db". New connection setting "DEFAULT_TABLE_ENGINE" to use a specific table engine if none is set explicitly. This is to simplify testing the MVStore table engine. MVStore: encrypted stores are now supported. Only standardized algorithms are used: PBKDF2, SHA-256, XTS-AES, AES-128. MVStore: improved API thanks to Simo Tripodi. MVStore: maps can now be renamed. MVStore: store the file header also at the end of each chunk, which results in a further reduced number of write operations. MVStore: a map implementation that supports concurrent operations. MVStore: unified exception handling; the version is included in the messages. MVStore: old data is now retained for 45 seconds by default. MVStore: compress is now disabled by default, and can be enabled on request. Support ALTER TABLE ADD ... AFTER. Patch from Andrew Gaul (argaul at gmail.com). Fixes issue 401. Improved OSGi support. H2 now registers itself as a DataSourceFactory service. Fixes issue 365. Add a DISK_SPACE_USED system function. Fixes issue 270. Fix a compile-time ambiguity when compiling with JDK7, thanks to a patch from Lukas Eder. Supporting dropping an index for Lucene full-text indexes. Optimized performance for SELECT ... ORDER BY X LIMIT Y OFFSET Z queries for in-memory databases using partial sort (by Sergi Vladykin). Experimental off-heap memory storage engine "nioMemFS:" and "nioMemLZF:", suggestion from Mark Addleman. Issue 438: JdbcDatabaseMetaData.getSchemas() is no longer supported as of 1.3.169. MySQL compatibility: support for ALTER TABLE tableName MODIFY [COLUMN] columnName columnDef. Patch from Ville Koskela. Issue 404: SHOW COLUMNS FROM tableName does not work with ALLOW_LITERALS=NUMBERS. Throw an explicit error to make it clear we don't support the TRIGGER combination of SELECT and FOR EACH ROW. Issue 439: Utils.sortTopN does not handle single-element arrays. ## Version 1.3.170 (2012-11-30) Issue 407: The TriggerAdapter didn't work with CLOB and BLOB columns. PostgreSQL compatibility: support for data types BIGSERIAL and SERIAL as an alias for AUTO_INCREMENT. Issue 417: H2 Console: the web session timeout didn't work, resulting in a memory leak. This was only a problem if the H2 Console was run for a long time and many sessions were opened. Issue 412: Running the Server tool with just the option "-browser" will now log a warning. Issue 411: CloseWatcher registration was not concurrency-safe. MySQL compatibility: support for CONCAT_WS. Thanks a lot to litailang for the patch! PostgreSQL compatibility: support for EXTRACT(WEEK FROM dateColumn). Thanks to Prashant Bhat for the patch! Fix for a bug where we would sometimes use the wrong unique constraint to validate foreign key constraints. Support BOM at the beginning of files for the RUNSCRIPT command Fix in calling SET @X = IDENTITY() where it would return NULL incorrectly Fix ABBA deadlock between adding a constraint and the H2-Log-Writer thread. Optimize IN(...) queries where the values are constant and of the same type. Restore tool: the parameter "quiet" was not used and is now removed. Fix ConcurrentModificationException when creating tables and executing SHOW TABLES in parallel. Reported by Viktor Voytovych. Serialization is now pluggable using the system property "h2.javaObjectSerializer". Thanks to Sergi Vladykin for the patch! ## Version 1.3.169 (2012-09-09) The default jar file is now compiled for Java 6. The new jar file will probably not end up in the central Maven repository in the next few weeks because Sonatype has disabled automatic synchronization from SourceForge (which they call 'legacy sync' now). It will probably take some time until this is sorted out. The H2 jar files are deployed to http://h2database.com/m2-repo/com/h2database/h2/maven-metadata.xml and http://hsql.sourceforge.net/m2-repo/com/h2database/h2/maven-metadata.xml as usual. A part of the documentation and the H2 Console has been changed to support the Apple retina display. The CreateCluster tool could not be used if the source database contained a CLOB or BLOB. The root cause was that the TCP server did not synchronize on the session, which caused a problem when using the exclusive mode. Statement.getQueryTimeout(): only the first call to this method will query the database. If the query timeout was changed in another way than calling setQueryTimeout, this method will always return the last value. This was changed because Hibernate calls getQueryTimeout() a lot. Issue 416: PreparedStatement.setNString throws AbstractMethodError. All implemented JDBC 4 methods that don't break compatibility with Java 5 are now included in the default jar file. Issue 414: for some functions, the parameters were evaluated twice (for example "char(nextval(..))" ran "nextval(..)" twice). The ResultSetMetaData methods getSchemaName and getTableName could return null instead of "" (an empty string) as specified in the JDBC API. Added compatibility for "SET NAMES" query in MySQL compatibility mode. ## Version 1.3.168 (2012-07-13) The message "Transaction log could not be truncated" was sometimes written to the .trace.db file even if there was no problem truncating the transaction log. New system property "h2.serializeJavaObject" (default: true) that allows to disable serializing Java objects, so that the objects compareTo and toString methods can be used. Dylan has translated the H2 Console tool to Korean. Thanks a lot! Executing the statement CREATE INDEX IF ALREADY EXISTS if the index already exists no longer fails for a read only database. MVCC: concurrently updating a row could result in the row to appear deleted in the second connection, if there are multiple unique indexes (or a primary key and at least one unique index). Thanks a lot to Teruo for the patch! Fulltext search: in-memory Lucene indexes are now supported. Fulltext search: UUID primary keys are now supported. Apache Tomcat 7.x will now longer log a warning when unloading the web application, if using a connection pool. H2 Console: support the Midori browser (for Debian / Raspberry Pi) When opening a remote session, don't open a temporary file if the trace level is set to zero Use HMAC for authenticating remote LOB id's, removing the need for maintaining a cache, and removing the limit on the number of LOBs per result set. H2 Console: HTML and XML documents can now be edited in an updatable result set. There is (limited) support for editing multi-line documents.