# Change Log

## Next Version (unreleased)

- Prepared statements could only be re-used if the same data types were used the second time they were executed.
- In error messages about referential constraint violation, the values are now included.
- SCRIPT and RUNSCRIPT: the password can now be set using a prepared statement. Previously, it was required to be a literal in the SQL statement.
- MySQL compatibility: SUBSTR with a negative start index now works like MySQL.
- When enabling autocommit, the transaction is now committed (as required by the JDBC API).
- The shell script `h2.sh` did not work with spaces in the path. It also works now with quoted spaces in the argument list. Thanks a lot to Shimizu Fumiyuki for the patch!
- If the transaction log could not be truncated because of an uncommitted transaction, now "Transaction log could not be truncated" is written to the .trace.db file. Before, the database file was growing and it was hard to find out what the root cause was. To avoid the database file from growing, a new feature to automatically rollback the oldest transaction is available now. To enable it, append ;LOG_SIZE_LIMIT=32 to the database URL (in that case, the oldest session is rolled back if the transaction log is 32 MB).
- ALTER TABLE ADD can now add more than one column at a time.
- Issue 380: ALTER TABLE ADD FOREIGN KEY with an explicit index didn't verify the index can be used, which would lead to a NullPointerException later on.
- The wrong kind of exception (NullPointerException) was thrown in a UNION query with an incorrect ORDER BY expression.
- Issue 362: support LIMIT in UPDATE statements.
- Browser: if no default browser is set, Google Chrome is now used if available. If not available, then Konqueror, Netscape, or Opera is used if available (as before).
- CSV tool: new feature to disable writing the column header (option writeColumnHeader).
- CSV tool: new feature to preserve the case sensitivity of column names (option caseSensitiveColumnNames).
- PostgreSQL compatibility: LOG(x) is base 10 in the PostgreSQL mode.

## Version 1.3.164 (2012-02-03)

- New built-in function ARRAY_CONTAINS.
- Some DatabaseMetaData methods didn't work when using ALLOW_LITERALS NONE.
- Trying to convert a VARCHAR to UUID will now fail if the text contains a character that is not a hex digit, '-', or not a whitespace.
- TriggerAdapter: in "before" triggers, values can be changed using the ResultSet.updateX methods.
- Creating a table with column data type NULL now works (even if not very useful).
- ALTER TABLE ALTER COLUMN no longer copies the data for widening conversions (for example if only the precision was increased) unless necessary.
- Multi-threaded kernel: concurrently running an online backup and updating the database resulted in a broken (transactionally incorrect) backup file in some cases.
- The script created by SCRIPT DROP did not always work if multiple views existed that depend on each other.
- MathUtils.getSecureRandom could log a warning to System.err in case the /dev/random is very slow, and the System.getProperties().toString() returned a string larger than 64 KB.
- The database file locking mechanism "FS" (;FILE_LOCK=FS) did not work on Linux since version 1.3.161.
- Sequences: the functions NEXTVAL and CURRVAL did not work as expected when using quoted, mixed case sequence names.
- The constructor for Csv objects is now public, and Csv.getInstance() is now deprecated.
- SimpleResultSet: updating a result set is now supported.
- Database URL: extra semicolons are not supported.

## Version 1.3.163 (2011-12-30)

- On out of disk space, the database could get corrupt sometimes, if later write operations succeeded. The same problem happened on other kinds of I/O exceptions (where one or some of the writes fail, but subsequent writes succeed). Now the file is closed on the first unsuccessful write operation, so that later requests fail consistently.
- DatabaseEventListener.diskSpaceIsLow() is no longer supported because it can't be guaranteed that it always works correctly.
- XMLTEXT now supports an optional parameter to escape newlines.
- XMLNODE now support an optional parameter to disable indentation.
- Csv.write now formats date, time, and timestamp values using java.sql.Date / Time / Timestamp.toString(). Previously, ResultSet.getString() was used, which didn't work well for Oracle.
- The shell script `h2.sh` can now be run from within a different directory. Thanks a lot to Daniel Serodio for the patch!
- The page size of a persistent database can now be queries using: select * from information_schema.settings where name = 'info.PAGE_SIZE'
- In the server mode, BLOB and CLOB objects are no longer closed when the result set is closed (as required by the JDBC spec).

## Version 1.3.162 (2011-11-26)

