changelog.html 62.0 KB
Newer Older
1 2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<!--
3
Copyright 2004-2011 H2 Group. Multiple-Licensed under the H2 License, Version 1.0,
4 5
and under the Eclipse Public License, Version 1.0
(http://h2database.com/html/license.html).
6 7 8 9 10 11
Initial Developer: H2 Group
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head><meta http-equiv="Content-Type" content="text/html;charset=utf-8" /><title>
Change Log
</title><link rel="stylesheet" type="text/css" href="stylesheet.css" />
12
<!-- [search] { -->
13 14 15
<script type="text/javascript" src="navigation.js"></script>
</head><body onload="frameMe();">
<table class="content"><tr class="content"><td class="content"><div class="contentDiv">
16
<!-- } -->
17 18 19 20

<h1>Change Log</h1>

<h2>Next Version (unreleased)</h2>
21
<ul>
22 23
<li>Support for database paths with backslashes on non Windows systems.
</li><li>Improved MS SQL Server and MySQL compatibility: support DELETE with TOP or LIMIT.
24
</li><li>Support for COSH, SINH, and TANH functions.
25
</li><li>Support for the % operator (modulo) thanks to Noel Grandin.
26
</li><li>Issue 288: Some right outer join queries failed to produce the correct result or
27 28 29 30
    threw exceptions such as "column x must be in the group by list".
</li><li>Some right outer joins with invalid column referenced (typos) threw a NullPointerException instead of
    "column not found" exception.
</li><li>New database setting EARLY_FILTER to allow table implementations 
31 32
    to apply filter conditions early on.
</li><li>Cluster: in a two node cluster, if cluster node stopped, and autocommit was enabled,
33 34
    then changes on the remaining cluster node didn't get committed automatically.
</li><li>Issue 291: Allow org.h2.value.Value as FUNCTION ALIAS params and return value.
35
</li><li>Issue 265: Linked tables: auto-reconnect if the backside connection is lost
Thomas Mueller's avatar
Thomas Mueller committed
36 37 38 39
    (workaround for the MySQL problem that disconnects after 8 hours of inactivity).
</li><li>Linked tables: the index conditions was sometimes not used when querying the remote database.
</li><li>Issue 294: OSGi: the versions were missing in manifest package exports.
</li><li>The option -baseDir didn't work with symbolic links.
40
</li><li>Support for ALTER TABLE ADD COLUMN IF NOT EXISTS.
Thomas Mueller's avatar
Thomas Mueller committed
41
</li><li>Database-level connection settings could only be set in the database URL,
Thomas Mueller's avatar
Thomas Mueller committed
42
    but not using the Properties parameter of DriverManager.getConnection(String url, Properties info).
Thomas Mueller's avatar
Thomas Mueller committed
43 44 45 46 47
</li></ul>

<h2>Version 1.3.152 Beta (2011-03-01)</h2>
<ul><li>H2 Console: browser detection didn't work for Mac OS X with OpenJDK 1.7.
</li><li>The double or float value -0.0 is now distinct from 0.0 (as in Java).
Thomas Mueller's avatar
Thomas Mueller committed
48 49 50 51 52 53
</li><li>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.
</li><li>LIKE didn't use an index unless the right hand side was a literal or parameter.
    Now an index is used for LIKE CONCAT(?, '%').
</li><li>Array literals with zero or one element were not be parsed correctly.
54
    Now trailing commas are ignored (as in Java). Expressions of the form '(1)' are still parsed as the value 1.
Thomas Mueller's avatar
Thomas Mueller committed
55
    An empty array is '()'. An array with one element must contain a comma to be parsed as an array, as in '(1,)'.
56
</li><li>Issue 290: Conditions using subqueries were sometimes evaluated before much simpler conditions,
57 58 59
    which was very bad for performance. This includes subqueries returning a value, EXISTS subqueries,
    and IN(SELECT ..) subqueries.
</li><li>Issue 288: Some queries with right outer joins or nested joins could throw a NullPointerException.
60
</li><li>The database can now be compiled with Java 7.
61 62 63
    Stub methods for the new JDBC 4.1 methods have been implemented,
    but the new features can't be used yet.
</li><li>Issue 289: Railroads (BNF) for "Column Definition" was incorrect.
Thomas Mueller's avatar
Thomas Mueller committed
64 65
</li><li>Issue 287: Railroads (BNF) is not readable for certain web-browser configurations (dark background).
</li><li>Executing a CSVREAD query multiple times could result in an exception if the data was changed on disk.
Thomas Mueller's avatar
Thomas Mueller committed
66
</li><li>SQL railroad diagrams: improved images for people with black background settings.
Thomas Mueller's avatar
Thomas Mueller committed
67 68
</li><li>Build-in documentation search: improved results if searching for multiple words.
</li><li>DatabaseMetaData.getColumns: there is a typo in the JDBC specification, so that the column #19 is named
69 70
    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.
Thomas Mueller's avatar
Thomas Mueller committed
71 72 73 74 75
    Please note that MySQL only supports SCOPE_CATALOG, while other databases only support SCOPE_CATLOG.
</li><li>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.
</li><li>JaQu has been improved a lot thanks to the new committer James Moger.
</li><li>New sample application that shows how to use "instead of" triggers to support updatable views.
76
</li><li>H2 Console: opening a MS SQL Server database is now faster.
Thomas Mueller's avatar
Thomas Mueller committed
77
    Also, listing the database meta data sometimes resulted in an exception.
Thomas Mueller's avatar
Thomas Mueller committed
78
</li><li>Linked tables / MS SQL Server: if the tables were created in mixed case in MS SQL Server,
Thomas Mueller's avatar
Thomas Mueller committed
79
    then the identifiers in the linked tables were case sensitive (in H2).
Thomas Mueller's avatar
Thomas Mueller committed
80
</li><li>MVCC: the probability of a lock timeout is now lower if multiple threads try to update the same rows.
Thomas Mueller's avatar
Thomas Mueller committed
81 82 83 84 85 86
</li><li>Building only the documentation (without compiling all classes) didn't work, specially: ./build.sh clean javadocImpl.
</li><li>Documentation on how data is stored internally and how indexes work (in the performance section).
</li><li>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.
</li><li>Improved error detection when starting a server with invalid arguments,
Thomas Mueller's avatar
Thomas Mueller committed
87
    such as "-tcpPort=9091" or "-tcpPort 9091" (as one parameter) instead of "-tcpPort", "9091".
Thomas Mueller's avatar
Thomas Mueller committed
88
</li><li>The function STRINGDECODE ignored characters after a non-escaped double quote.
Thomas Mueller's avatar
Thomas Mueller committed
89 90 91 92 93
    This is no longer the case.
</li><li>The new CSV option feature introduced in version 1.3.150 didn't support spaces.
    Now the escape mechanism is changed to support it.
</li><li>The pseudo-column "_ROWID_" now supports insert, update, and merge (only enabled for version 1.3.x).
</li><li>Deleting rows in the trigger table inside a trigger could result in a NullPointerException.
Thomas Mueller's avatar
Thomas Mueller committed
94 95 96
</li></ul>

<h2>Version 1.3.151 Beta (2011-02-12)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
97 98 99 100
<ul><li>Server: it was possible to open a database outside of the base URL
    (if one was set). The test case was broken.
</li><li>The H2 Console tool now supports a database URL as a command line option.
</li><li>Clob.getSubString and Blob.getBytes are now up to 3 times faster.
101
</li><li>New database setting DEFAULT_CONNECTION (disabled by default)
102 103 104
    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.
</li><li>JaQu: the static map Db.TOKENS was not synchronized.
Thomas Mueller's avatar
Thomas Mueller committed
105 106
</li><li>DatabaseMetaData.getProcedureColumns returned the wrong data
    (it also returned the Connection parameter if there was any).
Thomas Mueller's avatar
Thomas Mueller committed
107 108
</li><li>Issue 284: If the query cache was used (enabled by default in version 1.3.x),
    and multiple threads used the same connection,
Thomas Mueller's avatar
Thomas Mueller committed
109 110
    and the same query but different prepared statements,
    parameters of one prepared statement could be overwritten by another.
Thomas Mueller's avatar
Thomas Mueller committed
111
</li><li>If the query cache was used (enabled by default in version 1.3.x),
Thomas Mueller's avatar
Thomas Mueller committed
112 113 114 115 116 117
    parameters of re-used queries were not reset in prepared statements.
</li><li>CallableStatement: the first row of the result set was skipped when using CallableStatement.execute().
</li><li>Batch update exceptions now include the root cause and all chained exceptions (getNextException).
</li><li>Reading a large result set with a BLOB or CLOB column could throw a NullPointerException.
</li><li>Support for the MS SQL Server syntax VARCHAR(MAX).
</li><li>The Recover tool could print "/ by zero" on an empty database.
Thomas Mueller's avatar
Thomas Mueller committed
118
</li><li>For tables without a single column primary key of type INT or LONG,
Thomas Mueller's avatar
Thomas Mueller committed
119 120 121 122 123
    the unique row id had gaps, which didn't look nice.
</li><li>Each table now has a pseudo-column "_ROWID_" to get the unique row id (only enabled for version 1.3.x).
</li><li>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.
</li><li>Linked tables: for NUMERIC column, Oracle reports precision 0 and scale -127.
Thomas Mueller's avatar
Thomas Mueller committed
124 125
    A workaround has been implemented (the same as for DECIMAL columns in version 1.3.150).
</li><li>Issue 279: Auto-Server mode: unclear error message when trying to connect using AUTO_SERVER
126 127
    if the database is already open without the flag (Connection is broken: "null").
</li><li>Issue 238: Can drop a column that has a single-column constraint.
Thomas Mueller's avatar
Thomas Mueller committed
128 129 130
</li></ul>

<h2>Version 1.3.150 Beta (2011-01-28)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
131
<ul><li>CSVREAD / CSVWRITE: instead of setting the options one by one,
Thomas Mueller's avatar
Thomas Mueller committed
132 133 134
    all options can be combined into a space separated key-value pairs.
</li><li>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.
135
</li><li>Issue 277: JaQu didn't correctly convert a CLOB column to a String.
Thomas Mueller's avatar
Thomas Mueller committed
136 137 138 139
</li><li>./build.sh testNetwork could block if there was a network configuration problem.
</li><li>Reading input streams from the classpath is now supported. Example:
    RUNSCRIPT FROM 'classpath:org/h2/samples/newsfeed.sql'.
</li><li>PreparedStatement.toString() now includes the parameter values in a human readable format.
Thomas Mueller's avatar
Thomas Mueller committed
140 141 142 143 144
</li><li>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.
</li><li>Linked tables: for DECIMAL column, Oracle reports precision 0 and scale -127.
    A workaround has been implemented.
</li><li>TCP Server: a base directory with a prefix with a database name with prefix didn't work as expected
145 146
    (this only applies to non-disk and wrapped file systems).
</li><li>Version 1.3: when re-running the same query so that the previous result was re-used,
Thomas Mueller's avatar
Thomas Mueller committed
147
    and if the result set was large so that it was stored externally (in a temp file or in a temp table),
Thomas Mueller's avatar
Thomas Mueller committed
148 149
    then reading rows from both result sets resulted in an exception or wrong behavior.
</li><li>A new sample application that shows how to create
150 151 152 153
    a read-only database in a zip file where the database file is split into multiple smaller parts.
</li><li>The Backup tool now supports compressing all files in a given directory.
</li><li>H2 Console: the special syntax @list and @meta can not be combined.
</li><li>The wrong error message was thrown when trying to open a database where the database file
154 155 156
    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).