- The following system properties are no longer supported: `h2.allowBigDecimalExtensions`, `h2.emptyPassword`, `h2.minColumnNameMap`, `h2.returnLobObjects`, `h2.webMaxValueLength`.
- When using a VPN, starting a H2 server did not work (for some VPN software).
- Oracle compatibility: support for DECODE(...).
- Lucene fulltext search: creating an index is now faster if the table already contains data. Thanks a lot to Angel Leon from the FrostWire Team for the patch!
- Update statements with a column list in brackets did not work if the list only contains one column. Example: update test set (id)=(id).
- Read-only databases in a zip file did not work when using the -baseDir option.
- Issue 334: SimpleResultSet.getString now also works for Clob columns.
- Subqueries with an aggregate did not always work. Example: select (select count(*) from test where a = t.a and b = 0) from test t group by a
- Server: in some (theoretical) cases, exceptions while closing the connection were ignored.
- Server.createTcpServer, createPgServer, createWebServer: invalid arguments are now detected.
- The selectivity of LOB columns is no longer calculated because indexes on LOB columns are not supported (however this should have little effect on performance, as the selectivity is calculated from the hash code and not the data).
- New experimental system property "h2.modifyOnWrite": when enabled, the database file is only modified when writing to the database. When enabled, the serialized file lock is much faster for read-only operations.
- A NullPointerException could occur in TableView.isDeterministic for invalid views.
- Issue 180: when deserializing objects, the context class loader is used instead of the default class loader if the system property "h2.useThreadContextClassLoader" is set. Thanks a lot to Noah Fontes for the patch!
- When using the exclusive mode, LOB operations could cause the thread to block. This also affected the CreateCluster tool (when using BLOB or CLOB data).
- The optimization for "group by" was not working correctly if the group by column was aliased in the select list.
- Issue 326: improved support for case sensitive (mixed case) identifiers without quotes when using DATABASE_TO_UPPER=FALSE.

## Version 1.3.161 (2011-10-28)

- Issue 351: MySQL mode: can not create a table with the column "KEY", and can not open databases where such a table already exists.
- TCP server: when using the trace option ("-trace"), the trace output contained unnecessary stack traces when stopping the server.
- Issue 354: when using the multi-threaded kernel option, and multiple threads concurrently prepared SQL statements that use the same view or the same index of a view, then in some cases an infinite loop could occur.
- Issue 350: when using instead of triggers, executeUpdate for delete operations always returned 0.
- Some timestamps with timezone were not converted correctly. For example, in the PST timezone, the timestamp 2011-10-26 08:00:00Z was converted to 2011-10-25 25:00:00 instead of 2011-10-26 01:00:00. Depending on the database operation, this caused subsequent error.
- Sequences with cache size smaller than 0 did not work correctly.
- Issue 356: for Blob objects, InputStream.skip() returned 0, causing EOFException in Blob.getBytes(.., ..).
- Updatable result sets: if the value is not set when inserting a new row, the default value is now used (the same behavior as MySQL, PostgreSQL, and Apache Derby) instead of NULL.
- Conditions of the form IN(SELECT ...) where slow and increased the database size if the subquery result size was larger then the configured MAX_MEMORY_ROWS.
- Issue 347: the RunScript and Shell tools now ignore empty statements.
- Issue 246: improved error message for data conversion problems.
- Issue 344: the build now supports a custom Maven repository location.
- Issue 334: Java functions that return CLOB or BLOB objects could not be used as tables.
- SimpleResultSet now supports getColumnTypeName and getColumnClassName.
- SimpleResultSet now has minimal BLOB and CLOB support.
- Improved performance for large databases (many GB), and databases with a small page size.
- The Polish translation has been improved by Jarosław Kokociński.
- When using the built-in connection pool, after calling the "shutdown" SQL statement, a warning was written to the .trace.db file about an unclosed connection.
- Improved compatibility for "fetch first / next row(s)". Thanks a lot to litailang for the patch!
- Improved compatibility with the Java 7 FileSystem abstraction.

## Version 1.3.160 (2011-09-11)

- Computed columns could not refer to itself.
- Issue 340: Comparison with "x = all(select ...)" or similar in a view or subquery that was used as a table returned the wrong result.
- Comparison with "x = all(select ...)" or similar returned the wrong result for some cases (for example if the subquery returned no rows, or multiple rows with the same value, or null, or if x was null).
- Issue 335: Could not run DROP ALL OBJECTS DELETE FILES on older databases with CLOB or BLOB data. The problem was that the metadata table was not locked in some cases, so that a rollback could result in a corrupt database in a database if the lob storage was upgraded.
- Source code switching using //## has been simplified. The Java 1.5 tag has been removed because is no longer needed.
- The JDBC methods PreparedStatement.setTimestamp, setTime, and setDate with a calendar, and the methods ResultSet.getTimestamp, getTime, and getDate with a calendar converted the value in the wrong way, so that for some timestamps the converted value was wrong (where summertime starts, one hour per year).
- Invalid tables names in 'order by' columns were not detected in some cases. Example: select x from dual order by y.x
- Issue 329: CASE expression: data type problem is not detected.
- Issue 311: File lock mode serialized: selecting the next value from a sequence didn't work after a pause, because the database thought this is a read-only operation.

## Version 1.3.159 (2011-08-13)

- Creating a temporary table with the option 'transactional' will now also create the indexes in transactional mode, if the indexes are included in the 'create table' statement as follows: "create local temporary table temp(id int primary key, name varchar, constraint x index(name)) transactional".
- The database file size grows now 35%, but at most 256 MB at a time.
- Improved error message on network configuration problems.
- The build now support an offline build using ./build.sh offline. This will list the required dependencies if jar files are missing.
- The BLOB / CLOB data was dropped a little bit before the table was dropped. This could cause "lob not found" errors when the process was killed while a table was dropped.
- "group_concat(distinct ...)" did not work correctly in a view or subquery (the 'distinct' was lost). Example: select * from (select group_concat(distinct 1) from system_range(1, 3));
- Database URLs can now be re-mapped to another URL using the system property "h2.urlMap", which points to a properties file with database URL mappings.
- When using InputStream.skip, trying to read past the end of a BLOB failed with the exception "IO Exception: Missing lob entry: ..." [90028-...].
- The in-memory file system "memFS:" now has limited support for directories.
- To test recovery, append ;RECOVER_TEST=64 to the database URL. This will simulate an application crash after each 64 writes to the database file. A log file named databaseName.h2.db.log is created that lists the operations. The recovery is tested using an in-memory file system, that means it may require a larger heap setting.
- Converting a hex string to a byte array is now faster.
- The SQL statement "shutdown defrag" could corrupt the database if the process was killed while the shutdown was in progress. The same problem could occur when the database setting "defrag_always" was used.

## Version 1.3.158 (2011-07-17)

- Fulltext search (native): after re-opening the connection once the fulltext index was created, a transaction rollback did not roll back the modifications in the index.
- Support for ROW_NUMBER() OVER() as an alias for ROWNUM() for compatibility with PostgreSQL and Apache Derby.
- Issue 325: a deadlock in the fulltext search could occur if the connection that was used while initializing the fulltext search was later used to query the database. This was actually not only a problem for fulltext search, but also for other triggers that used the initializing connection later on.
- DATABASE_TO_UPPER: when set to false, all identifier names (table names, column names) are case sensitive (except aggregate, built-in functions, data types, and keywords). This is for improved compatibility with MySQL and PostgreSQL.
- When upgrading from an older 1.3.x version to version 1.3.157, when using BLOB or CLOB data, the database could only be opened once.
- SUM on a boolean expression will now count the number of 'true' rows.
- Simplified test cases using assertThrows(...).
- A Java function that returns a result set that was generated using the provided connection could cause an internal error in some cases. Now such result sets are copied early on.
- Data type RESULT_SET: information_schema.function_aliases returned type 0; now type -10 is returned (the same as Oracle: OracleTypes.CURSOR = -10).
- Data type RESULT_SET: tables with columns of type RESULT_SET could be created, but no data could be persisted in this column.
- H2 Console: improved system tray icon for Mac OS X (transparent background).
- String.toUpperCase() was used a few places, which is problematic when using the Turkish locale. The method has been replaced with toUpperCase(Locale.ENGLISH) to solve such problems.
- Shell tool: the built-in command "distinct" has been removed (use the SQL statements "show tables" / "show columns from tableName" instead). The result set formatting has been improved.
- MERGE: if a unique key was violated (but not the primary key or the key columns of the merge itself), the wrong exception was thrown.
- IBM DB2 and Apache Derby compatibility: support the pseudo-table SYSIBM.SYSDUMMY1.
- ROWNUM() did not work in combination with IN(..). The following query did not work as expected: select * from (select rownum r from test) where r in (1, 2).
- H2 Console autocomplete: the autocomplete feature didn't support quoted names.
- It is now longer allowed to create an index on a CLOB or BLOB column (except for in-memory databases or indexes), because recovery doesn't work on such columns. Fulltext indexes on such column are still supported of course.
- The PUBLIC schema could be renamed, which could result in a database that can't be opened normally. Now it can no longer be renamed. The schema INFORMATION_SCHEMA can also no longer be renamed.
- Server mode: the problem with server and client using different timezones with different daylight saving rules has been solved (this only applies when both the client and the server use this or a newer version).
- There is a new system property "h2.storeLocalTime" to avoid problems opening a database file in a timezone that has different daylight saving rules (see also below).
- Date, time, and timestamp data type processing has been re-implemented. Time now supports nanoseconds resolution and now now supports a wider range (negative and large values), similar to PostgreSQL.
- SQL statements with a non-breaking space were considered invalid.

## Version 1.3.157 (2011-06-25)