</li><li>There was a memory leak in the trace system. Opening and closing many connections could run out of memory.
157 158
</li><li>The scan-resistant cache type "TQ" (two queue) is again available.
    To use it, append ;CACHE_TYPE=TQ to the database URL.
Thomas Mueller's avatar
Thomas Mueller committed
159 160
</li></ul>

Thomas Mueller's avatar
Thomas Mueller committed
161
<h2>Version 1.3.149 Beta (2011-01-07)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
162 163 164
<ul><li>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).
</li><li>Server tool: the tcpShutdown feature now also stops other servers (web server and PostgreSQL server).
Thomas Mueller's avatar
Thomas Mueller committed
165 166 167
</li><li>Server tool: the tcpShutdown url must now end with the port if the port is used.
</li><li>Server tool: when starting one service fails, the started services are now stopped.
</li><li>Multi-version concurrency: SELECT ... FOR UPDATE threw a "concurrent update" exception immediately
Thomas Mueller's avatar
Thomas Mueller committed
168 169 170
    instead of a "lock timeout" exception after the set lock timeout if the row was already locked by another connection.
</li><li>Translation: the H2 Console and error messages have been translated to Czech by Hannibal (http://hannibal.cestiny.cz/). Thanks a lot!
</li><li>When the system property h2.lobInDatabase is set, reading a BLOB is a bit faster
171 172
    because the length is not read.
</li><li>The SimpleResultSet now has a feature to not close the result set after reading the last row.
Thomas Mueller's avatar
Thomas Mueller committed
173 174
</li><li>Native fulltext search: the ignore list doesn't need to be all uppercase now.
</li><li>Improved statistics output in the Recover tool.
Thomas Mueller's avatar
Thomas Mueller committed
175
</li><li>Issue 269: GROUP BY queries with a column or having clause that contains IN(SELECT ...)
Thomas Mueller's avatar
Thomas Mueller committed
176 177
    could return the wrong values. Example: SELECT X IN(SELECT Y) FROM Z GROUP BY X.
</li><li>After closing a database, the writer thread will stop almost immediately (instead of after at most 100 ms).
Thomas Mueller's avatar
Thomas Mueller committed
178 179 180
    This should avoid error messages in the Tomcat log file after a shutdown.
</li><li>Issue 271: ResultSet.getConcurrency() did not correctly detect that the result set is not updatable.
</li><li>The SLF4J 1.6 API is now used by default (this should not have any user visible effect).
181
</li><li>The org.h2.tools.Console no longer calls System.exit on shutdown
182
    (this should not have any user visible effect, but should allow to integrate the tool easier into other applications).
Thomas Mueller's avatar
Thomas Mueller committed
183
</li><li>Improved date / time arithmetics. Adding and subtracting a
184 185
    floating point value from a date or timestamp is now supported.
</li><li>When creating a BLOB with in InputStream or a CLOB with a Reader, and the InputStream or Reader
186 187
    threw an non-IOException, then the LOB storage was broken when storing LOBs in the database.
</li><li>EXPLAIN SELECT didn't include the sample size if one was set.
Thomas Mueller's avatar
Thomas Mueller committed
188 189
</li><li>Improved EXPLAIN plan formatting and documentation.
</li><li>Issue 266: Domains: a NOT NULL clause in a domain definition ignored.
190
</li><li>More accurate calculation of variance and standard deviation for large number of samples with low variance
Thomas Mueller's avatar
Thomas Mueller committed
191 192
    (now using Welford's method).
</li><li>Server: CLOB data with unicode characters between character code 0xd800 and 0xdfff
193 194
    were not transferred correctly. In many cases, the thread was stuck afterwards.
</li><li>Issue 264: the Hibernate dialect in src/tools was removed because it is outdated.
195 196
</li><li>Cache size limit could be exceeded for certain queries, leading to an OutOfMemoryError
    in some cases. Fixed.
Thomas Mueller's avatar
Thomas Mueller committed
197 198 199
</li></ul>

<h2>Version 1.3.148 Beta (2010-12-12)</h2>
200 201 202
<ul><li>The built-in connection pool was simplified a bit.
    The dispose() method no longer throws an exception (it only logs it).
</li><li>The database upgrade (to upgrade from H2 version 1.1.x) has been simplified.
203 204
</li><li>The feature to log all errors (system properties h2.logAllErrors and h2.logAllErrorsFile) has been removed.
</li><li>When starting the H2 Console, the properties file can now be completely disabled.
Thomas Mueller's avatar
Thomas Mueller committed
205 206 207 208
</li><li>Server.openBrowser no longer writes to System.out directly if opening the URL failed.
</li><li>The INSERT optimizations (INSERT ... DIRECT SORTED SELECT) were not parsed correctly when using a column list.
</li><li>H2 Console: the tables and columns are now listed for SQLite as well.
</li><li>H2 Console: improved autocomplete feature (also simplified the source code for this feature).
Thomas Mueller's avatar
Thomas Mueller committed
209
</li><li>Issue 260: the DbStarter servlet context listener now starts the server before opening a connection,
Thomas Mueller's avatar
Thomas Mueller committed
210 211
    so that connecting using the server mode works.
</li><li>The Shell tool can now enable, disable, and display the current autocommit mode.
Thomas Mueller's avatar
Thomas Mueller committed
212
</li><li>Issue 259: there is a limitation in the cluster mode:
213 214
    The SQL statement SET AUTOCOMMIT FALSE doesn't work.
    To disable autocommit, the method Connection.setAutoCommit(false) needs to be called.
Thomas Mueller's avatar
Thomas Mueller committed
215
    This is now documented.
216
</li><li>Connection pool / DataSource: a NullPointerException was thrown when
Thomas Mueller's avatar
Thomas Mueller committed
217 218
    using a database URL that doesn't start with "jdbc:h2:".
</li><li>Using the java.sql.Blob or java.sql.Clob interfaces could throw the wrong
219
    exception after the object was closed.
220
</li><li>LOB: in server mode, if the feature "LOBs in database" is disabled,
Thomas Mueller's avatar
Thomas Mueller committed
221 222
    the temporary files are now created in the temp directory (the same as
    when "LOBs in database" is enabled).
Thomas Mueller's avatar
Thomas Mueller committed
223 224 225
</li></ul>

<h2>Version 1.2.147 (2010-11-21)</h2>
226 227 228
<ul><li>H2 Console: the server properties directory can now be set on the command line using
    java ... -properties &lt;directory&gt;. Issue 159.
</li><li>New feature INSERT INTO ... DIRECT SELECT, mainly to speed up loading tables
Thomas Mueller's avatar
Thomas Mueller committed
229
    from a CSV file. When using DIRECT, then the results from the query are directly applied
Thomas Mueller's avatar
Thomas Mueller committed
230 231 232 233 234 235 236 237 238
    in the target table without any intermediate step (without temporary file).
</li><li>Converting binary data to UUID was incorrect when the converting more than 31 bytes.
    Now always the first 16 bytes are used.
</li><li>Improved date / time arithmetics. Now supported are
    multiplying and dividing a time with / by a number,
    adding and subtracting a time to / from a time or date,
    subtracting a time or timestamp from a timestamp.
</li><li>The Ant build script has been removed because it is no longer up to date.
</li><li>Nested outer joins without brackets were not working as expected. Example:
Thomas Mueller's avatar
Thomas Mueller committed
239 240
    select * from a inner join b inner join c on c.id = b.id on b.id = a.id;
</li><li>JMX (the Java management extension) is now supported. Issue 253.
Thomas Mueller's avatar
Thomas Mueller committed
241 242 243
</li><li>Creating a comment on a column didn't work if the schema name was equal the database name.
</li><li>When using multi-version concurrency, re-running a prepared statement with the same parameters
    would sometimes give the same result even if another connection committed a change (the previous result was sometimes
244 245 246 247 248
    re-used incorrectly).
</li><li>When using SELECT_FOR_UPDATE_MVCC (lock only the selected rows when using MVCC),
    the selected rows were sometimes not locked correctly.
</li><li>When using Lucene 3, the index files were not always closed when the database was closed.
</li><li>Concurrently preparing a statement and altering a table could throw a table not found exception.
Thomas Mueller's avatar
Thomas Mueller committed
249
</li><li>When concurrently preparing many statements with a subquery, in some cases the query didn't run
Thomas Mueller's avatar
Thomas Mueller committed
250 251
    (Column "..." must be in the GROUP BY list).
</li><li>CallableStatement: now the syntax "{? = CALL...}" is supported as well.
Thomas Mueller's avatar
Thomas Mueller committed
252
</li><li>Lob in databases: two small BLOB or CLOB values were always considered equal.
Thomas Mueller's avatar
Thomas Mueller committed
253 254 255 256 257
    This also affected unique indexes.
</li><li>The shutdown hook is (re-) enabled by default even for H2 version 1.3.x.
</li><li>When creating a database from a recovery script, the same user can now be used
    (CREATE USER now always includes IF EXISTS).
</li><li>The H2 Console now prints a status message if started with parameters.
Thomas Mueller's avatar
Thomas Mueller committed
258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277
</li></ul>

<h2>Version 1.3.146 Beta (2010-11-08)</h2>
<ul><li>This is a beta version. The next version will be 1.2.147. The differences between 1.2.x and 1.3.x are:
</li><li>In version 1.3.x, h2.lobInDatabase (store CLOB and BLOB in the database file) is enabled by default.
</li><li>In version 1.3.x, ANALYZE_AUTO is 2000 (automatic ANALYZE).
</li><li>In version 1.3.x, DB_CLOSE_ON_EXIT (the shutdown hook) is disabled by default.
</li><li>In version 1.3.x, DROP_RESTRICT (default action for DROP is RESTRICT) is enabled.
</li><li>In version 1.3.x, FUNCTIONS_IN_SCHEMA (allow to store functions in a schema) is enabled.
</li><li>In version 1.3.x, LARGE_TRANSACTIONS (support for very large transactions) is enabled.
    Changes to tables without a primary key can be buffered to disk.
</li><li>In version 1.3.x, MAX_MEMORY_ROWS_DISTINCT is set to a 10000.
</li><li>In version 1.3.x, NESTED_JOINS (nested joins and right outer joins) is enabled.
</li><li>In version 1.3.x, OPTIMIZE_INSERT_FROM_SELECT (speed up CREATE TABLE ... AS SELECT) is enabled.
</li><li>In version 1.3.x, OPTIMIZE_OR (convert OR conditions to IN(..) if possible) is enabled.
</li><li>In version 1.3.x, QUERY_CACHE_SIZE is enabled.
</li><li>In version 1.3.x, SELECT_FOR_UPDATE_MVCC (MVCC and SELECT FOR UPDATE) is enabled.
</li><li>In version 1.3.x, RUNSCRIPT and SCRIPT (commands and tools), use UTF-8 by default (ScriptCommand.charset).
</li><li>In version 1.3.x, Lucene 3 is used by default. Issue 147.
</li><li>When the system property h2.lobInDatabase is set, the lob tables were always
278 279
    created when closing the database, even if the tables were not needed.
</li><li>In the MySQL mode, SHOW TABLES didn't work, and meta data tables were not
Thomas Mueller's avatar
Thomas Mueller committed
280 281
    case insensitive. Updatable result sets didn't work as expected. Issue 249.
</li><li>Connection-created Clob and Blob objects can now be filled using
Thomas Mueller's avatar
Thomas Mueller committed
282 283 284 285 286
    Clob.setCharacterStream(1), Clob.setString(1, s), Blob.setBytes(1, x), Blob.setBinaryStream(1).
    Issue 235.
</li><li>Trying to convert a very small CLOB to a BLOB or a very small CLOB to a BLOB threw a NullPointerException.
</li><li>INFORMATION_SCHEMA.SETTINGS: now the current page count can be queried using
    select * from information_schema.settings where name = 'info.PAGE_COUNT'.
Thomas Mueller's avatar
Thomas Mueller committed
287
</li><li>For an invalid value exception, the parameter name and value was
Thomas Mueller's avatar
Thomas Mueller committed
288
    switched in some cases.
Thomas Mueller's avatar
Thomas Mueller committed
289
</li><li>When using trace level 3, opening a database no longer prints
Thomas Mueller's avatar
Thomas Mueller committed
290
    there is a EOFException (because that is the expected behavior).
Thomas Mueller's avatar
Thomas Mueller committed
291
</li><li>CALL calling a Java function with return type ResultSet and
Thomas Mueller's avatar
Thomas Mueller committed
292
    return value null threw a ClassCastException.
Thomas Mueller's avatar
Thomas Mueller committed
293
</li><li>SELECT ... FROM CSVREAD no longer creates a temporary file.
294
    Some large imports are now twice as fast.
Thomas Mueller's avatar
Thomas Mueller committed
295 296 297
</li></ul>

<h2>Version 1.2.145 (2010-11-02)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
298
<ul><li>A new String cache is now created at most once every 5 second, so that out of memory exceptions
Thomas Mueller's avatar
Thomas Mueller committed
299
    are not artificially delayed.
Thomas Mueller's avatar
Thomas Mueller committed
300 301 302 303
</li><li>After closing a database, the writer thread will stop after 100 ms at the latest (instead of 1 second).
</li><li>Opening a large database could fail in theory if the process was killed and then
    not fully compacted (because the unique transaction log key was re-used).
</li><li>Views now store the schema for Java functions if "functions in schemas" is enabled
304 305
    (system property h2.functionsInSchema).
</li><li>Improved error message if the LOB files are already deleted on the client side.
306
</li><li>Closing a Statement or PreparedStatement at the same time as executing a statement
Thomas Mueller's avatar
Thomas Mueller committed
307 308
    could throw a strange exception. Issue 241.
</li><li>The Recover tool did not work with compressed lob files (set compress_lob lzf).
309
    Also, sometimes the Recover tool was very slow, specially using a 64-bit JVM, because
Thomas Mueller's avatar
Thomas Mueller committed
310
    it tried to de-compress lob files even if they were not compressed
311 312
    (which could allocate a lot of memory).
</li><li>H2 Console: webAllowOthers and webSSL were swapped if they didn't exist in the properties file. Issue 244.
313
</li><li>When the system property h2.lobInDatabase is set, CREATE TABLE ... AS SELECT
Thomas Mueller's avatar
Thomas Mueller committed
314
    with a LOB column did not always work.
Thomas Mueller's avatar
Thomas Mueller committed
315
</li><li>Some system properties are not supported any longer, because they can
316
    already be set in the database URL. The constants are:
Thomas Mueller's avatar
Thomas Mueller committed
317 318 319 320
    CACHE_SIZE_DEFAULT, CACHE_TYPE_DEFAULT, DEFAULT_LOCK_MODE,
    LOCK_MODE_READ_COMMITTED, DEFAULT_MAX_LENGTH_INPLACE_LOB,
    DEFAULT_MAX_LENGTH_INPLACE_LOB2, DEFAULT_MAX_MEMORY_UNDO,
    DEFAULT_MAX_OPERATION_MEMORY, DEFAULT_PAGE_SIZE,
321
    DEFAULT_RESULT_SET_CONCURRENCY, MIN_WRITE_DELAY.
322
</li><li>Various system properties have been replaced with database level settings:
Thomas Mueller's avatar
Thomas Mueller committed
323 324 325 326 327 328 329 330 331 332
    ALIAS_COLUMN_NAME, ANALYZE_AUTO, ANALYZE_SAMPLE, DATABASE_TO_UPPER,
    DEFAULT_ESCAPE, DEFRAG_ALWAYS, DROP_RESTRICT,
    ESTIMATED_FUNCTION_TABLE_ROWS, FUNCTIONS_IN_SCHEMA,
    LARGE_RESULT_BUFFER_SIZE, LARGE_TRANSACTIONS, MAX_COMPACT_COUNT,
    MAX_COMPACT_TIME, MAX_MEMORY_ROWS_DISTINCT, MAX_QUERY_TIMEOUT,
    NESTED_JOINS, OPTIMIZE_DISTINCT, OPTIMIZE_EVALUATABLE_SUBQUERIES,
    OPTIMIZE_INSERT_FROM_SELECT, OPTIMIZE_IN_LIST, OPTIMIZE_IS_NULL,
    OPTIMIZE_OR, OPTIMIZE_SUBQUERY_CACHE, OPTIMIZE_TWO_EQUALS,
    OPTIMIZE_UPDATE, PAGE_STORE_INTERNAL_COUNT, PAGE_STORE_TRIM,
    QUERY_CACHE_SIZE, RECOMPILE_ALWAYS, RECONNECT_CHECK_DELAY,
333
    SELECT_FOR_UPDATE_MVCC, SHARE_LINKED_CONNECTIONS.
334
    See the Javadoc documentation of DbSettings for details.
335 336
    The system properties are still supported for backward compatibility.
</li><li>When the system property h2.nestedJoins was enabled, some outer joins returned the wrong result.
Thomas Mueller's avatar
Thomas Mueller committed
337
</li><li>Opening a database could throw a NullPointerException.
Thomas Mueller's avatar
Thomas Mueller committed
338
</li><li>After a crash, the database file did not always shrink because
339 340
    old transaction log pages were not removed from the file.
</li><li>Various CallableStatement methods could throw a NullPointerException.
341
</li><li>LOB files were not deleted when running DROP ALL OBJECTS.
Thomas Mueller's avatar
Thomas Mueller committed
342
</li><li>MS SQL Server compatibility: support "N" in front of string literals ("National Language" strings). Issue 240.
343
</li><li>CAST: when converting a string to binary, it is hex encoded (every byte two characters);
Thomas Mueller's avatar
Thomas Mueller committed
344 345
    a hex string can be converted to a number by first converting it to binary. Examples:
    CAST(CAST('FFFF' AS BINARY) AS INT) = 65535, CAST(65535 AS BINARY) = '0000FFFF'.
Thomas Mueller's avatar
Thomas Mueller committed
346
</li><li>When a domain (user defined data type) contained a user defined function, the database could not be opened.
Thomas Mueller's avatar
Thomas Mueller committed
347
</li><li>CAST('011' AS INT) will no longer use decode the value as an octal number (using Integer.decode) but now use Integer.parseInt.
Thomas Mueller's avatar
Thomas Mueller committed
348
    The same logic applied to byte, short, and long. This also means that trying to convert hex numbers (0x...) with CAST now fails.
349
</li><li>A table in the Recover tool script could not be imported if the script contained duplicate keys.
Thomas Mueller's avatar
Thomas Mueller committed
350 351
</li></ul>

Thomas Mueller's avatar
Thomas Mueller committed
352
<h2>Version 1.2.144 (2010-10-15)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
353 354 355
<ul><li>The Windows .bat files did not contain CR+LF.
</li><li>The LOB storage (when the system property h2.lobInDatabase is set) is now only initialized when needed.
</li><li>The index condition columnName IS NULL was not efficient when using a clustered index.
Thomas Mueller's avatar
Thomas Mueller committed
356 357 358
</li><li>The Recover tool did not work for databases larger than 2 GB.
</li><li>In memory database: outer joins with a condition "column is null" could return the wrong result.
</li><li>Temporary files were not created in the temporary directory of the system, but in the current working directory.
Thomas Mueller's avatar
Thomas Mueller committed
359 360 361 362
    This affected temporary undo log files for read-only databases, temporary files for large result sets when using read-only databases,
    and temporary LOB files when storing LOBs in the database (system property h2.lobInDatabase).
    When the setting h2.lobInDatabase is not set,
    temporary LOB files are still stored in a sub-directory (.lobs.db/) of the current working directory.
Thomas Mueller's avatar
Thomas Mueller committed
363
</li><li>New experimental feature to speed up CREATE TABLE ... AS SELECT.
Thomas Mueller's avatar
Thomas Mueller committed
364 365 366
    To enable the feature, set the system property h2.optimizeInsertFromSelect to true.
    For large queries, performance can be doubled.
</li><li>When LOB objects are stored in the database (using the experimental setting h2.lobInDatabase),
367 368
    and using the MVCC mode, opening a database with uncommitted transactions could throw a NullPointerException.
</li><li>Support of stored procedures with OUT parameters in CallableStatement is implemented.
Thomas Mueller's avatar
Thomas Mueller committed
369
</li><li>PreparedStatement.getMetaData() was not always consistent with resulting ResultSet.getMetaData().
370
</li><li>The build tool now uses JAVA_HOME for javac as well. Issue 233.
Thomas Mueller's avatar
Thomas Mueller committed
371
</li><li>Opening and closing encrypted databases is now much faster.
Thomas Mueller's avatar
Thomas Mueller committed
372 373 374 375 376 377 378
</li><li>H2 Console: new experimental feature to support file download and upload,
    but only if there is a directory called "transfer" in the current working directory.
    For security reasons, only very simple file names are supported. Sub-directories are not supported.
    To upload, use transfer.jsp; to download, use transfer/fileName.
</li><li>A new sample application that shows how to manually create an encrypted
    and compressed script file.
</li><li>Performance has been improved a bit.
Thomas Mueller's avatar
Thomas Mueller committed
379 380 381 382
</li><li>DatabaseMetaData.getJDBCMajorVersion now returns 4 (instead of 3) when the driver
    is compiled with Java 6 (the default).
</li><li>Re-added the internal utility class BitField which improves performance of opening
    and closing a database (because it supports setByte / getByte, unlike java.util.BitSet).
Thomas Mueller's avatar
Thomas Mueller committed
383
</li><li>INFORMATION_SCHEMA.SESSIONS: the start time of a SQL statement
Thomas Mueller's avatar
Thomas Mueller committed
384 385 386 387 388 389 390 391 392 393 394
    is no longer set in each case. It is only set for long running statements.
    This change should improve performance a bit on some devices, specially when using Android.
</li><li>A old databases without user name and password (created with H2 version 1.2.142 or older)
    couldn't be opened with version 1.2.143. Fixed.
</li><li>The database upgrade classes have been renamed.
</li><li>The database did not automatically upgrade when using a connection pool or data source.
</li><li>JaQu: a database object can now also be created using a DataSource. Issue 227.
</li><li>The built-in profiler now better supports the Dalvik VM.
</li><li>The jarSmall build target no longer includes assertions
    (SysProperties.CHECK, CHECK2, system properties h2.check and h2.check2).
</li><li>The jarSmall build target excluded the DbUpgrade classes by mistake.
Thomas Mueller's avatar
Thomas Mueller committed
395 396 397
</li></ul>

<h2>Version 1.2.143 (2010-09-18)</h2>
398 399 400 401
<ul><li>If the user name and password are not set or empty, then the password is not hashed.
    To disable this behavior, set the system property h2.emptyPassword to false.
    TCP server: the default user name for the management database is now an empty string.
</li><li>Cluster: auto-commit was disabled after opening a connection.
Thomas Mueller's avatar
Thomas Mueller committed
402 403 404 405
</li><li>Connection.getAutoCommit() is now much faster, specially when using the server mode.
</li><li>Statement.cancel() had no effect when using the server mode.
</li><li>SCRIPT: the SQL script no longer contains settings that match the default value.
</li><li>Statement.cancel() did not work when running RUNSCRIPT and SCRIPT.
406 407
</li><li>Statement.cancel() could cause a NullPointerException.
</li><li>In some cases (specially when using a small cache size or a large database over 1 GB) for some
Thomas Mueller's avatar
Thomas Mueller committed
408 409 410 411 412
    operations like ALTER TABLE the data was written before the transaction log entries, which could cause a corrupt database
    if the process was killed during the ALTER TABLE operation. Thanks a lot to Victor Pyankov for helping solve this problem!
</li><li>The Recover tool could throw a ArrayIndexOutOfBoundsException
    when trying to recover a corrupt database file.
</li><li>The SCRIPT command and tool now uses the default file encoding
Thomas Mueller's avatar
Thomas Mueller committed
413 414 415 416 417 418 419 420
    for the system now instead of UTF-8 (as before).
    In most cases, this will not affect existing applications, as the encoding
    only affects how SQL identifiers (table names and so on) that contain special characters
    are stored. Table data is escaped, and therefore is no problem.
</li><li>The SCRIPT command and tool now also support the CHARSET option
    (like RUNSCRIPT).
</li><li>When closing a database, sometimes empty space in the database was not freed up.
</li><li>Trying to create a view with parameters in the query will now throw an exception.
421 422
    So far, creating the view was allowed, but the parameter value was not used (null was used instead).
</li><li>New experimental feature SHUTDOWN DEFRAG.
Thomas Mueller's avatar
Thomas Mueller committed
423
    This option re-orders the pages while closing the database so that table scans are faster.
Thomas Mueller's avatar
Thomas Mueller committed
424 425
</li><li>When using the MULTI_THREADED option, concurrently reading from a database
    (specially from a larger database, or when using a small cache size) could throw an exception.
Thomas Mueller's avatar
Thomas Mueller committed
426
</li><li>When adding a comment to a column that has a check constraint,
Thomas Mueller's avatar
Thomas Mueller committed
427
    the database couldn't be re-opened.
Thomas Mueller's avatar
Thomas Mueller committed
428
</li><li>New system property h2.lobClientMaxSizeMemory to set the maximum size
Thomas Mueller's avatar
Thomas Mueller committed
429
    of a LOB object to keep in memory on the client side when using the server mode.
Thomas Mueller's avatar
Thomas Mueller committed
430 431 432
</li></ul>

<h2>Version 1.2.142 (2010-08-31)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
433 434
<ul><li>Documentation for using H2 on Android devices has been added under Tutorial - Android.
</li><li>An ArrayIndexOutOfBoundsException was thrown when querying the table
Thomas Mueller's avatar
Thomas Mueller committed
435 436 437 438
    information_schema.function_aliases while there are any user defined aggregate functions.
</li><li>The jar files are now about 50 KB smaller.
    In the last few versions they contained superfluous classes.
</li><li>The default time to compact a database when closing (system property h2.maxCompactTime)
Thomas Mueller's avatar
Thomas Mueller committed
439 440 441 442
    is now 0.2 seconds instead of 1 second.
</li><li>Opening an closing a database is now faster.
</li><li>In theory, when using indexes with large index rows (or when using a very small page size),
    removing rows could throw an internal exception in some cases.
Thomas Mueller's avatar
Thomas Mueller committed
443
</li><li>Inserting rows in reverse order could throw an ArrayIndexOutOfBoundsException
Thomas Mueller's avatar
Thomas Mueller committed
444 445 446 447 448 449 450
    in some cases (specially rows larger than the page size, which is 2 KB by default). Issue 226.
</li><li>H2 Console: with Chrome and Safari, resizing the table/query frame doesn't work. Issue 225.
</li><li>New experimental database file locking mechanism "FS" to use native file locking
    (no *.lock.db file is created in this case, and no background thread is started). This mechanism
    may not work on all systems (on some systems it's possible to lock the same file multiple
    times within the same virtual machine, and on some system native file locking is not working
    or unlocking is not working).
451 452 453 454
</li></ul>

<h2>Version 1.2.141 (2010-08-22)</h2>
<ul><li>New experimental pseudo-encryption algorithm "FOG".
Thomas Mueller's avatar
Thomas Mueller committed
455
    It makes the data appear to be encrypted. This algorithm is cryptographically extremely weak,
456 457 458 459
    and should only be used to hide data from reading the plain text using a text editor.
    Please let us know if you think this is useful or not.
</li><li>Documentation: the grammar and function documentation can now be easier translated.
</li><li>Password hash: in addition to connecting with the plain text password,
Thomas Mueller's avatar
Thomas Mueller committed
460 461 462 463 464 465 466 467 468 469 470 471
    H2 now supports connecting with the password hash.
    Like this you don't have to store plain text passwords in config files.
    For details, see the documentation at Advanced / Password Hash.
</li><li>Lucene 3.x support was added in the source code, however it is not yet enabled by default
    and is not yet supported when using the default h2 jar file. To enable Lucene 3.x support,
    the source code of H2 needs to be switched using <code>./build.sh -Dlucene=3 switchSource</code>,
    and then re-compile. To switch the source code back use <code>./build.sh -Dlucene=2 switchSource</code> (replace
    ./build.sh with build.bat on Windows).
    The plan is to use Lucene 3 by default in H2 version 1.3.x.
    Issue 147.
</li><li>The native fulltext search could cause a Java level deadlock if searching from multiple connections concurrently.
</li><li>CREATE FORCE VIEW didn't work in most cases if a referenced table didn't exist.
472 473 474 475 476 477 478 479 480 481
</li><li>MVCC: when trying to insert two rows with the same key from two connections,
    the second connection immediately threw the exception "Unique index or primary key violation".
    Instead, the second connection now waits throwing the exception until the first connection
    committed the change (same as when trying to concurrently update the same row).
</li><li>Server mode: if the client ran with a different timezone setting than the server, date values
    got shifted by the difference between the timezones. This problem affected the data types
    DATE, TIME, and TIMESTAMP, when using PreparedStatement.setDate / setTime / setTimestamp
    and ResultSet.getDate / getTime / getTimestamp.
    To solve the problem, both the client and the server need to be updated (otherwise the old transfer protocol is used).
</li><li>The built-in connection pool (JdbcConnectionPool) did not always honor the login timeout
482 483
    (the timeout could occur much too early). Thanks a lot to Dario Fassi for the patch!
</li><li>Translation: the new messages have been translated to Spanish. Thanks a lot to Dario Fassi!
Thomas Mueller's avatar
Thomas Mueller committed
484
</li><li>The table INFORMATION_SCHEMA.SETTINGS now contains all H2-specific system properties
Thomas Mueller's avatar
Thomas Mueller committed
485 486 487
    (the ones that start with "h2.") and that are explicitly set. Previously, some H2-specific settings
    (for example h2.analyzeAuto) were missing in this list.
</li><li>EXPLAIN ANALYZE with an in-memory database threw an exception. Issue 216.
Thomas Mueller's avatar
Thomas Mueller committed
488
</li><li>Data modifications (inserts, updates, and deletes) are now up to 5 times faster
489 490 491 492
    because converting objects to byte arrays is avoided if possible.
</li><li>LOG=0 is now a bit faster (previously undo log entries were still written).
</li><li>The command line tools now say so if the source directory of an option doesn't exist.
</li><li>It is now allowed to truncate a table if referential integrity has been disabled for this table or database.
493
</li><li>For unencrypted databases, the automatic upgrade temporary script file is now unencrypted again.
Thomas Mueller's avatar
Thomas Mueller committed
494 495 496
</li></ul>

<h2>Version 1.2.140 (2010-07-25)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
497 498 499 500 501 502 503 504
<ul><li>The default MAX_LOG_SIZE is now 16 MB instead of 2 MB. Some uses cases are 3 times faster now.
</li><li>Improved cache memory usage calculation.
</li><li>Only resources that are actually used are loaded in memory.
    This can reduce the memory usage by about 400 KB.
</li><li>Profiling: the jar file can now be installed as an agent using
    java -javaagent:h2*.jar - this was be used to more accurately calculate the memory footprint of the cache.
    It has no effect when using H2 (using this feature in an application is not needed and not recommended).
</li><li>The cache was not used efficiently when reading
505 506
    (behaving like a FIFO cache instead of an LRU cache).
</li><li>Storing lobs in the database has been changed. It is now faster.
Thomas Mueller's avatar
Thomas Mueller committed
507 508
    Unfortunately, the change is not backward compatible; if you have used h2.lobInDatabase before
    you will need to re-build the database.
Thomas Mueller's avatar
Thomas Mueller committed
509
</li><li>SHUTDOWN COMPACT is now faster.
510 511 512
</li><li>H2 Console: requesting the status did not always show the window on top of others.
</li><li>H2 Console: on some system, the browser windows got opened when requesting a new one.
</li><li>The built-in profiling tool now uses a default stack depth of 32 elements and a default interval of 10 ms.
Thomas Mueller's avatar
Thomas Mueller committed
513
</li><li>Database files now grows in 1 MB blocks (and at least 20% at a time),
514
    instead of always 256 KB. This speeds up loading a new database.
515 516
</li><li>H2 Console: new built-in command @sleep to help profile another session.
</li><li>For improved performance, LOG=0 and LOG=1 are again supported.
517 518 519
    LOG=0 means the transaction log is disabled completely (fastest; for loading a database).
    LOG=1 means the transaction log is enabled, but FileDescriptor.sync is disabled (if no protection against power failure is required).
    LOG=2 is the default (transaction log is enabled, FileDescriptor.sync for each checkpoint).
Thomas Mueller's avatar
Thomas Mueller committed
520
</li><li>After deleting a lot of data (for example by dropping or altering tables, or indexes,
521 522 523 524
    or after a large transaction), opening a large database was very slow. Fixed.
</li><li>When killing the process after creating and dropping many tables (specially temporary tables),
    the database could not be opened sometimes.
</li><li>CAST(NULL AS ...) doesn't forget the data type, precision, and scale any longer.
Thomas Mueller's avatar
Thomas Mueller committed
525 526 527
</li><li>Experimental support for recursive queries (see 'Advanced' - 'Recursive Queries' for details).
</li><li>Problems with JDK 1.6.0_18 have been reports in the class StringUtils.quoteRemarkSQL. This method is now changed.
</li><li>The "small jar" distribution did not include the CompressTool,
528 529
    which was required for some operations. Fixed.
</li><li>The build tool now supports (minimalistic) shell mode, started using ./build.sh -
Thomas Mueller's avatar
Thomas Mueller committed
530 531 532 533 534
</li><li>IS NULL comparison with nested queries and linked tables did not work.
    Example: select * from (select x from test) where x is null.
</li><li>Support for null-safe equals. This includes the ANSI SQL standard syntax
    A IS [NOT] DISTINCT FROM B as well as the shorter A IS [NOT] B.
</li><li>Primary key violations threw a strange exception message when using a single column INT or BIGINT key.
535 536
</li><li>EXPLAIN ANALYZE now also lists the number of pages read from the file.
</li><li>Memory mapped files: There was a bug in version 1.2.139 so that memory mapped files
Thomas Mueller's avatar
Thomas Mueller committed
537 538
    could only be used together with split, for example: split:nioMapped: - the problem is now solved.
    It is still a good idea to use split:nioMapped: to work around the 2 GB limitation of memory mapped files.
Thomas Mueller's avatar
Thomas Mueller committed
539
</li><li>Memory mapped files: the system property h2.nioCleanerHack is now disabled by default
Thomas Mueller's avatar
Thomas Mueller committed
540 541 542
    because it was not always working as expected. Now System.gc() is used in a loop until the
    buffer is garbage collected. This of course is also not a nice solution, but the only one known to work.
    See also http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4724038
543
</li><li>Bugfixes for the automatic 1.1 db migration.
544
</li><li>If an old 1.1 database file version is found on connect, it is now possible to let the old h2
Thomas Mueller's avatar
Thomas Mueller committed
545 546 547
    classes (v 1.2.128) connect to the database. The automatic upgrade .jar file must be present, and the url
    must contain NO_UPGRADE=TRUE
</li><li>The automatic upgrade temporary script file is now encrypted.
Thomas Mueller's avatar
Thomas Mueller committed
548 549 550
</li></ul>

<h2>Version 1.2.139 (2010-07-10)</h2>
christian.peter.io's avatar
christian.peter.io committed
551
<ul><li>There was a bug in the internal IntIntHashMap. There were no known side effects however.
Thomas Mueller's avatar
Thomas Mueller committed
552 553
</li><li>ANALYZE now uses less memory.
</li><li>Memory mapped file system: improved error messages if there is a problem.
Thomas Mueller's avatar
Thomas Mueller committed
554 555
</li><li>The Lucene fulltext search did not work well
    when using special file systems such as split or nioMapped.
Thomas Mueller's avatar
Thomas Mueller committed
556
</li><li>The memory mapped file system (nioMapped: file prefix) couldn't seek past the file length.
Thomas Mueller's avatar
Thomas Mueller committed
557
</li><li>Some file system operations did not work with stacked file systems
Thomas Mueller's avatar
Thomas Mueller committed
558
    (for example split and nioMapped). This also affected the DeleteDbFiles tool.
Thomas Mueller's avatar
Thomas Mueller committed
559
</li><li>New experimental query cache.
Thomas Mueller's avatar
Thomas Mueller committed
560
    The cache is only used if the SQL statement and all parameters match.
561
    Each session has it's own cache with the given size.
Thomas Mueller's avatar
Thomas Mueller committed
562
    Only the last returned result per query is cached.
563 564 565 566 567
    Only SELECT statements are cached (excluding UNION and FOR UPDATE statements).
    This works for both statements and prepared statement.
    To enable, set the system property h2.commandCacheSize to a value larger than 0.
    There is currently no plan to enable this option by default in future versions.
</li><li>Conditions with many OR operations could throw an UnsupportedOperationException if
Thomas Mueller's avatar
Thomas Mueller committed
568
    h2.optimizeOr was enabled.
Thomas Mueller's avatar
Thomas Mueller committed
569
</li><li>XA connection: after transaction commit or rollback,
Thomas Mueller's avatar
Thomas Mueller committed
570 571
    the physical connection is set into autocommit mode.
</li><li>MULTI_THREADED did not work correctly and could throw the exception
Thomas Mueller's avatar
Thomas Mueller committed
572 573
    "try to add a record twice" for larger databases because cache access was not correctly synchronized.
</li><li>Automatic database upgrade from non page store is now possible. If the
Thomas Mueller's avatar
Thomas Mueller committed
574
    classes from the h2mig_pagestore_addon.jar file are in the classpath, the database will be converted to the current
575
    page store format automatically. The file can be found here:
576 577
    <a href="http://h2database.com/h2mig_pagestore_addon.jar">http://h2database.com/h2mig_pagestore_addon.jar</a>
</li><li>The MultiDimension tools was extended with a few helper methods.
578
    The API was unified a bit.
Thomas Mueller's avatar
Thomas Mueller committed
579 580
</li><li>ODBC: MS Access could not link to a table with unique index or primary key.
    To solve this problem, index meta data is currently disabled for ODBC.
581 582 583
    When using the new H2 version to access a database over ODBC, the PostgreSQL catalog
    is automatically upgraded. Using a database with an upgraded PostgreSQL catalog
    with an older version of H2 is still possible, but not over ODBC.
Thomas Mueller's avatar
Thomas Mueller committed
584 585
</li><li>ODBC: MS Access could not link to a table with a name containing '_'.
</li><li>ODBC: additional connection settings can now be added to the database name.
586 587
    Example: ~/test;cipher=xtea. Therefore, encrypted databases are supported.
</li><li>Local temporary tables can now be created without having to commit a transaction
588
    using CREATE LOCAL TEMPORARY TABLE TEMP(ID INT PRIMARY KEY) TRANSACTIONAL.
Thomas Mueller's avatar
Thomas Mueller committed
589 590 591 592 593
</li><li>New system property h2.dropRestrict (default false) to change the
    default action for DROP TABLE and DROP VIEW (false for CASCADE, true for RESTRICT).
    The plan is to enable this property by default in version 1.3.x.
</li><li>DROP TABLE now also supports CASCADE (still the default) and RESTRICT.
</li><li>The wrong exception was thrown when trying to connect to a server if the server was not running.
Thomas Mueller's avatar
Thomas Mueller committed
594 595 596
</li><li>UNION queries where the first query contains a nested query were parsed incorrectly.
    Example: "select 1 from (select 2 from dual) union select 3 from dual" was parsed as
    "select 1 from ((select 2 from dual) union select 3 from dual)". Fixed.
Thomas Mueller's avatar
Thomas Mueller committed
597
</li><li>Support ALTER SCHEMA name RENAME TO newName (rename schema). (patch from Kerry Sainsbury)
Thomas Mueller's avatar
Thomas Mueller committed
598 599 600
</li></ul>

<h2>Version 1.2.138 (2010-06-27)</h2>
601 602 603
<ul><li>Referential integrity: it was not allowed to delete a row with NULL in the parent table,
    if there was a row with NULL in the child table.
</li><li>Experimental feature to support case sensitive catalog names
604 605 606 607 608
    and database names using the DATABASE() method.
    To use this feature, set the system property h2.databaseToUpper to false.
    The plan is to set the property to false by default in version 1.3.x.
    Issue 204 - thanks to Sylvain Cuaz (ILM Informatique) for the patch.
</li><li>Experimental feature to support nested joins.
Thomas Mueller's avatar
Thomas Mueller committed
609 610 611 612 613 614 615 616
    To enable, set the system property h2.nestedJoins to true.
    If enabled, nested joins and right outer joins should work as expected (issues 145, 177, and 203).
    The plan is to enable this feature by default in version 1.3.x.
</li><li>New sample application: CachedPreparedStatements.
</li><li>When creating functions within a schema, those functions could not be used
    in views, nested queries, and constraints. Fixed.
</li><li>The benchmarks have been run using recent database versions.
</li><li>Version 1.2.137 could still not be converted to Java 1.4
Thomas Mueller's avatar
Thomas Mueller committed
617 618
    (because the Retrotranslator doesn't support BigDecimal.precision).
</li><li>Cluster: non-admin users could not connect when one of the cluster node was stopped. Issue 206.
619 620
</li><li>DROP VIEW now supports the CASCADE and RESTRICT clauses (patch from Kerry Sainsbury)
</li><li>CREATE VIEW now supports the OR REPLACE clause (patch from Kerry Sainsbury)
621
</li><li>Build tool: ability to only run one test using the -Dtest=className setting.
Thomas Mueller's avatar
Thomas Mueller committed
622
    eg: build -Dtest=org.h2.test.db.TestViewDropView test (patch from Kerry Sainsbury).
623 624 625
</li></ul>

<h2>Version 1.2.137 (2010-06-06)</h2>
626 627
<ul><li>Statements with a nested query and a condition that was always NULL threw an
    IndexOutOfBoundsException. Example: select * from (select null as x) where x=1
Thomas Mueller's avatar
Thomas Mueller committed
628 629
</li><li>The changes that were made to support large transactions also fixed a bug
    with large transactions (when the undo log file size is larger than 2 GB).
630
</li><li>Experimental feature to support very large transactions (except when using MVCC).
631 632 633
    To enable, set the system property h2.largeTransactions to true.
    If enabled, changes to tables without a primary key can be buffered to disk.
    The plan is to enable this feature by default in version 1.3.x.
634 635
</li><li>H2 Console: editing result sets is now also working for database other than H2,
    if they do support updatable result sets. Add "@edit" before the query.
636 637 638
    Only limited testing has been done on this feature,
    some data types may not work (please provide feedback if you find issues).
</li><li>Cluster: an open transaction was committed when a cluster node was stopped
Thomas Mueller's avatar
Thomas Mueller committed
639 640 641 642 643 644 645 646 647 648 649 650 651 652
    (because disabling the cluster executes SET CLUSTER '', which committed the transaction).
    Transaction are no longer committed when calling SET CLUSTER. Issue 199.
</li><li>Cluster: non-admin users couldn't connect to the cluster and couldn't disable the cluster. Issue 201.
</li><li>Cluster: NEXTVAL('sequence') was only called on one cluster node,
    therefore sequence values could get out of sync.
</li><li>Version 1.2.136 could not be converted to Java 1.4
    (because the Retrotranslator doesn't support BigDecimal.precision).
    A workaround has been implemented.
</li><li>The error code of IO exceptions in CSV functions was incorrect.
</li><li>The TriggerPassData example now uses a prefix (the database name).
</li><li>The wrong exception was thrown when trying to reference a table that doesn't support references
    such as a table in the information schema.
</li><li>Server.shutdownTcpServer can now stop all TCP servers on this JVM.
</li><li>JdbcConnectionPool: the default connection timeout is now 30 seconds (it used to be 5 minutes).
653 654
</li><li>LOB storage: LOBs added with "h2.lobInDatabase" enabled couldn't
    be read later with this option disabled.
Thomas Mueller's avatar
Thomas Mueller committed
655 656
</li></ul>

Thomas Mueller's avatar
Thomas Mueller committed
657
<h2>Version 1.2.136 (2010-05-24)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
658 659 660
<ul><li>When using ORDER BY and there are both ascending and descending indexes, the database used
    the first index even when the second one could be used for sorting.
</li><li>Conditions of the form columnName IS NULL now use an index. To disable this feature,
661 662 663 664 665 666 667
    set the system property h2.optimizeIsNull to false.
</li><li>H2 Console: when the settings were not stored yet (for example when running for the first time),
    the last recently used settings were not stored. A workaround was to create the file
    ".h2.server.properties" manually in the current user home directory, with the contents:
    webAllowOthers=false, webPort=8082, webSSL=false,
    0=Generic H2 (Embedded)|org.h2.Driver|jdbc\:h2\:~/test|sa
    (where a comma is a newline).
Thomas Mueller's avatar
Thomas Mueller committed
668
</li><li>The source code is now switched to Java 6 (JDK 1.6) by default.
669
    Java 5 (JDK 1.5) is still supported, and the jar file is still compiled for Java 5.
Thomas Mueller's avatar
Thomas Mueller committed
670
</li><li>The BOM (the byte-order-mark) character 0xfeff at the beginning of the file is ignored.
671 672
    This is for compatibility with Microsoft Excel.
</li><li>When opening an existing database, the cache size is set to at most
Thomas Mueller's avatar
Thomas Mueller committed
673
    half the amount of memory available for the virtual machine
674
    (Runtime.getRuntime().maxMemory()), even if the cache size setting stored in the database
Thomas Mueller's avatar
Thomas Mueller committed
675
    is larger. Setting the cache size in the database URL or explicitly using SET CACHE_SIZE
676 677 678
    overrides this value (even if larger than the physical memory).
</li><li>INFORMATION_SCHEMA.SETTINGS: the cache size is now returned in KB.
</li><li>New system property h2.selectForUpdateMvcc, the default is false (the feature is disabled).
679
    When enabled, SELECT ... FOR UPDATE only locks the selected rows in the MVCC mode.
680
    Aggregate or GROUP BY queries are not allowed in this case.
681
</li><li>Profiler: improved message if there was no stack trace.
Thomas Mueller's avatar
Thomas Mueller committed
682
</li><li>The H2 Console can now be used within another application, in a frame or iframe. Issue 197.
Thomas Mueller's avatar
Thomas Mueller committed
683 684 685 686 687 688 689
</li><li>Recover tool: the statistics section now includes page type counts again.
</li><li>Queries with multiple IN(...) conditions sometimes return the wrong results when there was a multi-column index for the column.
</li><li>Queries with IN(..., NULL) did sometimes return the wrong results when there was a index for the column.
</li><li>DECIMAL: faster precision and memory usage calculations.
</li><li>A new class org.h2.tools.TriggerAdapter allows to use the ResultSet interface within trigger implementations.
</li><li>A subselect which used an index could lead to wrong results. Fixed.
</li><li>Creating a cached temporary non persistent table with a primary key threw a NullPointerException.
Thomas Mueller's avatar
Thomas Mueller committed
690 691 692
</li></ul>

<h2>Version 1.2.135 (2010-05-08)</h2>
693
<ul><li>Temporary files were not deleted when using large transactions, disabling autocommit,
Thomas Mueller's avatar
Thomas Mueller committed
694 695
    and closing the session without committing.
</li><li>Queries using multiple IN(..) conditions on the same table could cause repeated rows in the result set.
696
</li><li>Translation: Lubomir Grajciar translated the H2 Console as well as all error message to Slovensky. Thanks a lot!
697 698
</li><li>There was a possible Java level deadlock when opening an uninitialized database and using
    a file system that also opened a database.
699
</li><li>When killing the process while the database was writing a checkpoint, while it was closing,
Thomas Mueller's avatar
Thomas Mueller committed
700
    or while running recovery (while removing temporary tables from a previous run), the database could become corrupt.
701
    A new test case has been implemented to ensure such problems can not occur in the future.
702 703 704 705
</li><li>File system: new method FileSystem.setReadOnly.
</li><li>The page size for new databases can now be set in the database URL using ;PAGE_SIZE=512.
    Currently this feature is only used to simplify testing.
</li><li>New system property h2.functionsInSchema (default is false).
706 707 708 709 710 711 712 713
    If enabled, the SCRIPT statement always includes the schema name in the CREATE ALIAS statement
    (even if the schema is PUBLIC). This is not backward compatible with H2 versions 1.2.134 and older.
</li><li>Functions: it is no longer required to add a space after a comma in the parameter list.
    Example: CREATE ALIAS PARSE_INT FOR "java.lang.Integer.parseInt(java.lang.String,int)"
</li><li>Functions now reside within a schema, similar to sequences.
    If you do create such functions in schemas other than PUBLIC, then the database
    can not be opened with older versions of H2.
</li><li>Cluster: after a cluster node failed, the second cluster node can now be re-created
Thomas Mueller's avatar
Thomas Mueller committed
714 715
    and started without having to stop the first cluster node, and without having to stop
    running applications. To do that, append ;AUTO_RECONNECT=TRUE to the database URL.
716
</li><li>Auto-reconnect: if another connection uses the database in exclusive mode
717 718
    then this connection will try to re-connect until the exclusive mode ends.
    This is important when using the cluster mode.
Thomas Mueller's avatar
Thomas Mueller committed
719 720 721 722 723 724
</li><li>SET EXCLUSIVE now supports 0 (disable), 1 (enable), and 2 (enable and close all other connections).
</li><li>Installing the H2 as a service should now work on Windows 7.
    The batch files now explicitly set the directory using pushd "%~dp0".
</li><li>Temporary tables can now be 'cached', that means indexes of temporary tables
    can be persisted. This enables very large temporary tables (both local and global).
</li><li>The CreateCluster tool now sets the source database in exclusive mode
Thomas Mueller's avatar
Thomas Mueller committed
725
    before copying data to the new database.
Thomas Mueller's avatar
Thomas Mueller committed
726 727 728
</li><li>The H2 Console now stream results one statement / result set at a time (using chunked transfer encoding).
    To disable, set the system property h2.consoleStream to false.
    This feature is not supported when using a servlet container.
Thomas Mueller's avatar
Thomas Mueller committed
729 730 731
</li><li>The H2 Console did not call the CreateCluster tool with the correctly escaped parameters.
</li><li>Improved PostgreSQL compatibility for ALTER TABLE ALTER COLUMN.
</li><li>Commas at the end of INSERT ... VALUES (), (), are now supported.
Thomas Mueller's avatar
Thomas Mueller committed
732 733 734 735 736 737 738 739 740 741 742
</li><li>The H2 Console "Start Browser" button now works even when the IP
    address changes while the tool runs (for example, because a wireless connection
    breaks, or when enabling / disabling the network connection).
</li><li>When casting from float or double to BigDecimal, the result was
    sometimes unexpected, because "new BigDecimal(double val)" was used.
    Now "BigDecimal.valueOf(double val)" and "new BigDecimal(Float.toString(f))" are used.
    But it is still not recommended to use float or double for currency values
    (see data type documentation).
</li><li>Global temporary tables are now deleted when closing the database.
    Before, they were deleted when opening the database the next time.
</li><li>UNIQUE was not listed as a keyword.
Thomas Mueller's avatar
Thomas Mueller committed
743 744 745 746 747 748 749 750 751
</li><li>Improved error message when an non-SQL-exception occurred in a user
    defined function. The method name and parameters are included in the error message.
</li><li>For some queries, the exception did not include the SQL statement. Example:
    select x from system_range(1, 2) group by 'a'.
</li><li>The Shell tool will execute SQL statements passed as using the command line
    parameter -sql.
</li><li>If InetAddress.getLocalHost() fails, the database should now throw an exception.
</li><li>New columns INFORMATION_SCHEMA.INDEXES.INDEX_CLASS and
    INFORMATION_SCHEMA.TABLES.TABLE_CLASS.
Thomas Mueller's avatar
Thomas Mueller committed
752
</li><li>INFORMATION_SCHEMA.INDEXES.SQL now contains the CREATE INDEX statement
Thomas Mueller's avatar
Thomas Mueller committed
753
    instead of just the fully qualified index name.
Thomas Mueller's avatar
Thomas Mueller committed
754 755 756
</li></ul>

<h2>Version 1.2.134 (2010-04-23)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
757 758 759 760 761 762 763 764 765 766
<ul><li>New system property h2.analyzeAuto (default 0 meaning disabled) to
    automatically run ANALYZE after that many changes to a table.
    For details, see the Javadoc of this system property.
    The plan is to set this property to 2000 in version 1.3.x.
</li><li>JdbcXAConnection.start() does not support TMJOIN. Issue 189.
</li><li>MySQL compatibility: TIMESTAMPDIFF is now an alias for DATEDIFF.
</li><li>MERGE did not respect foreign key and check constraints.
</li><li>ALTER TABLE ALTER COLUMN: changing the data type of a column
    no longer makes it nullable.
</li><li>When using AUTO_SERVER=TRUE, the server is now started as a daemon thread.
767 768 769 770
    This was a problem when using Tomcat and a connection pool.
</li><li>Servers can now be started as a daemon thread using the command line options
    -tcpDaemon, -pgDaemon, and -webDaemon.
</li><li>H2 Console: the built-in commands are now documented.
771 772
</li><li>REPLACE: if any parameter is null, the result is null.
</li><li>Queries with DISTINCT and ORDER BY will now use the index on ORDER BY if possible.
773
    This is specially important for queries used inside IN(SELECT ...).
Thomas Mueller's avatar
Thomas Mueller committed
774
</li><li>The new statement EXPLAIN ANALYZE executes the statement,
775 776
    and displays the query plan with the actual row scan count for each table.
</li><li>H2 Console: the auto-complete feature didn't quote column names
777 778
    that need quoting. Issue 186.
</li><li>The experimental LOB storage mechanism now supports all features of the
Thomas Mueller's avatar
Thomas Mueller committed
779
    old one. To use it, set the system property "h2.lobInDatabase" to "true".
Thomas Mueller's avatar
Thomas Mueller committed
780
    If you have used this feature in version 1.2.133, you need to export
Thomas Mueller's avatar
Thomas Mueller committed
781
    and re-import the database using SCRIPT / RUNSCRIPT.
782 783
</li><li>The functions isBeforeFirst() and isAfterLast() were not compliant to the
    JDBC spec. If the ResultSet contains no rows, they must return false. Fixed.
784
</li><li>Filesystem parameters like "split:" didn't work in server mode with baseDir set.
785 786
</li><li>If baseDir is set, and a database name is given which points to a directory outside
    the baseDir (eg. "../dbname"), an exception is thrown.
Thomas Mueller's avatar
Thomas Mueller committed
787 788 789
</li></ul>

<h2>Version 1.2.133 (2010-04-10)</h2>
790 791 792 793 794 795
<ul><li>A new experimental LOB storage mechanism is available.
    When enabled, CLOB and BLOB data is stored in hidden tables in the database.
    To use it, set the system property "h2.lobInDatabase" to "true".
    Compression is not yet implemented. Duplicate objects are only stored once.
    Usually writing is slower, but reading is faster (mainly because of caching).
</li><li>The Shell tool threw a NumberFormatException on a empty statement.
796
</li><li>The h2small-*.jar did not support "drop all objects delete files".
797
    Now it is supported (the DeleteDbFiles tool is now included).
798
</li><li>Operations that don't fit in memory are now faster.
Thomas Mueller's avatar
Thomas Mueller committed
799 800
    Temporary file handling was changed.
</li><li>The default maximum log stream size is now 2 MB. This is a good value
Thomas Mueller's avatar
Thomas Mueller committed
801
    according to some performance tests.
802
</li><li>New system property "h2.syncMethod" to configure what method to call when
Thomas Mueller's avatar
Thomas Mueller committed
803 804 805
    closing the database, on checkpoint, and on CHECKPOINT SYNC. The default is "sync" which
    calls RandomAccessFile.getFD().sync().
</li><li>ROWNUM could not be used for pagination. The follow query returned no rows:
Thomas Mueller's avatar
Thomas Mueller committed
806 807 808 809
    select x from (select *, rownum as r from system_range(1, 3)) where r=2;
</li><li>Workaround for a java.sql.Date issue: years above 9999 are not formatted correctly.
    When calling ResultSet.getString() on a date value, an alternative formatting algorithm is used.
</li><li>Prepared statements with nested subqueries did not always return the correct result. Example:
810 811
    select ?, ?, (select count(*) from test t, (select id from test where 0=?) t2 where t2.id=t.id) from test
</li><li>When using MULTI_THREADED=TRUE, the exception following exception could be thrown:
Thomas Mueller's avatar
Thomas Mueller committed
812 813 814
    "object already exists: TABLES"
</li><li>Comparison of integer columns against float numbers was not always correct. Issue 182.
</li><li>H2 Console: Editing the result of a multi-line queries failed. Issue 183.
Thomas Mueller's avatar
Thomas Mueller committed
815
</li><li>H2 Console: if the settings file (.h2.properties) can't be accessed, the exception is now ignored.
Thomas Mueller's avatar
Thomas Mueller committed
816 817 818
</li></ul>

<h2>Version 1.2.132 (2010-03-21)</h2>
819
<ul><li>The implementation of a Java to C (source code level) converter has been started.
Thomas Mueller's avatar
Thomas Mueller committed
820
    The plan is: it should be possible to convert H2 (or a part of it) to C so that the database
821 822
    can be run without a JVM. This will be a long term project (it may take a year or so).
</li><li>User defined table implementation can now be used using CREATE TABLE ... ENGINE.
823 824
    Thanks to Sergi Vladykin for implementing this feature!
</li><li>Improved MS SQL Server compatibility: support string concatenation using "+".
825 826
    Thanks to Stepan for the patch!
</li><li>When using the multi-threaded mode, running ANALYZE concurrently in multiple
827 828
    connections could throw an exception.
</li><li>The MERGE statement is now about 30% faster when using a PreparedStatement.
829
</li><li>Multi-column indexes where the second or later column was descending did not always
830 831
    produce correct results (rows were missing in the result set, or the result set was empty).
</li><li>When using large transactions or a small log size, the database could get very slow
Thomas Mueller's avatar
Thomas Mueller committed
832 833 834
    (profiling shows the hotspot is in FileObjectDisk.sync()).
</li><li>The Shell tool now prints the stack trace when the list mode is enabled.
</li><li>CREATE ALIAS ... AS: Compilation was incorrect if the source code contained
835 836
    characters that are not supported by the default file encoding.
</li><li>Issue 176: the JdbcDataSource now also supports a 'description' property.
Thomas Mueller's avatar
Thomas Mueller committed
837
</li><li>The Shell tool threw a ArrayIndexOutOfBoundsException after 20 statements.
838
</li><li>When using the small version of H2 ('jarClient'), the first call to
839 840 841 842
    Connection.createBlob (or similar) could throw a ClassNotFoundException
    because the file org.h2.store.fs.FileSystemZip is not included. This missing class
    is now ignored.
</li><li>Literals of type BIGINT now have the correct data type.
Thomas Mueller's avatar
Thomas Mueller committed
843 844 845
</li></ul>

<h2>Version 1.2.131 (2010-03-05)</h2>
Thomas Mueller's avatar
Thomas Mueller committed
846 847 848
<ul><li>Older versions of H2 (version 1.2.127 and older) could not connect to a new version (version 1.2.129 and newer).
    The connection blocked when trying to connect. Now the connection no longer blocks, instead a SQL exception is thrown.
</li><li>In versions 1.2.129 and 1.2.130, a database could not be opened sometimes
849
    after dropping tables or indexes, and then creating new indexes for existing tables.
Thomas Mueller's avatar
Thomas Mueller committed
850
    The exception contained the text "parent not found" (version 1.2.129) or
Thomas Mueller's avatar
Thomas Mueller committed
851
    "Table not found" (version 1.2.130).
852
</li><li>After the database was closed, a null pointer exception could occur in Database.flush.
Thomas Mueller's avatar
Thomas Mueller committed
853
</li><li>An ArrayIndexOutOfBoundsException could occur in the page store (eg. on "delete from table"). Fixed.
Thomas Mueller's avatar
Thomas Mueller committed
854 855
</li></ul>

856 857
<!-- [close] { --></div></td></tr></table><!-- } --><!-- analytics --></body></html>