- The syntax for CREATE TABLE ... AS SELECT ... has been changed: options such as NOT PERSISTENT are now before the query (AS SELECT), because otherwise they might be interpreted as a part of the query.
- With version 1.3.156, the DB2 mode could not be used with CLOB and BLOB data.
- When upgrading from an older 1.3.x version to version 1.3.156, CLOB and BLOB data was lost in many cases.
- The optimization for COUNT(..) on columns that are not nullable was also used for COUNT(DISTINCT ..), which is incorrect.
- PgServer: non-admin users could not open a database.
- Non-admin users could not open a database using a mode (MODE=xxx) if the database was already open, even if the mode matched.
- The SQL state of the following exceptions has been changed: From 90009, 90010, 90011 to 22007: "Cannot parse DATE/TIME/TIMESTAMP constant ...".
- There is a problem when opening a database file in a timezone that has different daylight saving rules: the time part of dates where the daylight saving doesn't match will differ. This is not a problem within regions that use the same rules (such as, within USA, or within Europe), even if the timezone itself is different. As a workaround, export the database to a SQL script using the old timezone, and create a new database in the new timezone. The same problem occurs when accessing a database over TCP/IP if the client and server timezones use different rules, if an old server or client is used.

## Version 1.3.156 (2011-06-17)

- Issue 323: NullPointerException when using IN(...) with a function table.
- Clob.toString() and Blob.toString() now include the trace identifier.
- The SQL parser silently ignored characters such as '^' or '\'. Now a syntax error is thrown.
- ROUND(..) now also works with just one parameter.
- Access to system tables is now more restrictive for non-admin users (the tables can be still listed, but some of the data is not included).
- BLOB: InputStream.skip is now more efficient in embedded mode.
- The default expression of a column may no longer reference the table, because a database with such a table couldn't be opened normally.
- Referenced objects in check constraints could be dropped, which resulted in a database that can't be opened normally.
- Improved Oracle compatibility for NVL2. Thanks again to litailang for the patch.
- CSVREAD now supports the option 'preserveWhitespace'.
- Recursive queries with many rows could throw an IndexOutOfBoundsException.
- The auto-server mode can't be combined with an in-memory database. This invalid combination wasn't detected so far. Now trying to open a database in this way fails.
- Improved performance for reading and writing date and time values.
- Java functions: array component types are now preserved, so that a ResultSet.getObject() will return Integer[] if the Java functions returns Integer[]. Thanks to Noel Grandin for the patch. Component types are transferred over the network, but not persisted in the database file as of now.
- Recover tool: the script generated by the recover tool didn't work if fulltext search was used, because the triggers were created before the primary keys.
- Issue 321: the database does not expect XA rollback without XA prepare (an exception was unnecessarily written into the .trace.db file).
- Read-only databases: some queries (such as distinct queries) tried to create temporary tables, which failed for read only databases.
- This database no longer uses finalize() except for temporary files. The system property "h2.runFinalize" is no longer supported. Unclosed connections are still detected, but the opening stack trace is now collected only if connections are not closed repeatedly (starting with the second unclosed connection). To detect unclosed connections, a PhantomReference is used.
- Issue 322: Left joins didn't work when used as subquery in the form clause.
- A prepared statement if type CALL that returned a result set could throw a NullPointerException if executed multiple times.
- The following built-in functions were marked as deterministic and therefore not re-executed when using in a prepared statement: LOCK_TIMEOUT, LINK_SCHEMA, CANCEL_SESSION, FILE_READ.
- Count on a column that can not be null is now optimized to COUNT(*). Thanks a lot to Ross Judson for providing a patch and test case!
- The following prepared statements are now cached as well: insert, update, delete, call, merge, and transactional commands.
- The built-in connection pool is now a bit faster.
- The scale was not set correctly in some cases when using CREATE TABLE AS SELECT if there was no explicit column definition.
- When trying to connect to a server using TCP/IP failed, it will retry at most until the timeout. Before, it was the timeout multiplied with the retry count.

## Version 1.3.155 (2011-05-27)

- When altering a table with triggers, new triggers are created and initialized with a table name that ends with tableName_COPY_x_y. The plan is that this will not be required in future versions.
- If some of the file system operations failed, System.gc() was called in a loop. Now it is called once at most.
- Triggers (including the fulltext search) could throw the exception 'Unexpected code path' in Session.log.
- CURRENT_TIMESTAMP() and so on now return the same value within a transaction.
- The statement CALL no longer converts an ARRAY return value to a list of values. Now an ARRAY is returned.
- VALUES is now supported as a standalone command and as a table source: SELECT * FROM (VALUES(1, 'Hello'), (2, 'World')) AS V;
- TIMESTAMPADD is now an alias for DATEADD. Most SQL_TSI_ constants are now supported for for TIMESTAMPADD and TIMESTAMPDIFF (all except SQL_TSI_QUARTER and SQL_TSI_FRAC_SECOND).
- Issue 313: NullPointerException in select query with a subquery or view.
- Native fulltext search: the characters '<', '>', and '\' are now also whitespace characters. Also, the list of whitespace characters can be changed using FullText.setWhitespaceChars(conn, ...)
- When reading from the classpath (for example read_file('classpath:logo.png')), now the content class loader is used if the resource can't be found otherwise.
- The statement "script drop" create a script that couldn't be executed if a table contained a reference to a user defined function.
- Opening a database with both multi-threaded mode and lock mode 0 (disable locking) was possible (but only once), even thought it does not work properly. Now it is no longer allowed.
- LOB objects are now deleted (and the empty space is reused) when the transaction is committed. So far, the space wasn't re-used until the connection was closed.
- SCRIPT DROP did not use the cascade option for table, which would cause problems if a view was dropped before a table it depends on. Now the cascade option is used.
- The query plan of queries with subqueries that contain nested joins was wrong. This could result in syntax exceptions for correct queries. Example: select 1 from (select 2 from ((test t1 inner join test t2 on t1.id=t2.id) inner join test t3 on t3.id=t1.id)) x;
- DatabaseEventListener.init was called with a null url when using the server mode.
- Support for the function LN (an alias for LOG).
- Support for the function CEIL (an alias for CEILING).
- Issue 315: Access to LOBs could cause a Java level deadlock.
- Support for the ICU4J collator.
- Improved Oracle compatibility: support for NVL2. Thanks to litailang for the patch!
- Improved PostgreSQL compatibility: support for RANDOM() in addition to RAND().
- There was a classloader memory leak problem because a class contained a static references to an exception (including stack trace).
- Split file system: truncating a file now deletes the parts in reverse order, so that the file list is consistent if the process is interrupted while truncating.
- The H2 JDBC client can now be used in an unsigned Applet. The problem was that System.getProperty throws a SecurityException, which is now ignored.
- The condition "in(select ...)" did not work correctly if the subquery could not be converted to a "distinct" query, as in: "select * from dual where x in (select x from dual group by x order by max(x))". Now the subquery needs to be made distinct manually if this optimization is needed.
- In the last release, the error code for "Wrong user name or password" was still 08004 instead of 28000, which resulted in the wrong error message.
- In some cases, creating a new table or altering an existing table threw the exception: Unique index or primary key violation: "PRIMARY KEY ON """".PAGE_INDEX".
- The Shell tool no longer supports the built-in command "show", because it is a legal SQL statement for H2 and MySQL. However, the "describe" command is still supported, and now lists all tables if called without parameter.
- The sorted insert mode (as in "insert into ... direct sorted select") did not work for not-persisted tables in a persisted database. It threw a ClassCastException.
- Issue 308: Statement.getGeneratedKeys() now returns an empty result set if no key was generated.
- The h2small.jar (created with build jarSmall) included the Android API. This has been removed, shrinking the jar file by 21 KB.
- When creating a table, the precision must now be at least as large as the scale.
- Support for Java 1.3 and Java 1.4 has been removed.
- Improved error message for syntax error: the list of expected tokens was sometimes not set correctly.
- Database file growth can now be limited using the database setting PAGE_STORE_MAX_GROWTH. Slower growth may slow down operation, but speed up closing database.
- A read only database with writable linked tables could lead to a DATABASE_IS_READ_ONLY (90097) error. This is fixed now.

## Version 1.3.154 (2011-04-04)

- The SQL state of the following exceptions has been changed: From 90005 to 22001: "Value too long for column ...: ...". From 90039 to 22003: "The value is too large for the precision ..." is merged with "Numeric value out of range". From 90110 to 22003: "... out of range" is merged with "Numeric value out of range". From 90021 to 22018: "Data conversion error converting ...". From 90006 to 23502: "NULL not allowed for column ...". From 23003 to 23503: "Referential integrity constraint violation: ...". From 23001 to 23505: "Unique index or primary key violation: ...". From 23002 to 23506: "Referential integrity constraint violation: ...". From 90056 to 23507: "No default value is set for column ...". From 23000 to 23513: "Check constraint violation: ...". From 08004 to 28000: "Wrong user name or password". From 90051 to 57014: "Statement was canceled or the session timed out".
- The H2 Console now detects unsupported command line options. (In the future, it will be combined with the Server tool.)
- MySQL compatibility: SHOW COLUMN FOR schemaName.columnName.
- DatabaseMetaData.getCrossReference now also lists the name of the primary index (PK_NAME).
- If the database contained many CLOB or BLOB values, then closing a connection was very slow. Reason: was that when closing a connection, the temporary CLOB and BLOB values for this connection were removed, but there was no index on this column. For existing databases with many CLOB and BLOB values, creating the index may take a few seconds. The index is added to existing databases automatically.
- If a CLOB or BLOB was copied into the same table using INSERT INTO X ... SELECT ... FROM X, and then the original row was deleted, then the copied value was also deleted. This could also result in an ArrayIndexOutOfBoundsException on checkpoint or when closing the database.
- Improved performance (up to 10%) due to changed synchronization in the page store.
- Reading a resource from the classpath didn't work if there was a leading slash (classpath:/org/...). Now resources can be loaded with or without leading slash.
- Support INSERT INTO TEST SET ID = 1, NAME = 'World' (MySQL compatibility).
- Issue 304: The condition [NOT] IN (SELECT ...) could throw the exception "Unexpected code path" if the subquery contained ORDER BY.
- ALTER TABLE ALTER ADD / REMOVE /ALTER COLUMN dropped some dependent objects (access rights, triggers) of views that depend on the modified table.
- CREATE OR REPLACE VIEW dropped some dependent objects (access rights, triggers) if the view already existed before.
- New aggregate function HISTOGRAM to calculate the histogram. The plan is to use this function is only used internally when running ANALYZE to generate the histogram that is then used by the query optimizer.
- New system function TRUNCATE_VALUE to truncate a value to the required precision. This is the same as for CAST, but without changing the data type, and support for truncating decimal values. (The main use case for this function is to build a histogram of the truncated values). Now BINARY, BLOB, and CLOB can be truncated / cast efficiently as well.
- The precision of an ARRAY value is now the sum of the precision of all elements, and result set values have the precision Integer.MAX_VALUE.
- CAST(x AS VARCHAR_IGNORECASE(y) / CHAR(y)) returned a VARCHAR if the new precision was lower than the old precision.
- SHUTDOWN DEFRAG didn't defragment the database completely if there was a unique hash index for a memory table.
- There were some smaller changes in the encrypting file system (work in progress).
- Some time and timezone functions didn't support years before 1.

## Version 1.3.153 (2011-03-14)

- Issue 294: The Maven source bundle now contains a manifest file that allows Eclipse to automatically attach the source code (if Maven is used).
- A query with an explicit LIMIT 0 will now return no rows (so far it meant no limit), which is compatible with PostgreSQL and MySQL. A negative limit value, (as well as LIMIT NULL) mean no limit (so far a negative limit meant a limit of one row). There were similar problems with OFFSET.
- A new encrypting file system has been implemented. It is currently experimental, and not included in the main jar file. The idea is to allow encrypting all files, not just database files. Also implemented is a simple file system shell tool. At some point, this might replace the Backup, ChangeFileEncryption, DeleteDbFiles, and Restore tools.
- Lob in database: storing lob objects was not correctly synchronized. This was specially a problem when using Connection.createBlob() / createClob().
- Updated the license page (thanks a lot to Abe to help me with this).
- Support for database paths with '\' on non-Windows systems.
- The NIO cleaner hack wasn't working as expected, because the clear method was called instead of the clean method. This has been fixed. Please note this hack is not enabled by default, to try it you need to set the system property "h2.nioCleanerHack" to true.
- Improved MS SQL Server and MySQL compatibility: support DELETE with TOP or LIMIT.
- Support for COSH, SINH, and TANH functions.
- Support for the % operator (modulo) thanks to Noel Grandin.
- Issue 288: Some right outer join queries failed to produce the correct result or threw exceptions such as "column x must be in the group by list".
- Some right outer joins with invalid column referenced (typos) threw a NullPointerException instead of "column not found" exception.
- New database setting EARLY_FILTER to allow table implementations to apply filter conditions early on.
- Cluster: in a two node cluster, if cluster node stopped, and autocommit was enabled, then changes on the remaining cluster node didn't get committed automatically.
- Issue 291: Allow org.h2.value.Value as FUNCTION ALIAS params and return value.
- Issue 265: Linked tables: auto-reconnect if the backside connection is lost (workaround for the MySQL problem that disconnects after 8 hours of inactivity).
- Linked tables: the index conditions was sometimes not used when querying the remote database.
- Issue 294: OSGi: the versions were missing in manifest package exports.
- The option -baseDir didn't work with symbolic links.
- Support for ALTER TABLE ADD COLUMN IF NOT EXISTS.
- Database-level connection settings could only be set in the database URL, but not using the Properties parameter of DriverManager.getConnection(String url, Properties info).

## Version 1.3.152 Beta (2011-03-01)

- H2 Console: browser detection didn't work for Mac OS X with OpenJDK 1.7.
- The double or float value -0.0 is now distinct from 0.0 (as in Java).
- TCP and PG server: if the default port is already in use, the services are now started on another free port (unless the port is explicitly set). This allows to start the H2 Console even if the TCP or PG servers are already running.
- LIKE didn't use an index unless the right hand side was a literal or parameter. Now an index is used for LIKE CONCAT(?, '%').
- Array literals with zero or one element were not be parsed correctly. Now trailing commas are ignored (as in Java). Expressions of the form '(1)' are still parsed as the value 1. An empty array is '()'. An array with one element must contain a comma to be parsed as an array, as in '(1,)'.
- Issue 290: Conditions using subqueries were sometimes evaluated before much simpler conditions, which was very bad for performance. This includes subqueries returning a value, EXISTS subqueries, and IN(SELECT ..) subqueries.
- Issue 288: Some queries with right outer joins or nested joins could throw a NullPointerException.
- The database can now be compiled with Java 7. Stub methods for the new JDBC 4.1 methods have been implemented, but the new features can't be used yet.
- Issue 289: Railroads (BNF) for "Column Definition" was incorrect.
- Issue 287: Railroads (BNF) is not readable for certain web-browser configurations (dark background).
- Executing a CSVREAD query multiple times could result in an exception if the data was changed on disk.
- SQL railroad diagrams: improved images for people with black background settings.
- Build-in documentation search: improved results if searching for multiple words.
- DatabaseMetaData.getColumns: there is a typo in the JDBC specification, so that the column #19 is named SCOPE_CATLOG instead of SCOPE_CATALOG. For compatibility with the specification, a new column #24 named SCOPE_CATLOG is added. This typo is fixed in the JDBC 4.1 specification. Please note that MySQL only supports SCOPE_CATALOG, while other databases only support SCOPE_CATLOG.
- Build: jar files are now downloaded using Maven if possible (and cached in the local Maven repository). Unfortunately, in many cases this will download more data from the Maven repository.
- JaQu has been improved a lot thanks to the new committer James Moger.
- New sample application that shows how to use "instead of" triggers to support updatable views.
- H2 Console: opening a MS SQL Server database is now faster. Also, listing the database meta data sometimes resulted in an exception.
- Linked tables / MS SQL Server: if the tables were created in mixed case in MS SQL Server, then the identifiers in the linked tables were case sensitive (in H2).
- MVCC: the probability of a lock timeout is now lower if multiple threads try to update the same rows.
- Building only the documentation (without compiling all classes) didn't work, specially: ./build.sh clean javadocImpl.
- Documentation on how data is stored internally and how indexes work (in the performance section).
- Some people reported NullPointerException in FileObjectDiskMapped. The most likely explanation is that multiple threads access the same object at the same time. Therefore, the public methods in this class are now synchronized.
- Improved error detection when starting a server with invalid arguments, such as "-tcpPort=9091" or "-tcpPort 9091" (as one parameter) instead of "-tcpPort", "9091".
- The function STRINGDECODE ignored characters after a non-escaped double quote. This is no longer the case.
- The new CSV option feature introduced in version 1.3.150 didn't support spaces. Now the escape mechanism is changed to support it.
- The pseudo-column "_ROWID_" now supports insert, update, and merge (only enabled for version 1.3.x).
- Deleting rows in the trigger table inside a trigger could result in a NullPointerException.

## Version 1.3.151 Beta (2011-02-12)

- Server: it was possible to open a database outside of the base URL (if one was set). The test case was broken.
- The H2 Console tool now supports a database URL as a command line option.
- Clob.getSubString and Blob.getBytes are now up to 3 times faster.
- New database setting DEFAULT_CONNECTION (disabled by default) to support DriverManager.getConnection("jdbc:default:connection"). Please note the Oracle JDBC driver will try to resolve this database URL if it is loaded before the H2 driver.
- JaQu: the static map Db.TOKENS was not synchronized.
- DatabaseMetaData.getProcedureColumns returned the wrong data (it also returned the Connection parameter if there was any).
- Issue 284: If the query cache was used (enabled by default in version 1.3.x), and multiple threads used the same connection, and the same query but different prepared statements, parameters of one prepared statement could be overwritten by another.
- If the query cache was used (enabled by default in version 1.3.x), parameters of re-used queries were not reset in prepared statements.
- CallableStatement: the first row of the result set was skipped when using CallableStatement.execute().
- Batch update exceptions now include the root cause and all chained exceptions (getNextException).
- Reading a large result set with a BLOB or CLOB column could throw a NullPointerException.
- Support for the MS SQL Server syntax VARCHAR(MAX).
- The Recover tool could print "/ by zero" on an empty database.
- For tables without a single column primary key of type INT or LONG, the unique row id had gaps, which didn't look nice.
- Each table now has a pseudo-column "_ROWID_" to get the unique row id (only enabled for version 1.3.x).
- User defined functions can now have parameters of any class. Values of type OTHER (or OBJECT or JAVA_OBJECT) are automatically de-serialized in that case.
- Linked tables: for NUMERIC column, Oracle reports precision 0 and scale -127. A workaround has been implemented (the same as for DECIMAL columns in version 1.3.150).
- Issue 279: Auto-Server mode: unclear error message when trying to connect using AUTO_SERVER if the database is already open without the flag (Connection is broken: "null").
- Issue 238: Can drop a column that has a single-column constraint.

## Version 1.3.150 Beta (2011-01-28)

- CSVREAD / CSVWRITE: instead of setting the options one by one, all options can be combined into a space separated key-value pairs.
- CSVREAD / CSV tool: there is a new option "lineCommentCharacter" to set or disable line comments. For H2 version 1.2, the default is '#' (as before). For H2 version 1.3, line comments are disabled by default.
- Issue 277: JaQu didn't correctly convert a CLOB column to a String.
- ./build.sh testNetwork could block if there was a network configuration problem.
- Reading input streams from the classpath is now supported. Example: RUNSCRIPT FROM 'classpath:org/h2/samples/newsfeed.sql'.
- PreparedStatement.toString() now includes the parameter values in a human readable format.
- New database setting OPTIMIZE_IN_SELECT (enabled by default for version 1.3.x). If enabled, IN(SELECT...) conditions are faster if there are many rows in the table or subquery.
- Linked tables: for DECIMAL column, Oracle reports precision 0 and scale -127. A workaround has been implemented.
- TCP Server: a base directory with a prefix with a database name with prefix didn't work as expected (this only applies to non-disk and wrapped file systems).
- Version 1.3: when re-running the same query so that the previous result was re-used, and if the result set was large so that it was stored externally (in a temp file or in a temp table), then reading rows from both result sets resulted in an exception or wrong behavior.
- A new sample application that shows how to create a read-only database in a zip file where the database file is split into multiple smaller parts.
- The Backup tool now supports compressing all files in a given directory.
- H2 Console: the special syntax @list and @meta can not be combined.
- The wrong error message was thrown when trying to open a database where the database file could not be read for some reason (for example because the split file system was used, and the file was split at the wrong position).
- There was a memory leak in the trace system. Opening and closing many connections could run out of memory.
- The scan-resistant cache type "TQ" (two queue) is again available. To use it, append ;CACHE_TYPE=TQ to the database URL.

## Version 1.3.149 Beta (2011-01-07)

- Lob in database: after the process was killed while adding a lob, inserting a lob could throw an exception (primary key violation in LOB_MAP).
- Server tool: the tcpShutdown feature now also stops other servers (web server and PostgreSQL server).
- Server tool: the tcpShutdown url must now end with the port if the port is used.
- Server tool: when starting one service fails, the started services are now stopped.
- Multi-version concurrency: SELECT ... FOR UPDATE threw a "concurrent update" exception immediately instead of a "lock timeout" exception after the set lock timeout if the row was already locked by another connection.
- Translation: the H2 Console and error messages have been translated to Czech by Hannibal (http://hannibal.cestiny.cz/). Thanks a lot!
- When the system property h2.lobInDatabase is set, reading a BLOB is a bit faster because the length is not read.
- The SimpleResultSet now has a feature to not close the result set after reading the last row.
- Native fulltext search: the ignore list doesn't need to be all uppercase now.
- Improved statistics output in the Recover tool.
- Issue 269: GROUP BY queries with a column or having clause that contains IN(SELECT ...) could return the wrong values. Example: SELECT X IN(SELECT Y) FROM Z GROUP BY X.
- After closing a database, the writer thread will stop almost immediately (instead of after at most 100 ms). This should avoid error messages in the Tomcat log file after a shutdown.
- Issue 271: ResultSet.getConcurrency() did not correctly detect that the result set is not updatable.
- The SLF4J 1.6 API is now used by default (this should not have any user visible effect).
- The org.h2.tools.Console no longer calls System.exit on shutdown (this should not have any user visible effect, but should allow to integrate the tool easier into other applications).
- Improved date / time arithmetics. Adding and subtracting a floating point value from a date or timestamp is now supported.
- When creating a BLOB with in InputStream or a CLOB with a Reader, and the InputStream or Reader threw an non-IOException, then the LOB storage was broken when storing LOBs in the database.
- EXPLAIN SELECT didn't include the sample size if one was set.
- Improved EXPLAIN plan formatting and documentation.
- Issue 266: Domains: a NOT NULL clause in a domain definition ignored.
- More accurate calculation of variance and standard deviation for large number of samples with low variance (now using Welford's method).
- Server: CLOB data with unicode characters between character code 0xd800 and 0xdfff were not transferred correctly. In many cases, the thread was stuck afterwards.
- Issue 264: the Hibernate dialect in src/tools was removed because it is outdated.
- Cache size limit could be exceeded for certain queries, leading to an OutOfMemoryError in some cases. Fixed.