Skip to content

H
h2database
提交 adf661ad authored 作者: Thomas Mueller's avatar Thomas Mueller
浏览文件
操作

--no commit message 

--no commit message
上级 6a53cfa5
隐藏空白字符变更
内嵌 并排
正在显示 包含 1850 行增加 和 1607 行删除
h2/src/docsrc/html/advanced.html
浏览文件 @ adf661ad
......@@ -486,6 +486,9 @@ You will be able to change the connection properties:
<tr><td>Password</td><td>sa</td><td>The database password.</td></tr>
</table>
<p>
To improve performance, please enable 'server side prepare' under Options / Datasource / Page 2 / Server side prepare.
</p>
<p>
Afterwards, you may use this data source.
</p>
......
h2/src/docsrc/html/changelog.html
浏览文件 @ adf661ad
......@@ -18,7 +18,14 @@ Change Log
<h1>Change Log</h1>
<h2>Next Version (unreleased)</h2>
<ul><li>-
<ul><li>The database now tries to detect if the classloader or virtual machine has
almost shut down by checking if static final variables are set to null.
</li><li>Compatibility for MS SQL Server DATEDIFF(YYYY, .., ..)
</li><li>ResultSet.getObject for CLOB or BLOB will return a java.sql.Clob / java.sql.Blob object instead of
a java.io.Reader / java.io.InputStream as in version 1.0. This behavior can be changed using the system
property h2.returnLobObjects (true by default for version 1.1).
</li><li>The interface CloseListener has a new method 'remove' that is called when the trigger is dropped.
</li><li>Fulltext search: there was a memory leak when creating and dropping fulltext indexes in a loop.
</li></ul>
<h2>Version 1.1.103 (2008-11-07)</h2>
......
h2/src/docsrc/html/roadmap.html
浏览文件 @ adf661ad
......@@ -385,6 +385,7 @@ Of course, patches are always welcome, but are not always applied as is. Patches
</li><li>ANALYZE: For unique indexes that allow null, count the number of null.
</li><li>AUTO_SERVER: support changing IP addresses (disable a network while the database is open).
</li><li>Avoid using java.util.Calendar internally because it's slow, complicated, and seems to be buggy.
</li><li>Support TRUNCATE .. CASCADE like PostgreSQL.
</li></ul>
<h2>Not Planned</h2>
......
h2/src/docsrc/html/tutorial.html
浏览文件 @ adf661ad
......@@ -18,6 +18,8 @@ Tutorial
<h1>Tutorial</h1>
<a href="#tutorial_starting_h2_console">
Starting and Using the H2 Console</a><br />
<a href="#console_settings">
Settings of the H2 Console</a><br />
<a href="#connecting_using_jdbc">
Connecting to a Database using JDBC</a><br />
<a href="#creating_new_databases">
......@@ -170,13 +172,6 @@ Multiple concurrent browser sessions are supported. As that the database objects
the amount of concurrent work is limited by the memory available to the server application.
</p>
<h3>Application Properties</h3>
<p>
Starting the server will create a configuration file in you local home directory called <code>.h2.server.properties</code>.
For Windows installations, this file will be in the directory <code>C:\Documents and Settings\[username]</code>.
This file contains the settings of the application.
</p>
<h3>Login</h3>
<p>
At the login page, you need to provide connection information to connect to a database.
......@@ -229,6 +224,15 @@ If you don't have the icon (because you started it in another way),
press [Ctrl]+[C] on the console where the server was started (Windows),
or close the console window.
</p>
<br /><a name="console_settings"></a>
<h2>Settings of the H2 Console</h2>
<p>
The settings of the H2 Console are stored in a configuration file
called <code>.h2.server.properties</code> in you user home directory.
For Windows installations, the user home directory is usually <code>C:\Documents and Settings\[username]</code>.
The configuration file contains the settings of the application and is automatically created when the H2 Console is first started.
</p>
<br /><a name="connecting_using_jdbc"></a>
<h2>Connecting to a Database using JDBC</h2>
......
h2/src/docsrc/images/h2-logo.svg 0 → 100644
浏览文件 @ adf661ad
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="210mm"
height="297mm"
id="svg2"
sodipodi:version="0.32"
inkscape:version="0.46"
sodipodi:docname="h2-logo.svg"
inkscape:output_extension="org.inkscape.output.svg.inkscape">
<defs
id="defs4">
<linearGradient
id="linearGradient3180">
<stop
style="stop-color:#0028ff;stop-opacity:1;"
offset="0"
id="stop3182" />
<stop
style="stop-color:#0004b1;stop-opacity:1;"
offset="1"
id="stop3184" />
</linearGradient>
<inkscape:perspective
sodipodi:type="inkscape:persp3d"
inkscape:vp_x="0 : 526.18109 : 1"
inkscape:vp_y="0 : 1000 : 0"
inkscape:vp_z="744.09448 : 526.18109 : 1"
inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
id="perspective10" />
<inkscape:perspective
id="perspective2410"
inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
inkscape:vp_z="744.09448 : 526.18109 : 1"
inkscape:vp_y="0 : 1000 : 0"
inkscape:vp_x="0 : 526.18109 : 1"
sodipodi:type="inkscape:persp3d" />
<linearGradient
inkscape:collect="always"
xlink:href="#linearGradient3180"
id="linearGradient3196"
x1="110.00508"
y1="461.41727"
x2="636.30145"
y2="461.41727"
gradientUnits="userSpaceOnUse"
gradientTransform="translate(-68.690373,-242.43661)" />
<linearGradient
inkscape:collect="always"
xlink:href="#linearGradient3180"
id="linearGradient2398"
gradientUnits="userSpaceOnUse"
x1="110.00508"
y1="461.41727"
x2="636.30145"
y2="461.41727"
gradientTransform="translate(-63.000294,82.315191)" />
</defs>
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="0.49497475"
inkscape:cx="291.79875"
inkscape:cy="495.05695"
inkscape:document-units="px"
inkscape:current-layer="layer1"
showgrid="false"
inkscape:window-width="1440"
inkscape:window-height="803"
inkscape:window-x="0"
inkscape:window-y="70"
showguides="true"
inkscape:guide-bbox="true"
inkscape:snap-global="true"
inkscape:object-paths="true"
objecttolerance="6">
<inkscape:grid
type="xygrid"
id="grid2408"
visible="true"
enabled="true" />
</sodipodi:namedview>
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:label="Ebene 1"
inkscape:groupmode="layer"
id="layer1">
<rect
style="opacity:1;fill:#1021ff;fill-opacity:1;stroke:none;stroke-width:1.25;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
id="rect2416"
width="531.42859"
height="291.42856"
x="35.681995"
y="51.397469"
inkscape:export-filename="C:\data\h2database\h2\src\docsrc\images\text2418.png"
inkscape:export-xdpi="123.15"
inkscape:export-ydpi="123.15" />
<path
style="fill:url(#linearGradient3196);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.0010252px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
d="M 567.11059,95.135291 C 317.94601,125.92745 97.917928,208.10614 41.815218,342.82602 L 567.11059,342.82602 L 567.11059,95.135291 z"
id="path2400"
sodipodi:nodetypes="cccc"
inkscape:export-filename="C:\data\h2database\h2\src\docsrc\images\text2418.png"
inkscape:export-xdpi="123.15"
inkscape:export-ydpi="123.15" />
<image
xlink:href="h2-logo.png"
sodipodi:absref="C:\data\h2database\h2\src\docsrc\images\h2-logo.png"
width="530"
height="288"
transform="translate(40,717.36218)"
id="image2418" />
<path
style="font-size:204.59568787px;font-style:normal;font-weight:normal;line-height:125%;fill:#ffffff;fill-opacity:1;stroke:#000000;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;font-family:Bitstream Vera Sans"
d="M 324.56121,174.83457 L 354.83099,174.83457 L 354.83099,224.28519 L 381.70415,224.28519 L 381.70415,174.83457 L 411.97392,174.83457 L 411.97392,308.20139 L 381.70415,308.20139 L 381.70415,252.75676 L 354.83099,252.75676 L 354.83099,308.20139 L 324.56121,308.20139 L 324.56121,174.83457 z M 467.91806,224.28519 L 438.64729,224.28519 C 438.64728,214.29526 439.06353,206.46975 439.89604,200.80863 C 440.72853,195.14773 442.46013,190.13608 445.09085,185.77365 C 447.72154,181.41146 451.75084,177.91496 457.17878,175.28412 C 462.60666,172.65355 469.05022,171.3382 476.50948,171.33806 C 488.83044,171.3382 498.28766,174.56831 504.88115,181.02839 C 511.47448,187.48872 514.77118,196.81274 514.77127,209.00045 C 514.77118,215.26096 513.50578,222.00422 510.97506,229.23025 C 508.44417,236.45644 504.64797,244.3985 499.58643,253.05646 L 483.20279,281.02853 L 510.07596,281.02853 L 510.07596,308.20139 L 433.95198,308.20139 L 477.50848,233.77571 C 482.83644,224.85138 485.50044,216.72616 485.5005,209.40005 C 485.50044,205.73715 484.70124,202.74014 483.10289,200.40903 C 481.50443,198.07814 479.50643,196.91264 477.10888,196.91253 C 473.31262,196.91264 470.83177,198.42779 469.66631,201.45799 C 468.50077,204.4884 467.91802,210.46576 467.91806,219.39008 L 467.91806,224.28519 z"
id="text2418"
inkscape:export-xdpi="123.15"
inkscape:export-ydpi="123.15" />
<rect
style="opacity:1;fill:#1021ff;fill-opacity:1;stroke:none;stroke-width:1.25;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
id="rect2390"
width="531.42859"
height="291.42856"
x="41.372082"
y="376.14926" />
<path
style="fill:url(#linearGradient2398);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.0010252px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
d="M 572.80066,419.8871 C 323.63606,450.67926 103.60801,532.85795 47.505298,667.57783 L 572.80066,667.57783 L 572.80066,419.8871 z"
id="path2392"
sodipodi:nodetypes="cccc" />
<text
xml:space="preserve"
style="font-size:204.59568787px;font-style:normal;font-weight:normal;line-height:125%;fill:#ffffff;fill-opacity:1;stroke:#000000;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
x="315.96561"
y="632.95319"
id="text2394"
sodipodi:linespacing="125%"><tspan
sodipodi:role="line"
id="tspan2396"
x="315.96561"
y="632.95319"
style="font-size:204.59568787px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:#ffffff;fill-opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;font-family:Tw Cen MT Condensed Extra Bold;-inkscape-font-specification:'Tw Cen MT Condensed Extra Bold,'">H2</tspan></text>
<text
xml:space="preserve"
style="font-size:40px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans"
x="606.09149"
y="858.4129"
id="text2401"><tspan
sodipodi:role="line"
id="tspan2403"
x="606.09149"
y="858.4129">png</tspan></text>
<text
xml:space="preserve"
style="font-size:40px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Bitstream Vera Sans"
x="602.0509"
y="535.16412"
id="text2405"><tspan
sodipodi:role="line"
id="tspan2407"
x="602.0509"
y="535.16412">font</tspan></text>
</g>
</svg>
h2/src/docsrc/text/_docs_en.utf8.txt
浏览文件 @ adf661ad
......@@ -1127,963 +1127,975 @@ Change Log
Next Version (unreleased)
@changelog_1002_li
-
The database now tries to detect if the classloader or virtual machine has almost shut down by checking if static final variables are set to null.
@changelog_1003_h2
Version 1.1.103 (2008-11-07)
@changelog_1003_li
Compatibility for MS SQL Server DATEDIFF(YYYY, .., ..)
@changelog_1004_li
Could not order by a formula when the formula was in the group by list but not in the select list.
ResultSet.getObject for CLOB or BLOB will return a java.sql.Clob / java.sql.Blob object instead of a java.io.Reader / java.io.InputStream as in version 1.0. This behavior can be changed using the system property h2.returnLobObjects (true by default for version 1.1).
@changelog_1005_li
Date values that match the daylight saving time end were not allowed in times zones were the daylight saving time ends at midnight, for years larger than 2037. Example: timezone Brasilia, date 2042-10-12. This is a problem of Java, however a workaround is implemented in H2 that solves most problems (except the problems of java.util.Date itself).
The interface CloseListener has a new method 'remove' that is called when the trigger is dropped.
@changelog_1006_li
Fulltext search: there was a memory leak when creating and dropping fulltext indexes in a loop.
@changelog_1007_h2
Version 1.1.103 (2008-11-07)
@changelog_1008_li
Could not order by a formula when the formula was in the group by list but not in the select list.
@changelog_1009_li
Date values that match the daylight saving time end were not allowed in times zones were the daylight saving time ends at midnight, for years larger than 2037. Example: timezone Brasilia, date 2042-10-12. This is a problem of Java, however a workaround is implemented in H2 that solves most problems (except the problems of java.util.Date itself).
@changelog_1010_li
ALTER TABLE used a lot of memory when using multi-version concurrency.
@changelog_1007_li
@changelog_1011_li
Referential integrity for in-memory databases didn't work in some cases in version 1.1.102.
@changelog_1008_li
@changelog_1012_li
New column INFORMATION_SCHEMA.COLUMNS.SEQUENCE_NAME to get the name of the sequence for auto-increment columns.
@changelog_1009_li
@changelog_1013_li
Aliases for built-in data types (such as MEDIUMBLOB which is an alias for BLOB) can now be re-mapped to another data type using CREATE DOMAIN. However main built-in data types (such as INTEGER) can not be re-mapped.
@changelog_1010_li
@changelog_1014_li
The Japanese translation has been completed by Masahiro Ikemoto. Thanks a lot!
@changelog_1011_li
@changelog_1015_li
Improved PostgreSQL compatibility for NEXTVAL and CURRVAL.
@changelog_1012_li
@changelog_1016_li
Less heap memory is needed when multiple databases are open at the same time: The memory reserve (used to rollback after out of memory) is now global and no longer allocated for each database separately.
@changelog_1013_li
@changelog_1017_li
New system property h2.browser to set the browser to use.
@changelog_1014_li
@changelog_1018_li
To start the browser, java.awt.Desktop.browse is now used if available.
@changelog_1015_h2
@changelog_1019_h2
Version 1.1.102 (2008-10-24)
@changelog_1016_li
@changelog_1020_li
The French translation of the H2 Console has been improved by Olivier Parent. Thanks a lot!
@changelog_1017_li
@changelog_1021_li
There was a memory leak when creating and dropping tables and indexes in a loop (persistent database only).
@changelog_1018_li
@changelog_1022_li
SET LOG 2 was not effective if executed after opening the database.
@changelog_1019_li
@changelog_1023_li
Translating the H2 Console is now simpler.
@changelog_1020_li
@changelog_1024_li
Common exception (error code 23*) are no longer written to the .trace.db file by default.
@changelog_1021_li
@changelog_1025_li
In-memory databases don't write LOBs to files any longer.
@changelog_1022_li
@changelog_1026_li
Self referencing constraints didn't restrict deleting rows that reference itself if there is another row that references it.
@changelog_1023_li
@changelog_1027_li
ResultSetMetaData.getColumnName now returns the alias name except for columns.
@changelog_1024_li
@changelog_1028_li
Temporary files are now deleted when the database is closed, even if they were not garbage collected so far.
@changelog_1025_h2
@changelog_1029_h2
Version 1.1.101 (2008-10-17)
@changelog_1026_li
@changelog_1030_li
Errors with code 42000 - 42999 are no longer written to the trace file by default.
@changelog_1027_li
@changelog_1031_li
Queries with more than 10 tables are now faster.
@changelog_1028_li
@changelog_1032_li
Opening a connection with AUTO_SERVER=TRUE is now fast when the database is already open in another process (less than 0.01 seconds instead of 2 seconds).
@changelog_1029_li
@changelog_1033_li
IF [NOT] EXISTS is supported for named constraints in ALTER TABLE ... ADD/DROP CONSTRAINT.
@changelog_1030_li
@changelog_1034_li
The error messages have been translated to Spanish by Dario V. Fassi. Thanks a lot!
@changelog_1031_li
@changelog_1035_li
Linked tables: the automatic connection sharing didn't work. Actually the system property h2.shareLinkedConnections was working in the opposite direction: it was disabled when set to true. Now it works as expected.
@changelog_1032_li
@changelog_1036_li
Opening large database is now faster.
@changelog_1033_li
@changelog_1037_li
New system property h2.socketConnectTimeout, the timeout in milliseconds to connect to a server. The default is 2000 (2 seconds).
@changelog_1034_li
@changelog_1038_li
The wrong parameters were bound to subqueries with parameters, specially when using IN(SELECT ...) and IN(...).
@changelog_1035_li
@changelog_1039_li
Unset parameters were not detected when the query was re-compiled.
@changelog_1036_li
@changelog_1040_li
New functions ISO_YEAR, ISO_WEEK, ISO_DAY_OF_WEEK. Thanks a lot to Robert Rathsack for implementing those!
@changelog_1037_li
@changelog_1041_li
The date functions DAYOFYEAR, DAYOFMONTH, DAYOFWEEK are now called DAY_OF_YEAR, DAY_OF_MONTH, DAY_OF_WEEK (the old names still work).
@changelog_1038_li
@changelog_1042_li
An out of memory error while deleting or updating many rows could result in a strange exception.
@changelog_1039_li
@changelog_1043_li
Linked tables: compatibility with MS SQL Server has been improved.
@changelog_1040_li
@changelog_1044_li
Renaming tables that have foreign keys with cascade didn't work correctly.
@changelog_1041_li
@changelog_1045_li
The auto-reconnect feature didn't work when using the auto-server mode. Fixed.
@changelog_1042_li
@changelog_1046_li
Fulltext search: new method FT_DROP_INDEX.
@changelog_1043_li
@changelog_1047_li
The optimization to group using an index didn't work in some cases in version 1.1 (see also system property h2.optimizeGroupSorted).
@changelog_1044_li
@changelog_1048_li
OSGi meta data is included in the manifest file. An OSGi BundleActivator is included: it loads the database driver when starting the bundle, and unloads it when stopping the bundle.
@changelog_1045_li
@changelog_1049_li
The default value for MAX_MEMORY_UNDO is now 50000.
@changelog_1046_li
@changelog_1050_li
For alias columns, ResultSetMetaData.getTableName() and getColumnName() now return the real table and column name in the default mode.
@changelog_1047_li
@changelog_1051_li
In SQL scripts created with SCRIPT TO, schemas are now only created if they don't exist yet.
@changelog_1048_li
@changelog_1052_li
After re-connecting to a database, the database event listener (if set) is informed about it.
@changelog_1049_li
@changelog_1053_li
Local temporary tables now support indexes. Thanks a lot to Matt Roy!
@changelog_1050_li
@changelog_1054_li
RUNSCRIPT no longer uses a temporary file.
@changelog_1051_li
@changelog_1055_li
New system table INFORMATION_SCHEMA.SESSION_STATE containing the SQL statements that make up the session state. The list currently contains variables (SET @..) and local temporary tables (without data).
@changelog_1052_li
@changelog_1056_li
After an automatic re-connect, part of the session state stays (the part that is stored in the SESSION_STATE table).
@changelog_1053_li
@changelog_1057_li
The build didn't work if the directory temp didn't exist before.
@changelog_1054_li
@changelog_1058_li
New system property h2.maxReconnect (default 3) to limit the number of re-connects for the same SQL statement (this is usually only important for SHUTDOWN).
@changelog_1055_li
@changelog_1059_li
WHERE .. IN (SELECT ...) could throw a NullPointerException.
@changelog_1056_li
@changelog_1060_li
Improved Glassfish / Toplink support in H2Platform thanks to Marcio Borges from Brazil. Thanks a lot!
@changelog_1057_h2
@changelog_1061_h2
Version 1.1.100 (2008-10-04)
@changelog_1058_li
@changelog_1062_li
In version 1.1, the following system properties are now enabled by default: h2.lobFilesInDirectories, h2.optimizeGroupSorted, h2.optimizeInJoin, h2.shareLinkedConnections
@changelog_1059_li
@changelog_1063_li
The H2 Console tool now works with the JDBC-ODBC bridge.
@changelog_1060_li
@changelog_1064_li
The H2 Console tool now supports command line options to start things separately.
@changelog_1061_li
@changelog_1065_li
Large objects did not work for in-memory databases in server mode in Linux.
@changelog_1062_li
@changelog_1066_li
Connections from a local address other than 'localhost' were not allowed if remote connections were disabled. This was always a problem, but only got visible in the last release because the server no longer connects to 'localhost' if networked.
@changelog_1063_li
@changelog_1067_li
The h2console.war can now be built using the Java build.
@changelog_1064_li
@changelog_1068_li
By default, databases are shared in the same process. For read-only databases this causes unnecessary synchronization, but safes memory. If you want that each connection opens its own database, append ;OPEN_NEW=TRUE to the database URL.
@changelog_1065_li
@changelog_1069_li
New auto-reconnect feature will cause the JDBC driver to reconnect to the database if the connection is lost. To enable, append ;AUTO_RECONNECT=TRUE to the database URL. This is specially helpful when using AUTO_SERVER. AUTO_SERVER automatically uses auto-reconnect.
@changelog_1066_li
@changelog_1070_li
CreateCluster: the property 'serverlist' is now called 'serverList'.
@changelog_1067_li
@changelog_1071_li
The ConvertTraceFile tool could not parse some files because the trace mechanism did not encode prepared statement parameters.
@changelog_1068_li
@changelog_1072_li
Databases names can now be one character long (the minimum size used to be 2 characters).
@changelog_1069_h2
@changelog_1073_h2
Version 1.0.79 (2008-09-26)
@changelog_1070_li
@changelog_1074_li
Linked tables that point to the same database can now share the connection within the same database. Access to the same connection is serialized. To enable this feature, set the system property h2.shareLinkedConnections to true.
@changelog_1071_li
@changelog_1075_li
Multiple processes can now access the same database without having to explicitly start the server. To do that, append ;AUTO_SERVER=TRUE to the database URL. In this case, the server is started automatically if the connection is in embedded mode, and the server mode is used if a server is running. If the process that opened the first connection is closed, the other client need to reconnect (there is no automatic re-connect so far). Remote connections are allowed, but only to this database.
@changelog_1072_li
@changelog_1076_li
The server tool now displays the correct IP address if networked.
@changelog_1073_li
@changelog_1077_li
Can now start a TCP server with port 0 (automatically select a port).
@changelog_1074_li
@changelog_1078_li
Result sets with just a unique index can now be updated (previously a primary key was required).
@changelog_1075_li
@changelog_1079_li
LINKED TABLE: the schema name can now be set. When multiple tables exist in different schema, and the schema name is not set, an exception is thrown.
@changelog_1076_li
@changelog_1080_li
LINKED TABLE: worked around a bug in Oracle with the CHAR data type.
@changelog_1077_li
@changelog_1081_li
Faster hash code calculation for large binary arrays.
@changelog_1078_li
@changelog_1082_li
Faster storage re-use algorithm thanks to Greg Dhuse from cleversafe.com.
@changelog_1079_li
@changelog_1083_li
The database supports the SHOW command for better MySQL and PostgreSQL compatibility.
@changelog_1080_li
@changelog_1084_li
The H2 Console now abbreviates large texts in results.
@changelog_1081_li
@changelog_1085_li
Multiple UNION queries could not be used in derived tables.
@changelog_1082_li
@changelog_1086_li
Linked tables can now be read-only.
@changelog_1083_li
@changelog_1087_li
Temporary linked tables are now supported.
@changelog_1084_li
@changelog_1088_li
It was possible to create tables in read-only databases.
@changelog_1085_li
@changelog_1089_li
SET SCHEMA_SEARCH_PATH is now documented.
@changelog_1086_li
@changelog_1090_li
SET SCHEMA did not work for views.
@changelog_1087_li
@changelog_1091_li
Row level locking for MVCC is now enabled. The exception 'Concurrent update in table ...' is still thrown, but only after the lock timeout.
@changelog_1088_li
@changelog_1092_li
The maximum log file size setting was ignored for large databases.
@changelog_1089_li
@changelog_1093_li
Multi-Version Concurrency (MVCC) may no longer be used when using the multi-threaded kernel feature (MULTI_THREADED). An exception is thrown when trying to connect with both settings. Additional synchronization is required before those features can be used together.
@changelog_1090_li
@changelog_1094_li
The data type JAVA_OBJECT could not be used in updatable result sets.
@changelog_1091_li
@changelog_1095_li
The system property h2.optimizeInJoin did not work correctly.
@changelog_1092_li
@changelog_1096_li
Conditions such as ID=? AND ID>? were slow.
@changelog_1093_h2
@changelog_1097_h2
Version 1.0.78 (2008-08-28)
@changelog_1094_li
@changelog_1098_li
The documentation no longer uses a frameset (except the Javadocs).
@changelog_1095_li
@changelog_1099_li
When using DB_CLOSE_DELAY, sometimes a NullPointerException is thrown when the database is opened almost at the same time as it is closed automatically. Thanks a lot to Dmitry Pekar for finding this!
@changelog_1096_li
@changelog_1100_li
Java methods with variable number of parameters can now be used (for Java 1.5 or newer).
@changelog_1097_li
@changelog_1101_li
The Japanese translation has been improved by Masahiro Ikemoto. Thanks a lot!
@changelog_1098_li
@changelog_1102_li
The H2 Console replaced an empty user name with a single space.
@changelog_1099_li
@changelog_1103_li
The build target 'build jarSmall' now includes the embedded database.
@changelog_1100_li
@changelog_1104_li
JdbcDataSource now keeps the password in a char array where possible.
@changelog_1101_li
@changelog_1105_li
ResultSet.absolute did not always work with large result sets.
@changelog_1102_li
@changelog_1106_li
Column aliases can now be used in GROUP BY and HAVING.
@changelog_1103_li
@changelog_1107_li
Jason Brittain has contributed MySQL date functions. Thanks a lot! They are not in the h2.jar file currently, but in src/tools/org/h2/mode/FunctionsMySQL.java. To install, add this class to the classpath and call FunctionsMySQL.register(conn) in the Java code.
@changelog_1104_h2
@changelog_1108_h2
Version 1.0.77 (2008-08-16)
@changelog_1105_li
@changelog_1109_li
JaQu is now using prepared statements and supports Date, Time, Timestamp.
@changelog_1106_li
@changelog_1110_li
When using remote in-memory databases, large LOB objects did not work.
@changelog_1107_li
@changelog_1111_li
Timestamp columns such as TIMESTAMP(6) were not compatible to other database.
@changelog_1108_li
@changelog_1112_li
Opening a large database was slow if there was a problem opening the previous time.
@changelog_1109_li
@changelog_1113_li
NOT IN(SELECT ...) was incorrect if the subquery returns no rows.
@changelog_1110_li
@changelog_1114_li
CREATE TABLE AS SELECT did not work correctly in the multi-version concurrency mode.
@changelog_1111_li
@changelog_1115_li
Support a comma before closing a list, as in: create table test(id int,)
@changelog_1112_li
@changelog_1116_li
MySQL compatibility: linked tables had lower case column names on some systems.
@changelog_1113_li
@changelog_1117_li
DB2 compatibility: the DB2 fetch-first-clause is supported.
@changelog_1114_li
@changelog_1118_li
Oracle compatibility: old style outer join syntax using (+) did work correctly sometimes.
@changelog_1115_li
@changelog_1119_li
ResultSet.setFetchSize is now supported.
@changelog_1116_li
@changelog_1120_li
It has been reported that when using Install4j on some Linux systems and enabling the 'pack200' option, the h2.jar becomes corrupted by the install process, causing application failure. A workaround is to add an empty file h2.jar.nopack next to the h2.jar file. The reason for this problem is not known.
@changelog_1117_h2
@changelog_1121_h2
Version 1.0.76 (2008-07-27)
@changelog_1118_li
@changelog_1122_li
The comment of a domain (user defined data type) is now used as the default column comment when creating a column with this domain.
@changelog_1119_li
@changelog_1123_li
Invalid database names are now detected and a better error message is thrown.
@changelog_1120_li
@changelog_1124_li
ResultSetMetaData.getColumnClassName now returns the correct class name for BLOB and CLOB.
@changelog_1121_li
@changelog_1125_li
Fixed the Oracle mode: Oracle allows multiple rows only where all columns of the unique index are NULL.
@changelog_1122_li
@changelog_1126_li
There is a problem with Hibernate when using Boolean columns. A patch for Hibernate has been submitted at http://opensource.atlassian.com/projects/hibernate/browse/HHH-3401
@changelog_1123_li
@changelog_1127_li
ORDER BY on tableName.columnName didn't work correctly if the column name was also used as an alias.
@changelog_1124_li
@changelog_1128_li
H2 Console: The progress display when opening a database has been improved.
@changelog_1125_li
@changelog_1129_li
The error message when the server doesn't start has been improved.
@changelog_1126_li
@changelog_1130_li
Key values can now be changed in updatable result sets.
@changelog_1127_li
@changelog_1131_li
Changes in updatable result sets are now visible even when resetting the result set.
@changelog_1128_li
@changelog_1132_li
Temporary files were sometimes deleted too late when executing large insert, update, or delete operations.
@changelog_1129_li
@changelog_1133_li
The database file was growing after deleting many rows, and after large update operations.
@changelog_1130_h2
@changelog_1134_h2
Version 1.0.75 (2008-07-14)
@changelog_1131_li
@changelog_1135_li
Multi version concurrency (MVCC): when a row was updated or deleted, but this change was rolled back, the row was not visible by other sessions if no index was used to access it. Fixed.
@changelog_1132_li
@changelog_1136_li
Views with multiple joined tables (where one was an outer join) couldn't be used in some cases. Fixed.
@changelog_1133_li
@changelog_1137_li
The CSVREAD method did not process NULL correctly when using a whitespace field separator.
@changelog_1134_li
@changelog_1138_li
Fixed the Oracle mode: Oracle allows multiple rows with NULL in a unique index.
@changelog_1135_li
@changelog_1139_li
Running out of memory could result in incomplete transactions or corrupted databases. Fixed.
@changelog_1136_li
@changelog_1140_li
When using order by in a query that uses the same table multiple times, the order could be incorrect. Fixed.
@changelog_1137_li
@changelog_1141_li
Referential constraint checking improvement: now the constraint is only checked if the key column values change.
@changelog_1138_li
@changelog_1142_li
Some database metadata calls returned the wrong data type for DATA_TYPE columns.
@changelog_1139_li
@changelog_1143_li
The Lucene fulltext index was empty when opening a database with fulltext index enabled, and re-indexing it didn't work. Fixed.
@changelog_1140_li
@changelog_1144_li
The character '$' could not be used in identifier names (table name, column names and so on). Fixed.
@changelog_1141_li
@changelog_1145_li
The new method org.h2.tools.Server.startWebServer(conn) starts the H2 Console to inspect a database while debugging.
@changelog_1142_li
@changelog_1146_li
Stopping a WebServer didn't always work. Fixed.
@changelog_1143_h2
@changelog_1147_h2
Version 1.0.74 (2008-06-21)
@changelog_1144_li
@changelog_1148_li
Work on row level locking has been started (but there is nothing usable yet).
@changelog_1145_li
@changelog_1149_li
JaQu (Java Query), a tool similar to LINQ (Language Integrated Query; from Microsoft) is now included under src/tools/org/h2/jaqu. A small sample application is included under src/test/org/h2/test/jaqu.
@changelog_1146_li
@changelog_1150_li
The source code is now switched to Java 1.6 by default. To switch back to Java 1.4, run 'build compile'. The h2.jar file is still Java 1.4.
@changelog_1147_li
@changelog_1151_li
The ChangePassword tool is now called ChangeFileEncryption.
@changelog_1148_li
@changelog_1152_li
It is no longer allowed to create columns with the data type NULL. Also, it is no longer allowed to convert a column to the data type NULL. This was possible before but caused data loss.
@changelog_1149_li
@changelog_1153_li
When using computed columns or default values with a different data type than the column data type, a class cast exception could occur. Fixed.
@changelog_1150_li
@changelog_1154_li
Opening databases larger than 1 GB was sometimes very slow if a lot of data was deleted previously. Fixed.
@changelog_1151_li
@changelog_1155_li
RUNSCRIPT could throw a NullPointerException if the script name was an expression.
@changelog_1152_li
@changelog_1156_li
Improved compatibility. New compatibility modes for Oracle and Derby. New compatibility flag uniqueIndexNullDistinct to only allow one row with 'NULL' in a unique index. This flag is enabled for Derby, Oracle, MSSQLServer, and HSQLDB.
@changelog_1153_li
@changelog_1157_li
Linked tables: To view the statements that are executed against the target table, set the trace level to 3.
@changelog_1154_li
@changelog_1158_li
RunScript tool: new options to show and check the results of queries.
@changelog_1155_li
@changelog_1159_li
Deadlocks are now detected. One transaction is rolled back automatically.
@changelog_1156_li
@changelog_1160_li
The Lucene fulltext index was always re-created when opening a database with fulltext index enabled.
@changelog_1157_li
@changelog_1161_li
Support for overloaded Java methods. A user defined function can now be bound to multiple Java methods, if the Java methods have the same name but a different number of parameters. Thanks to Gary Tong for providing a patch!
@changelog_1158_h2
@changelog_1162_h2
Version 1.0.73 (2008-05-31)
@changelog_1159_li
@changelog_1163_li
ParameterMetaData now returns the right data type for most conditions, as in WHERE ID=?.
@changelog_1160_li
@changelog_1164_li
The table SYSTEM_RANGE now supports expressions and parameters.
@changelog_1161_li
@changelog_1165_li
New column INFORMATION_SCHEMA.CONSTRAINTS.UNIQUE_INDEX_NAME that contains the name of the unique index used to enforce this constraint, if there is such an index.
@changelog_1162_li
@changelog_1166_li
SET QUERY_TIMEOUT and Statement.setQueryTimeout no longer commits a transaction. The same applies to SET @VARIABLE, SET LOCK_TIMEOUT, SET TRACE_LEVEL_*, SET THROTTLE, and SET PATH.
@changelog_1163_li
@changelog_1167_li
The SCRIPT command does now emit IF NOT EXISTS for CREATE ROLE.
@changelog_1164_li
@changelog_1168_li
MySQL compatibility: auto_increment column are no longer automatically converted to primary key columns.
@changelog_1165_li
@changelog_1169_li
PostgreSQL compatibility: support for BOOL_OR and BOOL_AND aggregate functions.
@changelog_1166_li
@changelog_1170_li
Negative scale values for DECIMAL or NUMBER columns are now supported in regular tables and in linked tables.
@changelog_1167_li
@changelog_1171_li
A role or right can now be granted or revoked multiple times without getting an exception.
@changelog_1168_li
@changelog_1172_li
Infinite numbers in SQL scripts are listed as POWER(0, -1)), negative infinite as (-POWER(0, -1)), and NaN (not a number) as SQRT(-1).
@changelog_1169_li
@changelog_1173_li
The special double and float values 'NaN' (not a number) did not work correctly when sorting or comparing.
@changelog_1170_li
@changelog_1174_li
The fulltext search did not support CLOB data types.
@changelog_1171_li
@changelog_1175_li
If the drive with the database files was disconnected or unmounted while writing, sometimes a stack overflow exception was thrown instead of a IO exception.
@changelog_1172_li
@changelog_1176_li
The H2 Console could not be shut down from within the tool if the browser supports keepAlive (most browsers do).
@changelog_1173_li
@changelog_1177_li
If the password was passed as a char array, it was kept in an internal buffer longer than required. Theoretically the password could have been stolen if the main memory was swapped to disk before the garbage collection was run.
@changelog_1174_h2
@changelog_1178_h2
Version 1.0.72 (2008-05-10)
@changelog_1175_li
@changelog_1179_li
Some databases could not be opened when appending ;RECOVER=1 to the database URL.
@changelog_1176_li
@changelog_1180_li
The Japanese translation of the error messages and the H2 Console has been completed by Masahiro Ikemoto (Arizona Design Inc.)
@changelog_1177_li
@changelog_1181_li
Updates made to updatable rows are now visible within the same result set. DatabaseMetaData.ownUpdatesAreVisible now returns true.
@changelog_1178_li
@changelog_1182_li
ParameterMetaData now returns the correct data for INSERT and UPDATE statements.
@changelog_1179_li
@changelog_1183_li
H2 Shell: DESCRIBE now supports an schema name.
@changelog_1180_li
@changelog_1184_li
A subset of the PostgreSQL 'dollar quoting' feature is now supported.
@changelog_1181_li
@changelog_1185_li
SLF4J is now supported by using adding TRACE_LEVEL_FILE=4 to the database URL.
@changelog_1182_li
@changelog_1186_li
The recovery tool did not work if the table name contained spaces or if there was a comment on the table.
@changelog_1183_li
@changelog_1187_li
Triggers are no longer executed when changing the table structure (ALTER TABLE).
@changelog_1184_li
@changelog_1188_li
When setting BLOB or CLOB values larger than 65 KB using a remote connection, temporary files were kept on the client longer than required (until the connection was closed or the object is garbage collected). Now they are removed as soon as the PreparedStatement is closed, or when the value is overwritten.
@changelog_1185_li
@changelog_1189_li
Statements can now be canceled remotely (when using remote connections).
@changelog_1186_li
@changelog_1190_li
The Shell tool now uses java.io.Console to read the password when using JDK 1.6
@changelog_1187_li
@changelog_1191_li
When using read-only databases and setting LOG=2, an exception was written to the trace file when closing the database. Fixed.
@changelog_1188_h2
@changelog_1192_h2
Version 1.0.71 (2008-04-25)
@changelog_1189_li
@changelog_1193_li
H2 is now dual-licensed under the Eclipse Public License (EPL) and the old 'H2 License' (which is basically MPL).
@changelog_1190_li
@changelog_1194_li
Sometimes an exception 'File ID mismatch' or 'try to add a record twice' occurred after large records (8 KB or larger) are updated or deleted. See also http://code.google.com/p/h2database/issues/detail?id=22
@changelog_1191_li
@changelog_1195_li
H2 Console: The tools can now be translated (it didn't work in the last release).
@changelog_1192_li
@changelog_1196_li
New traditional Chinese translation. Thanks a lot to Derek Chao!
@changelog_1193_li
@changelog_1197_li
Indexes were not used when enabling the optimization for IN(SELECT...) (system property h2.optimizeInJoin).
@changelog_1194_h2
@changelog_1198_h2
Version 1.0.70 (2008-04-20)
@changelog_1195_li
@changelog_1199_li
The plan is to dual-license H2. The additional license is EPL (Eclipse Public License). The current license (MPL, Mozilla Public License) will stay. Current users are not affected because they can keep MPL. EPL is very similar to MPL, the only bigger difference is related to patents (EPL is a bit more business friendly in this regard). See also http://opensource.org/licenses/eclipse-1.0.php, http://www.eclipse.org/legal/eplfaq.php (FAQ), http://blogs.zdnet.com/Burnette/?p=131
@changelog_1196_li
@changelog_1200_li
Multi version concurrency (MVCC): when a row was updated, and the updated column was not indexed, this update was visible sometimes for other sessions even if it was not committed.
@changelog_1197_li
@changelog_1201_li
Calling SHUTDOWN on one connection and starting a query on another connection concurrently could result in a Java level deadlock.
@changelog_1198_li
@changelog_1202_li
New system property h2.enableAnonymousSSL (default: true) to enable anonymous SSL connections.
@changelog_1199_li
@changelog_1203_li
The precision if SUBSTR is now calculated if possible.
@changelog_1200_li
@changelog_1204_li
The autocomplete in the H2 Console has been improved a bit.
@changelog_1201_li
@changelog_1205_li
The tools in the H2 Console are now translatable.
@changelog_1202_li
@changelog_1206_li
The servlet and lucene jar files are now automatically downloaded when building.
@changelog_1203_li
@changelog_1207_li
The code switch tool has been replaced by a simpler tool called SwitchSource that just uses find and replace.
@changelog_1204_li
@changelog_1208_li
Started to write a Ant replacement ('JAnt') that uses pure Java build definitions. Advantages: ability to debug the build, extensible, flexible, no XML, a bit faster. Future plan: support creating custom h2 distributions (for embedded use). Maybe create a new project 'Jant' or 'Javen' if other people are interested.
@changelog_1205_li
@changelog_1209_li
The jar file is now about 10% smaller because the variable debugging info is no longer included. The source file and line number debugging info is still included. If required, the jar file size of the full version can be further reduced to about 720 KB using 'build jarSmall' or even more by removing unneeded components.
@changelog_1206_li
@changelog_1210_li
Added shell scripts run.sh and build.sh. chmod +x is required, but otherwise it should work. Feedback or improvements are welcome!
@changelog_1207_li
@changelog_1211_li
Databases in zip files: large queries are now supported. Temp files are created in the temp directory if required. The documentation how to create the zip file has been corrected.
@changelog_1208_li
@changelog_1212_li
Invalid inline views threw confusing SQL exceptions.
@changelog_1209_li
@changelog_1213_li
The Japanese translation of the error messages and the H2 Console has been improved. Thanks a lot to Masahiro IKEMOTO.
@changelog_1210_li
@changelog_1214_li
Optimization for MIN() and MAX() when using MVCC.
@changelog_1211_li
@changelog_1215_li
To protect against remote brute force password attacks, the delay after each unsuccessful login now gets double as long. New system properties h2.delayWrongPasswordMin and h2.delayWrongPasswordMax.
@changelog_1212_li
@changelog_1216_li
After setting the query timeout and then resetting it, the next query would still timeout. Fixed.
@changelog_1213_li
@changelog_1217_li
Adding a IDENTITY column to a table with data threw a lock timeout.
@changelog_1214_li
@changelog_1218_li
OutOfMemoryError could occur when using EXISTS or IN(SELECT ..).
@changelog_1215_li
@changelog_1219_li
The built-in connection pool is not called JdbcConnectionPool. The API and documentation has been changed.
@changelog_1216_li
@changelog_1220_li
The ConvertTraceFile tool now generates SQL statement statistics at the end of the SQL script file (similar to the profiling data generated when using java -Xrunhprof).
@changelog_1217_li
@changelog_1221_li
Nested joins are now supported (A JOIN B JOIN C ON .. ON ..)
@changelog_1218_h2
@changelog_1222_h2
Version 1.0.69 (2008-03-29)
@changelog_1219_li
@changelog_1223_li
Most command line tools can now be called from within the H2 Console.
@changelog_1220_li
@changelog_1224_li
A new Shell tools is now included (org.h2.tools.Shell) to query a database from the command line.
@changelog_1221_li
@changelog_1225_li
The command line options in the tools have changed: instead of '-log true' now '-trace' is used. Also, '-ifExists', '-tcpSSL' and '-tcpAllowOthers' and so on have changed: now the 'true' is no longer needed. The old behavior is still supported.
@changelog_1222_li
@changelog_1226_li
New system property h2.sortNullsHigh to invert the default sorting behavior for NULL. The default didn't change.
@changelog_1223_li
@changelog_1227_li
Performance was very slow when using LOG=2 and deleting or updating all rows of a table in a loop. Fixed.
@changelog_1224_li
@changelog_1228_li
ALTER TABLE or CREATE TABLE now support parameters for the password field.
@changelog_1225_li
@changelog_1229_li
The linear hash has been removed. It was always slower than the b-tree index, and there were some bugs that would be hard to fix.
@changelog_1226_li
@changelog_1230_li
TRACE_LEVEL_ settings are no longer persistent. This was a problem when database initialization code caused a lot of trace output.
@changelog_1227_li
@changelog_1231_li
Fulltext search (native implementation): The words table is no longer an in-memory table because this caused memory problems in some cases.
@changelog_1228_li
@changelog_1232_li
It was possible to create a role with the name as an existing user (but not vice versa). This is not allowed any more.
@changelog_1229_li
@changelog_1233_li
The recovery tool didn't work correctly for tables without rows.
@changelog_1230_li
@changelog_1234_li
For years below 1, the YEAR method didn't return the correct value, and the conversion from date and timestamp to varchar was incorrect.
@changelog_1231_li
@changelog_1235_li
CSVWRITE caused a NullPointerException when not specifying a nullString.
@changelog_1232_li
@changelog_1236_li
When a log file switch occurred just after a truncate table or drop table statement, the database could not be started normally (RECOVER=1 was required). Fixed.
@changelog_1233_li
@changelog_1237_li
When a log file switch occurred in the middle of a sequence flush (sequences are only flushed every 32 values by default), the sequence value was lost. Fixed.
@changelog_1234_li
@changelog_1238_li
Altering a sequence didn't unlock the system table when autocommit switched off.
@changelog_1235_h2
@changelog_1239_h2
Version 1.0.68 (2008-03-18)
@changelog_1236_li
@changelog_1240_li
Very large SELECT DISTINCT and UNION EXCEPT queries are now supported, however this feature is disabled by default. To enable it, set the system property h2.maxMemoryRowsDistinct to a lower value, for example 10000.
@changelog_1237_li
@changelog_1241_li
A error is now thrown when trying to call a method inside a trigger that implicitly commits the current transaction, if an object is locked.
@changelog_1238_li
@changelog_1242_li
Unused LOB files were deleted much too late. Now they are deleted if no longer referenced in memory.
@changelog_1239_li
@changelog_1243_li
ALTER SEQUENCE and ALTER TABLE ALTER COLUMN RESTART can now be used inside a transaction.
@changelog_1240_li
@changelog_1244_li
New system property h2.aliasColumnName. When enabled, aliased columns (as in SELECT ID AS I FROM TEST) return the real table and column name in ResultSetMetaData.getTableName() and getColumnName(). This is disabled by default for compatibility with other databases (HSQLDB, Apache Derby, PostgreSQL, some version of MySQL). In version 1.1 this setting will be enabled.
@changelog_1241_li
@changelog_1245_li
When using encrypted databases, and using the wrong file password, the log file was renamed if the database was not already open. Fixed.
@changelog_1242_li
@changelog_1246_li
Improved performance when using lob files in directories (however this is still disabled by default)
@changelog_1243_li
@changelog_1247_li
H2 Console: autocomplete didn't work with very large scripts. Fixed.
@changelog_1244_li
@changelog_1248_li
Fulltext search: new method SEARCH_DATA that returns the column names and primary keys as arrays.
@changelog_1245_li
@changelog_1249_li
New experimental optimization for GROUP BY queries if an index can be used that matches the group by columns. To enable this optimization, set the system property h2.optimizeGroupSorted to true.
@changelog_1246_li
@changelog_1250_li
When using multi-version concurrency (MVCC=TRUE), duplicate rows could appear in the result set when running queries with uncommitted changes in the same session.
@changelog_1247_li
@changelog_1251_li
H2 Console: remote connections were very slow because getHostName/getRemoteHost was used. Fixed (now using getHostAddress/getRemoteAddr.
@changelog_1248_li
@changelog_1252_li
H2 Console: on Linux, Firefox, Konqueror, or Opera (in this order) are now started if available. This has been tested on Ubuntu.
@changelog_1249_li
@changelog_1253_li
H2 Console: the start window works better with IKVM
@changelog_1250_li
@changelog_1254_li
H2 Console: improved compatibility with Safari (Safari requires keep-alive)
@changelog_1251_li
@changelog_1255_li
Random: the process didn't stop if generating the random seed using the standard way (SecureRandom.generateSeed) was very slow. Now using a daemon thread to avoid this problem.
@changelog_1252_li
@changelog_1256_li
SELECT UNION with a different number of ORDER BY columns did throw an ArrayIndexOutOfBoundsException.
@changelog_1253_li
@changelog_1257_li
When using a view, the column precision was changed to the default scale for some data types.
@changelog_1254_li
@changelog_1258_li
CSVWRITE now supports a 'null string' that is used for parsing and writing NULL.
@changelog_1255_li
@changelog_1259_li
Some long running queries could not be canceled.
@changelog_1256_li
@changelog_1260_li
Queries with many outer join tables were very slow. Fixed.
@changelog_1257_li
@changelog_1261_li
The performance of text comparison has been improved when using locale sensitive string comparison (SET COLLATOR). Now CollationKey is used with a LRU cache. The default cache size is 10000, and can be changed using the system property h2.collatorCacheSize. Use 0 to disable the cache.
@changelog_1258_li
@changelog_1262_li
UPDATE SET column=DEFAULT is now supported.
@changelog_1259_h2
@changelog_1263_h2
Version 1.0.67 (2008-02-22)
@changelog_1260_li
@changelog_1264_li
New function FILE_READ to read a file or from an URL. Both binary and text data is supported.
@changelog_1261_li
@changelog_1265_li
CREATE TABLE AS SELECT now supports specifying the column list and data types.
@changelog_1262_li
@changelog_1266_li
Connecting to a TCP server and at shutting it down at the same time could cause a Java level deadlock.
@changelog_1263_li
@changelog_1267_li
A user now has all rights on his own local temporary tables.
@changelog_1264_li
@changelog_1268_li
The CSV tool now supports a custom lineSeparator.
@changelog_1265_li
@changelog_1269_li
When using multiple connections, empty space was reused too early sometimes. This could corrupt the database when recovering.
@changelog_1266_li
@changelog_1270_li
The H2 Console has been translated to Dutch. Thanks a lot to Remco Schoen!
@changelog_1267_li
@changelog_1271_li
Databases can now be opened even if trigger classes are not in the classpath. The exception is thrown when trying to fire the trigger.
@changelog_1268_li
@changelog_1272_li
Opening databases with ACCESS_MODE_DATA=r is now supported. In this case the database is read-only, but the files don't not need to be read-only.
@changelog_1269_li
@changelog_1273_li
Security: The database now waits 200 ms before throwing an exception if the user name or password don't match, to slow down dictionary attacks.
@changelog_1270_li
@changelog_1274_li
The value cache is now a soft reference cache. This should help save memory.
@changelog_1271_li
@changelog_1275_li
CREATE INDEX on a table with many rows could run out of memory. Fixed.
@changelog_1272_li
@changelog_1276_li
Large result sets are now a bit faster.
@changelog_1273_li
@changelog_1277_li
ALTER TABLE ALTER COLUMN RESTART and ALTER SEQUENCE now support parameters (any expressions).
@changelog_1274_li
@changelog_1278_li
When setting the base directory on the command line, the user directory prefix ('~') was ignored.
@changelog_1275_li
@changelog_1279_li
The DbStarter servlet didn't start the TCP listener even if configured.
@changelog_1276_li
@changelog_1280_li
Statement.setQueryTimeout() is now supported.
@changelog_1277_li
@changelog_1281_li
New session setting QUERY_TIMEOUT, and new system property h2.maxQueryTimeout.
@changelog_1278_li
@changelog_1282_li
Changing the transaction log level (SET LOG) is now written to the trace file by default.
@changelog_1279_li
@changelog_1283_li
In a SQL script, primary key constraints are now ordered before foreign key constraints.
@changelog_1280_li
@changelog_1284_li
It was not possible to create a referential constraint to a table in a different schema in some situations.
@changelog_1281_li
@changelog_1285_li
The H2 Console was slow when the database contains many tables. Now the column names are not shown in this case.
@changelog_1282_h2
@changelog_1286_h2
Version 1.0.66 (2008-02-02)
@changelog_1283_li
@changelog_1287_li
There is a new online error analyzer tool.
@changelog_1284_li
@changelog_1288_li
H2 Console: stack traces are now links to the source code in the source repository (H2 database only).
@changelog_1285_li
@changelog_1289_li
CHAR data type equals comparison was case insensitive instead of case sensitive.
@changelog_1286_li
@changelog_1290_li
The exception 'Value too long for column' now includes the data.
@changelog_1287_li
@changelog_1291_li
The table name was missing in the documentation of CREATE INDEX.
@changelog_1288_li
@changelog_1292_li
Better support for IKVM (www.ikvm.net): the H2 Console now opens a browser window.
@changelog_1289_li
@changelog_1293_li
The cache size was not correctly calculated for tables with large objects (specially if compression is used). This could lead to out-of-memory exceptions.
@changelog_1290_li
@changelog_1294_li
The exception "Hexadecimal string contains non-hex character" was not always thrown when it should have been. Fixed.
@changelog_1291_li
@changelog_1295_li
The H2 Console now provides a link to the documentation when an error occurs (H2 databases only so far).
@changelog_1292_li
@changelog_1296_li
The acting as PostgreSQL server, when a base directory was set, and the H2 Console was started as well, the base directory was applied twice.
@changelog_1293_li
@changelog_1297_li
Calling EXTRACT(HOUR FROM ...) or EXTRACT(HH FROM ...) returned the wrong values (0 to 11 instead of 0 to 23). All other tested databases return values from 0 to 23. Please check if your application relies on the old behavior before upgrading.
@changelog_1294_li
@changelog_1298_li
For compatibility with other databases the column default (COLUMN_DEF) for columns without default is now null (it was an empty string).
@changelog_1295_li
@changelog_1299_li
Statements that contain very large subqueries (where the subquery result does not fit in memory) are now faster.
@changelog_1296_li
@changelog_1300_li
Variables: large objects (CLOB and BLOB) that don't fit in memory did not work correctly when used as variables.
@changelog_1297_li
@changelog_1301_li
Fulltext search is now supported in named in-memory databases.
@changelog_1298_li
@changelog_1302_li
H2 Console: multiple consecutive spaces in the setting name did not work. Fixed.
@changelog_1299_h2
@changelog_1303_h2
Version 1.0.65 (2008-01-18)
@changelog_1300_li
@changelog_1304_li
The build (ant) now automatically switches the source code to the correct version (JDK 1.4/1.5 or 1.6).
@changelog_1301_li
@changelog_1305_li
A recovery bug has been fixed. With older versions, it was necessary to add ;RECOVER=1 to the database URL in cases where it should not have been required.
@changelog_1302_li
@changelog_1306_li
The performance for DROP and DROP ALL OBJECTS has been improved.
@changelog_1303_li
@changelog_1307_li
The ChangePassword API has been improved.
@changelog_1304_li
@changelog_1308_li
User defined variables are now supported. Examples: SET @VAR=10;CALL @VAR. This can be used for running totals as in: select x, set(@t, ifnull(@t, 0) + x) from system_range(1, 10)
@changelog_1305_li
@changelog_1309_li
The Ukrainian translation has been improved.
@changelog_1306_li
@changelog_1310_li
CALL statements can now be used in batch updates and called using Statement.executeUpdate.
@changelog_1307_li
@changelog_1311_li
New read-only setting CREATE_BUILD (the build number of the database engine that created the database).
@changelog_1308_li
@changelog_1312_li
The optimizer did not use multi column indexes for range queries in some cases. Fixed.
@changelog_1309_li
@changelog_1313_li
The H2 Console now calls DataSource.getConnection() instead of DataSource.getConnection(user, password) when user name and password are not specified.
@changelog_1310_li
@changelog_1314_li
The bind IP address can now be set when using multi-homed host (if multiple network adapters are available) using the system property h2.bindAddress.
@changelog_1311_li
@changelog_1315_li
Batch update: Calling BatchUpdateException.printStackTrace() could result in out of memory. Fixed.
@changelog_1312_li
@changelog_1316_li
Indexes of unique or foreign constraints where not dropped when the constraint was dropped after altering the table (for example dropping a column). Fixed.
@changelog_1313_li
@changelog_1317_li
The performance for large result sets in the server mode has been improved.
@changelog_1314_li
@changelog_1318_li
The setting h2.serverSmallResultSetSize has been renamed to h2.serverResultSetFetchSize.
@changelog_1315_li
@changelog_1319_li
The SCRIPT command now uses multi-row insert statements to save space except if the option SIMPLE is used.
@changelog_1316_li
@changelog_1320_li
The SCRIPT command did not split up CLOB data correctly. Fixed.
@changelog_1317_li
@changelog_1321_li
Optimization for single column distinct queries with an index: select distinct name from test. Can be disabled by setting the system property h2.optimizeDistinct to false.
@changelog_1318_li
@changelog_1322_li
DROP ALL OBJECTS did not drop user defined aggregate functions and domains.
@changelog_1319_li
@changelog_1323_li
PostgreSQL compatibility: COUNT(T.*) is now supported.
@changelog_1320_li
@changelog_1324_li
LIKE comparisons are now faster.
@changelog_1321_li
@changelog_1325_li
Encrypted databases are now faster.
@download_1000_h1
......@@ -8065,13 +8077,16 @@ AUTO_SERVER: support changing IP addresses (disable a network while the database
@roadmap_1354_li
Avoid using java.util.Calendar internally because it's slow, complicated, and seems to be buggy.
@roadmap_1355_h2
@roadmap_1355_li
Support TRUNCATE .. CASCADE like PostgreSQL.
@roadmap_1356_h2
Not Planned
@roadmap_1356_li
@roadmap_1357_li
HSQLDB (did) support this: select id i from test where i>0 (other databases don't). Supporting it may break compatibility.
@roadmap_1357_li
@roadmap_1358_li
String.intern (so that Strings can be compared with ==) will not be used because some VMs have problems when used extensively.
@search_1000_b
......@@ -8192,626 +8207,629 @@ Tutorial
Starting and Using the H2 Console
@tutorial_1002_a
Connecting to a Database using JDBC
Settings of the H2 Console
@tutorial_1003_a
Creating New Databases
Connecting to a Database using JDBC
@tutorial_1004_a
Using the Server
Creating New Databases
@tutorial_1005_a
Using Hibernate
Using the Server
@tutorial_1006_a
Using TopLink and Glassfish
Using Hibernate
@tutorial_1007_a
Using Databases in Web Applications
Using TopLink and Glassfish
@tutorial_1008_a
CSV (Comma Separated Values) Support
Using Databases in Web Applications
@tutorial_1009_a
Upgrade, Backup, and Restore
CSV (Comma Separated Values) Support
@tutorial_1010_a
Command Line Tools
Upgrade, Backup, and Restore
@tutorial_1011_a
Using OpenOffice Base
Command Line Tools
@tutorial_1012_a
Java Web Start / JNLP
Using OpenOffice Base
@tutorial_1013_a
Using a Connection Pool
Java Web Start / JNLP
@tutorial_1014_a
Fulltext Search
Using a Connection Pool
@tutorial_1015_a
User-Defined Variables
Fulltext Search
@tutorial_1016_a
User-Defined Variables
@tutorial_1017_a
Date and Time
@tutorial_1017_h2
@tutorial_1018_h2
Starting and Using the H2 Console
@tutorial_1018_p
@tutorial_1019_p
This application lets you access a SQL database using a browser interface. This can be a H2 database, or another database that supports the JDBC API.
@tutorial_1019_p
@tutorial_1020_p
This is a client / server application, so both a server and a client (a browser) are required to run it.
@tutorial_1020_p
@tutorial_1021_p
Depending on your platform and environment, there are multiple ways to start the application:
@tutorial_1021_th
@tutorial_1022_th
OS
@tutorial_1022_th
@tutorial_1023_th
Start
@tutorial_1023_td
@tutorial_1024_td
Windows
@tutorial_1024_td
@tutorial_1025_td
Click [Start], [All Programs], [H2], and [H2 Console (Command Line)]
@tutorial_1025_td
@tutorial_1026_td
When using the Sun JDK 1.4 or 1.5, a window with the title 'H2 Console ' should appear. When using the Sun JDK 1.6, an icon will be added to the system tray:
@tutorial_1026_td
@tutorial_1027_td
If you don't get the window and the system tray icon, then maybe Java is not installed correctly (in this case, try another way to start the application). A browser window should open and point to the Login page http://localhost:8082).
@tutorial_1027_td
@tutorial_1028_td
Windows
@tutorial_1028_td
@tutorial_1029_td
Open a file browser, navigate to h2/bin, and double click on h2.bat.
@tutorial_1029_td
@tutorial_1030_td
A console window appears. If there is a problem, you will see an error message in this window. A browser window will open and point to the Login page (URL: http://localhost:8082).
@tutorial_1030_td
@tutorial_1031_td
Any
@tutorial_1031_td
@tutorial_1032_td
Open a console window, navigate to the directory 'h2/bin' and type:
@tutorial_1032_h3
@tutorial_1033_h3
Firewall
@tutorial_1033_p
@tutorial_1034_p
If you start the server, you may get a security warning from the firewall (if you have installed one). If you don't want other computers in the network to access the application on your machine, you can let the firewall block those connections. The connection from the local machine will still work. Only if you want other computers to access the database on this computer, you need allow remote connections in the firewall.
@tutorial_1034_p
@tutorial_1035_p
A small firewall is already built into the server: other computers may not connect to the server by default. To change this, go to 'Preferences' and select 'Allow connections from other computers'.
@tutorial_1035_h3
@tutorial_1036_h3
Native Version
@tutorial_1036_p
@tutorial_1037_p
The native version does not require Java, because it is compiled using GCJ. However H2 does currently not run stable with GCJ on Windows It is possible to compile the software to different platforms.
@tutorial_1037_h3
@tutorial_1038_h3
Testing Java
@tutorial_1038_p
@tutorial_1039_p
To check the Java version you have installed, open a command prompt and type:
@tutorial_1039_p
@tutorial_1040_p
If you get an error message, you may need to add the Java binary directory to the path environment variable.
@tutorial_1040_h3
@tutorial_1041_h3
Error Message 'Port is in use'
@tutorial_1041_p
@tutorial_1042_p
You can only start one instance of the H2 Console, otherwise you will get the following error message: <code>Port is in use, maybe another ... server already running on...</code> . It is possible to start multiple console applications on the same computer (using different ports), but this is usually not required as the console supports multiple concurrent connections.
@tutorial_1042_h3
@tutorial_1043_h3
Using another Port
@tutorial_1043_p
@tutorial_1044_p
If the port is in use by another application, you may want to start the H2 Console on a different port. This can be done by changing the port in the file .h2.server.properties. This file is stored in the user directory (for Windows, this is usually in "Documents and Settings/&lt;username&gt;"). The relevant entry is webPort.
@tutorial_1044_h3
@tutorial_1045_h3
Starting Successfully
@tutorial_1045_p
@tutorial_1046_p
If starting the server from a console window was successful, a new window will open and display the following text:
@tutorial_1046_p
@tutorial_1047_p
Don't click inside this window; otherwise you might block the application (if you have the Fast-Edit mode enabled).
@tutorial_1047_h3
@tutorial_1048_h3
Connecting to the Server using a Browser
@tutorial_1048_p
@tutorial_1049_p
If the server started successfully, you can connect to it using a web browser. The browser needs to support JavaScript, frames and cascading stylesheets (css). If you started the server on the same computer as the browser, go to http://localhost:8082 in the browser. If you want to connect to the application from another computer, you need to provide the IP address of the server, for example: <a href="http://192.168.0.2:8082">http://192.168.0.2:8082</a> . If you enabled SSL on the server side, the URL needs to start with HTTPS.
@tutorial_1049_h3
@tutorial_1050_h3
Multiple Concurrent Sessions
@tutorial_1050_p
@tutorial_1051_p
Multiple concurrent browser sessions are supported. As that the database objects reside on the server, the amount of concurrent work is limited by the memory available to the server application.
@tutorial_1051_h3
Application Properties
@tutorial_1052_p
Starting the server will create a configuration file in you local home directory called <code>.h2.server.properties</code> . For Windows installations, this file will be in the directory <code>C:\Documents and Settings\[username]</code> . This file contains the settings of the application.
@tutorial_1053_h3
@tutorial_1052_h3
Login
@tutorial_1054_p
@tutorial_1053_p
At the login page, you need to provide connection information to connect to a database. Set the JDBC driver class of your database, the JDBC URL, user name and password. If you are done, click [Connect].
@tutorial_1055_p
@tutorial_1054_p
You can save and reuse previously saved settings. The settings are stored in the Application Properties file.
@tutorial_1056_h3
@tutorial_1055_h3
Error Messages
@tutorial_1057_p
@tutorial_1056_p
Error messages in are shown in red. You can show/hide the stack trace of the exception by clicking on the message.
@tutorial_1058_h3
@tutorial_1057_h3
Adding Database Drivers
@tutorial_1059_p
@tutorial_1058_p
Additional database drivers can be registered by adding the Jar file location of the driver to the environment variables H2DRIVERS or CLASSPATH. Example (Windows): To add the database driver library C:\Programs\hsqldb\lib\hsqldb.jar, set the environment variable H2DRIVERS to C:\Programs\hsqldb\lib\hsqldb.jar.
@tutorial_1060_p
@tutorial_1059_p
Multiple drivers can be set; each entry needs to be separated with a ';' (Windows) or ':' (other operating systems). Spaces in the path names are supported. The settings must not be quoted.
@tutorial_1061_h3
@tutorial_1060_h3
Using the Application
@tutorial_1062_p
@tutorial_1061_p
The application has three main panels, the toolbar on top, the tree on the left and the query / result panel on the right. The database objects (for example, tables) are listed on the left panel. Type in a SQL command on the query panel and click 'Run'. The result of the command appears just below the command.
@tutorial_1063_h3
@tutorial_1062_h3
Inserting Table Names or Column Names
@tutorial_1064_p
@tutorial_1063_p
The table name and column names can be inserted in the script by clicking them in the tree. If you click on a table while the query is empty, a 'SELECT * FROM ...' is added as well. While typing a query, the table that was used is automatically expanded in the tree. For, example if you type 'SELECT * FROM TEST T WHERE T.' then the table TEST is automatically expanded in the tree.
@tutorial_1065_h3
@tutorial_1064_h3
Disconnecting and Stopping the Application
@tutorial_1066_p
@tutorial_1065_p
On the browser, click 'Disconnect' on the toolbar panel. You will be logged out of the database. However, the server is still running and ready to accept new sessions.
@tutorial_1067_p
@tutorial_1066_p
To stop the server, right click on the system tray icon and select [Exit]. If you don't have the icon (because you started it in another way), press [Ctrl]+[C] on the console where the server was started (Windows), or close the console window.
@tutorial_1068_h2
@tutorial_1067_h2
Settings of the H2 Console
@tutorial_1068_p
The settings of the H2 Console are stored in a configuration file called <code>.h2.server.properties</code> in you user home directory. For Windows installations, the user home directory is usually <code>C:\Documents and Settings\[username]</code> . The configuration file contains the settings of the application and is automatically created when the H2 Console is first started.
@tutorial_1069_h2
Connecting to a Database using JDBC
@tutorial_1069_p
@tutorial_1070_p
To connect to a database, a Java application first needs to load the database driver, and then get a connection. A simple way to do that is using the following code:
@tutorial_1070_p
@tutorial_1071_p
This code first loads the driver ( <code>Class.forName()</code> ) and then opens a connection (using <code>DriverManager.getConnection()</code> ). The driver name is <code>"org.h2.Driver"</code> in every case. The database URL always needs to start with <code>jdbc:h2:</code> to be recognized by this database. The second parameter in the <code>getConnection()</code> call is the user name ('sa' for System Administrator in this example). The third parameter is the password. Please note that in this database, user names are not case sensitive, but passwords are case sensitive.
@tutorial_1071_h2
@tutorial_1072_h2
Creating New Databases
@tutorial_1072_p
@tutorial_1073_p
By default, if the database specified in the URL does not yet exist, a new (empty) database is created automatically. The user that created the database automatically becomes the administrator of this database.
@tutorial_1073_h2
@tutorial_1074_h2
Using the Server
@tutorial_1074_p
@tutorial_1075_p
H2 currently supports three servers: a Web Server, a TCP Server and an ODBC Server. The servers can be started in different ways.
@tutorial_1075_h3
@tutorial_1076_h3
Starting the Server from Command Line
@tutorial_1076_p
@tutorial_1077_p
To start the Server from the command line with the default settings, run
@tutorial_1077_p
@tutorial_1078_p
This will start the Server with the default options. To get the list of options and default values, run
@tutorial_1078_p
@tutorial_1079_p
There are options available to use different ports, and start or not start parts of the Server and so on. For details, see the API documentation of the Server tool.
@tutorial_1079_h3
@tutorial_1080_h3
Connecting to the TCP Server
@tutorial_1080_p
@tutorial_1081_p
To remotely connect to a database using the TCP server, use the following driver and database URL:
@tutorial_1081_li
@tutorial_1082_li
JDBC driver class: org.h2.Driver
@tutorial_1082_li
@tutorial_1083_li
Database URL: jdbc:h2:tcp://localhost/~/test
@tutorial_1083_p
@tutorial_1084_p
For details about the database URL, see also in Features.
@tutorial_1084_h3
@tutorial_1085_h3
Starting the Server within an Application
@tutorial_1085_p
@tutorial_1086_p
It is also possible to start and stop a Server from within an application. Sample code:
@tutorial_1086_h3
@tutorial_1087_h3
Stopping a TCP Server from Another Process
@tutorial_1087_p
@tutorial_1088_p
The TCP Server can be stopped from another process. To stop the server from the command line, run:
@tutorial_1088_p
@tutorial_1089_p
To stop the server from a user application, use the following code:
@tutorial_1089_p
@tutorial_1090_p
This function will call System.exit on the server. This function should be called after all connections to the databases are closed to avoid recovery when the databases are opened the next time. To stop remote server, remote connections must be enabled on the server.
@tutorial_1090_h2
@tutorial_1091_h2
Using Hibernate
@tutorial_1091_p
@tutorial_1092_p
This database supports Hibernate version 3.1 and newer. You can use the HSQLDB Dialect, or the native H2 Dialect. Unfortunately the H2 Dialect included in Hibernate is buggy. A <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-3401">patch for Hibernate</a> has been submitted. The dialect for the newest version of Hibernate is also available at src/tools/org/hibernate/dialect/H2Dialect.java.txt. You can rename it to H2Dialect.java and include this as a patch in your application.
@tutorial_1092_h2
@tutorial_1093_h2
Using TopLink and Glassfish
@tutorial_1093_p
@tutorial_1094_p
To use H2 with Glassfish (or Sun AS), set the Datasource Classname to <code>org.h2.jdbcx.JdbcDataSource</code> . You can set this in the GUI at Application Server - Resources - JDBC - Connection Pools, or by editing the file <code>sun-resources.xml</code> : at element <code>jdbc-connection-pool</code> , set the attribute <code>datasource-classname</code> to <code>org.h2.jdbcx.JdbcDataSource</code> .
@tutorial_1094_p
@tutorial_1095_p
The H2 database is compatible with HSQLDB and PostgreSQL. To take advantage of H2 specific features, use the <code>H2Platform</code> . The source code of this platform is included in H2 at <code>src/tools/oracle/toplink/essentials/platform/database/DatabasePlatform.java.txt</code> . You will need to copy this file to your application, and rename it to .java. To enable it, change the following setting in persistence.xml:
@tutorial_1095_p
@tutorial_1096_p
In old versions of Glassfish, the property name is <code>toplink.platform.class.name</code> .
@tutorial_1096_h2
@tutorial_1097_h2
Using Databases in Web Applications
@tutorial_1097_p
@tutorial_1098_p
There are multiple ways to access a database from within web applications. Here are some examples if you use Tomcat or JBoss.
@tutorial_1098_h3
@tutorial_1099_h3
Embedded Mode
@tutorial_1099_p
@tutorial_1100_p
The (currently) simplest solution is to use the database in the embedded mode, that means open a connection in your application when it starts (a good solution is using a Servlet Listener, see below), or when a session starts. A database can be accessed from multiple sessions and applications at the same time, as long as they run in the same process. Most Servlet Containers (for example Tomcat) are just using one process, so this is not a problem (unless you run Tomcat in clustered mode). Tomcat uses multiple threads and multiple classloaders. If multiple applications access the same database at the same time, you need to put the database jar in the shared/lib or server/lib directory. It is a good idea to open the database when the web application starts, and close it when the web application stops. If using multiple applications, only one (any) of them needs to do that. In the application, an idea is to use one connection per Session, or even one connection per request (action). Those connections should be closed after use if possible (but it's not that bad if they don't get closed).
@tutorial_1100_h3
@tutorial_1101_h3
Server Mode
@tutorial_1101_p
@tutorial_1102_p
The server mode is similar, but it allows you to run the server in another process.
@tutorial_1102_h3
@tutorial_1103_h3
Using a Servlet Listener to Start and Stop a Database
@tutorial_1103_p
@tutorial_1104_p
Add the h2.jar file your web application, and add the following snippet to your web.xml file (after context-param and before filter):
@tutorial_1104_p
@tutorial_1105_p
For details on how to access the database, see the code DbStarter.java
@tutorial_1105_p
@tutorial_1106_p
By default the DbStarter listener opens an embedded connection using the database URL jdbc:h2:~/test and user name and password 'sa'. It can also start the TCP server, however this is disabled by default. To enable it, use the db.tcpServer parameter in web.xml. Here is the complete list of options. These options are set just after the display-name and description tag, but before any listener and filter tags:
@tutorial_1106_p
@tutorial_1107_p
When the web application is stopped, the database connection will be closed automatically. If the server is started within the DbStarter, it will also be stopped automatically when the web application is stopped.
@tutorial_1107_h3
@tutorial_1108_h3
Using the H2 Console Servlet
@tutorial_1108_p
@tutorial_1109_p
The H2 Console is a standalone application and includes its own web server, but it can be used as a servlet as well. To do that, include the the h2 jar file in your application, and add the following configuration to your web.xml:
@tutorial_1109_p
@tutorial_1110_p
For details, see also <code>src/tools/WEB-INF/web.xml</code> .
@tutorial_1110_p
@tutorial_1111_p
To create a web application that creates just the H2 Console, run the following command:
@tutorial_1111_h2
@tutorial_1112_h2
CSV (Comma Separated Values) Support
@tutorial_1112_p
@tutorial_1113_p
The CSV file support can be used inside the database using the functions CSVREAD and CSVWRITE, and the CSV library can be used outside the database as a standalone tool.
@tutorial_1113_h3
@tutorial_1114_h3
Writing a CSV File from Within a Database
@tutorial_1114_p
@tutorial_1115_p
The built-in function CSVWRITE can be used to create a CSV file from a query. Example:
@tutorial_1115_h3
@tutorial_1116_h3
Reading a CSV File from Within a Database
@tutorial_1116_p
@tutorial_1117_p
A CSV file can be read using the function CSVREAD. Example:
@tutorial_1117_h3
@tutorial_1118_h3
Writing a CSV File from a Java Application
@tutorial_1118_p
@tutorial_1119_p
The CSV tool can be used in a Java application even when not using a database at all. Example:
@tutorial_1119_h3
@tutorial_1120_h3
Reading a CSV File from a Java Application
@tutorial_1120_p
@tutorial_1121_p
It is possible to read a CSV file without opening a database. Example:
@tutorial_1121_h2
@tutorial_1122_h2
Upgrade, Backup, and Restore
@tutorial_1122_h3
@tutorial_1123_h3
Database Upgrade
@tutorial_1123_p
@tutorial_1124_p
The recommended way to upgrade from one version of the database engine to the next version is to create a backup of the database (in the form of a SQL script) using the old engine, and then execute the SQL script using the new engine.
@tutorial_1124_h3
@tutorial_1125_h3
Backup using the Script Tool
@tutorial_1125_p
@tutorial_1126_p
There are different ways to backup a database. For example, it is possible to copy the database files. However, this is not recommended while the database is in use. Also, the database files are not human readable and quite large. The recommended way to backup a database is to create a compressed SQL script file. This can be done using the Script tool:
@tutorial_1126_p
@tutorial_1127_p
It is also possible to use the SQL command SCRIPT to create the backup of the database. For more information about the options, see the SQL command SCRIPT. The backup can be done remotely, however the file will be created on the server side. The built in FTP server could be used to retrieve the file from the server.
@tutorial_1127_h3
@tutorial_1128_h3
Restore from a Script
@tutorial_1128_p
@tutorial_1129_p
To restore a database from a SQL script file, you can use the RunScript tool:
@tutorial_1129_p
@tutorial_1130_p
For more information about the options, see the SQL command RUNSCRIPT. The restore can be done remotely, however the file needs to be on the server side. The built in FTP server could be used to copy the file to the server. It is also possible to use the SQL command RUNSCRIPT to execute a SQL script. SQL script files may contain references to other script files, in the form of RUNSCRIPT commands. However, when using the server mode, the references script files need to be available on the server side.
@tutorial_1130_h3
@tutorial_1131_h3
Online Backup
@tutorial_1131_p
@tutorial_1132_p
The BACKUP SQL statement and the Backup tool both create a zip file with all database files. However, the contents of this file are not human readable. Other than the SCRIPT statement, the BACKUP statement does not lock the database objects, and therefore does not block other users. The resulting backup is transactionally consistent:
@tutorial_1132_p
@tutorial_1133_p
The Backup tool (org.h2.tools.Backup) can not be used to create a online backup; the database must not be in use while running this program.
@tutorial_1133_h2
@tutorial_1134_h2
Command Line Tools
@tutorial_1134_p
@tutorial_1135_p
This database comes with a number of command line tools. To get more information about a tool, start it with the parameter '-?', for example:
@tutorial_1135_p
@tutorial_1136_p
The command line tools are:
@tutorial_1136_b
@tutorial_1137_b
Backup
@tutorial_1137_li
@tutorial_1138_li
creates a backup of a database.
@tutorial_1138_b
@tutorial_1139_b
ChangeFileEncryption
@tutorial_1139_li
@tutorial_1140_li
allows changing the file encryption password or algorithm of a database.
@tutorial_1140_b
@tutorial_1141_b
Console
@tutorial_1141_li
@tutorial_1142_li
starts the browser based H2 Console.
@tutorial_1142_b
@tutorial_1143_b
ConvertTraceFile
@tutorial_1143_li
@tutorial_1144_li
converts a .trace.db file to a Java application and SQL script.
@tutorial_1144_b
@tutorial_1145_b
CreateCluster
@tutorial_1145_li
@tutorial_1146_li
creates a cluster from a standalone database.
@tutorial_1146_b
@tutorial_1147_b
DeleteDbFiles
@tutorial_1147_li
@tutorial_1148_li
deletes all files belonging to a database.
@tutorial_1148_b
@tutorial_1149_b
Script
@tutorial_1149_li
@tutorial_1150_li
allows converting a database to a SQL script for backup or migration.
@tutorial_1150_b
@tutorial_1151_b
Recover
@tutorial_1151_li
@tutorial_1152_li
helps recovering a corrupted database.
@tutorial_1152_b
@tutorial_1153_b
Restore
@tutorial_1153_li
@tutorial_1154_li
restores a backup of a database.
@tutorial_1154_b
@tutorial_1155_b
RunScript
@tutorial_1155_li
@tutorial_1156_li
runs a SQL script against a database.
@tutorial_1156_b
@tutorial_1157_b
Server
@tutorial_1157_li
@tutorial_1158_li
is used in the server mode to start a H2 server.
@tutorial_1158_b
@tutorial_1159_b
Shell
@tutorial_1159_li
@tutorial_1160_li
is a command line database tool.
@tutorial_1160_p
@tutorial_1161_p
The tools can also be called from an application by calling the main or another public methods. For details, see the Javadoc documentation.
@tutorial_1161_h2
@tutorial_1162_h2
Using OpenOffice Base
@tutorial_1162_p
@tutorial_1163_p
OpenOffice.org Base supports database access over the JDBC API. To connect to a H2 database using OpenOffice Base, you first need to add the JDBC driver to OpenOffice. The steps to connect to a H2 database are:
@tutorial_1163_li
@tutorial_1164_li
Start OpenOffice Writer, go to [Tools], [Options]
@tutorial_1164_li
@tutorial_1165_li
Make sure you have selected a Java runtime environment in OpenOffice.org / Java
@tutorial_1165_li
@tutorial_1166_li
Click [Class Path...], [Add Archive...]
@tutorial_1166_li
@tutorial_1167_li
Select your h2.jar (location is up to you, could be wherever you choose)
@tutorial_1167_li
@tutorial_1168_li
Click [OK] (as much as needed), stop OpenOffice (including the Quickstarter)
@tutorial_1168_li
@tutorial_1169_li
Start OpenOffice Base
@tutorial_1169_li
@tutorial_1170_li
Connect to an existing database; select JDBC; [Next]
@tutorial_1170_li
@tutorial_1171_li
Example datasource URL: jdbc:h2:~/test
@tutorial_1171_li
@tutorial_1172_li
JDBC driver class: org.h2.Driver
@tutorial_1172_p
@tutorial_1173_p
Now you can access the database stored in the current users home directory.
@tutorial_1173_p
@tutorial_1174_p
To use H2 in NeoOffice (OpenOffice without X11):
@tutorial_1174_li
@tutorial_1175_li
In NeoOffice, go to [NeoOffice], [Preferences]
@tutorial_1175_li
@tutorial_1176_li
Look for the page under [NeoOffice], [Java]
@tutorial_1176_li
@tutorial_1177_li
Click [Classpath], [Add Archive...]
@tutorial_1177_li
@tutorial_1178_li
Select your h2.jar (location is up to you, could be wherever you choose)
@tutorial_1178_li
@tutorial_1179_li
Click [OK] (as much as needed), restart NeoOffice.
@tutorial_1179_p
@tutorial_1180_p
Now, when creating a new database using the "Database Wizard":
@tutorial_1180_li
@tutorial_1181_li
Select "connect to existing database" and the type "jdbc". Click next.
@tutorial_1181_li
@tutorial_1182_li
Enter your h2 database URL. The normal behavior of H2 is that a new db is created if it doesn't exist.
@tutorial_1182_li
@tutorial_1183_li
Next step - up to you... you can just click finish and start working.
@tutorial_1183_p
@tutorial_1184_p
Another solution to use H2 in NeoOffice is:
@tutorial_1184_li
@tutorial_1185_li
Package the h2 jar within an extension package
@tutorial_1185_li
@tutorial_1186_li
Install it as a Java extension in NeoOffice
@tutorial_1186_p
@tutorial_1187_p
This can be done by create it using the NetBeans OpenOffice plugin. See also <a href="http://wiki.services.openoffice.org/wiki/Extensions_development_java">Extensions Development</a> .
@tutorial_1187_h2
@tutorial_1188_h2
Java Web Start / JNLP
@tutorial_1188_p
@tutorial_1189_p
When using Java Web Start / JNLP (Java Network Launch Protocol), permissions tags must be set in the .jnlp file, and the application .jar file must be signed. Otherwise, when trying to write to the file system, the following exception will occur: java.security.AccessControlException: access denied (java.io.FilePermission ... read). Example permission tags:
@tutorial_1189_h2
@tutorial_1190_h2
Using a Connection Pool
@tutorial_1190_p
@tutorial_1191_p
For many databases, opening a connection is slow, and it is a good idea to use a connection pool to re-use connections. For H2 however opening a connection usually is fast if the database is already open. Using a connection pool for H2 actually slows down the process a bit, except if file encryption is used (in this case opening a connection is about half as fast as using a connection pool). A simple connection pool is included in H2. It is based on the <a href="http://www.source-code.biz/snippets/java/8.htm">Mini Connection Pool Manager</a> from Christian d'Heureuse. There are other, more complex connection pools available, for example <a href="http://jakarta.apache.org/commons/dbcp/">DBCP</a> . The build-in connection pool is used as follows:
@tutorial_1191_h2
@tutorial_1192_h2
Fulltext Search
@tutorial_1192_p
@tutorial_1193_p
H2 supports Lucene full text search and native full text search implementation.
@tutorial_1193_h3
@tutorial_1194_h3
Using the Native Full Text Search
@tutorial_1194_p
@tutorial_1195_p
To initialize, call:
@tutorial_1195_p
@tutorial_1196_p
You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using:
@tutorial_1196_p
@tutorial_1197_p
PUBLIC is the schema, TEST is the table name. The list of column names (column separated) is optional, in this case all columns are indexed. The index is updated in read time. To search the index, use the following query:
@tutorial_1197_p
@tutorial_1198_p
You can also call the index from within a Java application:
@tutorial_1198_h3
@tutorial_1199_h3
Using the Lucene Fulltext Search
@tutorial_1199_p
@tutorial_1200_p
To use the Lucene full text search, you need the Lucene library in the classpath. How his is done depends on the application; if you use the H2 Console, you can add the Lucene jar file to the environment variables H2DRIVERS or CLASSPATH. To initialize the Lucene full text search in a database, call:
@tutorial_1200_p
@tutorial_1201_p
You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using:
@tutorial_1201_p
@tutorial_1202_p
PUBLIC is the schema, TEST is the table name. The list of column names (column separated) is optional, in this case all columns are indexed. The index is updated in read time. To search the index, use the following query:
@tutorial_1202_p
@tutorial_1203_p
You can also call the index from within a Java application:
@tutorial_1203_h2
@tutorial_1204_h2
User-Defined Variables
@tutorial_1204_p
@tutorial_1205_p
This database supports user-defined variables. Variables start with @ and can be used wherever expressions or parameters are used. Variables not persisted and session scoped, that means only visible for the session where they are defined. A value is usually assigned using the SET command:
@tutorial_1205_p
@tutorial_1206_p
It is also possible to change a value using the SET() method. This is useful in queries:
@tutorial_1206_p
@tutorial_1207_p
Variables that are not set evaluate to NULL. The data type of a user-defined variable is the data type of the value assigned to it, that means it is not necessary (or possible) to declare variable names before using them. There are no restrictions on the assigned values; large objects (LOBs) are supported as well.
@tutorial_1207_h2
@tutorial_1208_h2
Date and Time
@tutorial_1208_p
@tutorial_1209_p
Date, time and timestamp values support ISO 8601 formatting, including time zone:
@tutorial_1209_p
@tutorial_1210_p
If the time zone is not set, the value is parsed using the current time zone setting of the system. Date and time information is stored in H2 database files in GMT (Greenwich Mean Time). If the database is opened using another system time zone, the date and time will change accordingly. If you want to move a database from one time zone to the other and don't want this to happen, you need to create a SQL script file using the SCRIPT command or Script tool, and then load the database using the RUNSCRIPT command or the RunScript tool in the new time zone.
h2/src/docsrc/text/_docs_ja.utf8.txt
浏览文件 @ adf661ad
......@@ -1129,963 +1129,975 @@ Centralリポジトリの利用
#Next Version (unreleased)
@changelog_1002_li
#-
#The database now tries to detect if the classloader or virtual machine has almost shut down by checking if static final variables are set to null.
@changelog_1003_h2
#Version 1.1.103 (2008-11-07)
@changelog_1003_li
#Compatibility for MS SQL Server DATEDIFF(YYYY, .., ..)
@changelog_1004_li
#Could not order by a formula when the formula was in the group by list but not in the select list.
#ResultSet.getObject for CLOB or BLOB will return a java.sql.Clob / java.sql.Blob object instead of a java.io.Reader / java.io.InputStream as in version 1.0. This behavior can be changed using the system property h2.returnLobObjects (true by default for version 1.1).
@changelog_1005_li
#Date values that match the daylight saving time end were not allowed in times zones were the daylight saving time ends at midnight, for years larger than 2037. Example: timezone Brasilia, date 2042-10-12. This is a problem of Java, however a workaround is implemented in H2 that solves most problems (except the problems of java.util.Date itself).
#The interface CloseListener has a new method 'remove' that is called when the trigger is dropped.
@changelog_1006_li
#Fulltext search: there was a memory leak when creating and dropping fulltext indexes in a loop.
@changelog_1007_h2
#Version 1.1.103 (2008-11-07)
@changelog_1008_li
#Could not order by a formula when the formula was in the group by list but not in the select list.
@changelog_1009_li
#Date values that match the daylight saving time end were not allowed in times zones were the daylight saving time ends at midnight, for years larger than 2037. Example: timezone Brasilia, date 2042-10-12. This is a problem of Java, however a workaround is implemented in H2 that solves most problems (except the problems of java.util.Date itself).
@changelog_1010_li
#ALTER TABLE used a lot of memory when using multi-version concurrency.
@changelog_1007_li
@changelog_1011_li
#Referential integrity for in-memory databases didn't work in some cases in version 1.1.102.
@changelog_1008_li
@changelog_1012_li
#New column INFORMATION_SCHEMA.COLUMNS.SEQUENCE_NAME to get the name of the sequence for auto-increment columns.
@changelog_1009_li
@changelog_1013_li
#Aliases for built-in data types (such as MEDIUMBLOB which is an alias for BLOB) can now be re-mapped to another data type using CREATE DOMAIN. However main built-in data types (such as INTEGER) can not be re-mapped.
@changelog_1010_li
@changelog_1014_li
#The Japanese translation has been completed by Masahiro Ikemoto. Thanks a lot!
@changelog_1011_li
@changelog_1015_li
#Improved PostgreSQL compatibility for NEXTVAL and CURRVAL.
@changelog_1012_li
@changelog_1016_li
#Less heap memory is needed when multiple databases are open at the same time: The memory reserve (used to rollback after out of memory) is now global and no longer allocated for each database separately.
@changelog_1013_li
@changelog_1017_li
#New system property h2.browser to set the browser to use.
@changelog_1014_li
@changelog_1018_li
#To start the browser, java.awt.Desktop.browse is now used if available.
@changelog_1015_h2
@changelog_1019_h2
#Version 1.1.102 (2008-10-24)
@changelog_1016_li
@changelog_1020_li
#The French translation of the H2 Console has been improved by Olivier Parent. Thanks a lot!
@changelog_1017_li
@changelog_1021_li
#There was a memory leak when creating and dropping tables and indexes in a loop (persistent database only).
@changelog_1018_li
@changelog_1022_li
#SET LOG 2 was not effective if executed after opening the database.
@changelog_1019_li
@changelog_1023_li
#Translating the H2 Console is now simpler.
@changelog_1020_li
@changelog_1024_li
#Common exception (error code 23*) are no longer written to the .trace.db file by default.
@changelog_1021_li
@changelog_1025_li
#In-memory databases don't write LOBs to files any longer.
@changelog_1022_li
@changelog_1026_li
#Self referencing constraints didn't restrict deleting rows that reference itself if there is another row that references it.
@changelog_1023_li
@changelog_1027_li
#ResultSetMetaData.getColumnName now returns the alias name except for columns.
@changelog_1024_li
@changelog_1028_li
#Temporary files are now deleted when the database is closed, even if they were not garbage collected so far.
@changelog_1025_h2
@changelog_1029_h2
#Version 1.1.101 (2008-10-17)
@changelog_1026_li
@changelog_1030_li
#Errors with code 42000 - 42999 are no longer written to the trace file by default.
@changelog_1027_li
@changelog_1031_li
#Queries with more than 10 tables are now faster.
@changelog_1028_li
@changelog_1032_li
#Opening a connection with AUTO_SERVER=TRUE is now fast when the database is already open in another process (less than 0.01 seconds instead of 2 seconds).
@changelog_1029_li
@changelog_1033_li
#IF [NOT] EXISTS is supported for named constraints in ALTER TABLE ... ADD/DROP CONSTRAINT.
@changelog_1030_li
@changelog_1034_li
#The error messages have been translated to Spanish by Dario V. Fassi. Thanks a lot!
@changelog_1031_li
@changelog_1035_li
#Linked tables: the automatic connection sharing didn't work. Actually the system property h2.shareLinkedConnections was working in the opposite direction: it was disabled when set to true. Now it works as expected.
@changelog_1032_li
@changelog_1036_li
#Opening large database is now faster.
@changelog_1033_li
@changelog_1037_li
#New system property h2.socketConnectTimeout, the timeout in milliseconds to connect to a server. The default is 2000 (2 seconds).
@changelog_1034_li
@changelog_1038_li
#The wrong parameters were bound to subqueries with parameters, specially when using IN(SELECT ...) and IN(...).
@changelog_1035_li
@changelog_1039_li
#Unset parameters were not detected when the query was re-compiled.
@changelog_1036_li
@changelog_1040_li
#New functions ISO_YEAR, ISO_WEEK, ISO_DAY_OF_WEEK. Thanks a lot to Robert Rathsack for implementing those!
@changelog_1037_li
@changelog_1041_li
#The date functions DAYOFYEAR, DAYOFMONTH, DAYOFWEEK are now called DAY_OF_YEAR, DAY_OF_MONTH, DAY_OF_WEEK (the old names still work).
@changelog_1038_li
@changelog_1042_li
#An out of memory error while deleting or updating many rows could result in a strange exception.
@changelog_1039_li
@changelog_1043_li
#Linked tables: compatibility with MS SQL Server has been improved.
@changelog_1040_li
@changelog_1044_li
#Renaming tables that have foreign keys with cascade didn't work correctly.
@changelog_1041_li
@changelog_1045_li
#The auto-reconnect feature didn't work when using the auto-server mode. Fixed.
@changelog_1042_li
@changelog_1046_li
#Fulltext search: new method FT_DROP_INDEX.
@changelog_1043_li
@changelog_1047_li
#The optimization to group using an index didn't work in some cases in version 1.1 (see also system property h2.optimizeGroupSorted).
@changelog_1044_li
@changelog_1048_li
#OSGi meta data is included in the manifest file. An OSGi BundleActivator is included: it loads the database driver when starting the bundle, and unloads it when stopping the bundle.
@changelog_1045_li
@changelog_1049_li
#The default value for MAX_MEMORY_UNDO is now 50000.
@changelog_1046_li
@changelog_1050_li
#For alias columns, ResultSetMetaData.getTableName() and getColumnName() now return the real table and column name in the default mode.
@changelog_1047_li
@changelog_1051_li
#In SQL scripts created with SCRIPT TO, schemas are now only created if they don't exist yet.
@changelog_1048_li
@changelog_1052_li
#After re-connecting to a database, the database event listener (if set) is informed about it.
@changelog_1049_li
@changelog_1053_li
#Local temporary tables now support indexes. Thanks a lot to Matt Roy!
@changelog_1050_li
@changelog_1054_li
#RUNSCRIPT no longer uses a temporary file.
@changelog_1051_li
@changelog_1055_li
#New system table INFORMATION_SCHEMA.SESSION_STATE containing the SQL statements that make up the session state. The list currently contains variables (SET @..) and local temporary tables (without data).
@changelog_1052_li
@changelog_1056_li
#After an automatic re-connect, part of the session state stays (the part that is stored in the SESSION_STATE table).
@changelog_1053_li
@changelog_1057_li
#The build didn't work if the directory temp didn't exist before.
@changelog_1054_li
@changelog_1058_li
#New system property h2.maxReconnect (default 3) to limit the number of re-connects for the same SQL statement (this is usually only important for SHUTDOWN).
@changelog_1055_li
@changelog_1059_li
#WHERE .. IN (SELECT ...) could throw a NullPointerException.
@changelog_1056_li
@changelog_1060_li
#Improved Glassfish / Toplink support in H2Platform thanks to Marcio Borges from Brazil. Thanks a lot!
@changelog_1057_h2
@changelog_1061_h2
#Version 1.1.100 (2008-10-04)
@changelog_1058_li
@changelog_1062_li
#In version 1.1, the following system properties are now enabled by default: h2.lobFilesInDirectories, h2.optimizeGroupSorted, h2.optimizeInJoin, h2.shareLinkedConnections
@changelog_1059_li
@changelog_1063_li
#The H2 Console tool now works with the JDBC-ODBC bridge.
@changelog_1060_li
@changelog_1064_li
#The H2 Console tool now supports command line options to start things separately.
@changelog_1061_li
@changelog_1065_li
#Large objects did not work for in-memory databases in server mode in Linux.
@changelog_1062_li
@changelog_1066_li
#Connections from a local address other than 'localhost' were not allowed if remote connections were disabled. This was always a problem, but only got visible in the last release because the server no longer connects to 'localhost' if networked.
@changelog_1063_li
@changelog_1067_li
#The h2console.war can now be built using the Java build.
@changelog_1064_li
@changelog_1068_li
#By default, databases are shared in the same process. For read-only databases this causes unnecessary synchronization, but safes memory. If you want that each connection opens its own database, append ;OPEN_NEW=TRUE to the database URL.
@changelog_1065_li
@changelog_1069_li
#New auto-reconnect feature will cause the JDBC driver to reconnect to the database if the connection is lost. To enable, append ;AUTO_RECONNECT=TRUE to the database URL. This is specially helpful when using AUTO_SERVER. AUTO_SERVER automatically uses auto-reconnect.
@changelog_1066_li
@changelog_1070_li
#CreateCluster: the property 'serverlist' is now called 'serverList'.
@changelog_1067_li
@changelog_1071_li
#The ConvertTraceFile tool could not parse some files because the trace mechanism did not encode prepared statement parameters.
@changelog_1068_li
@changelog_1072_li
#Databases names can now be one character long (the minimum size used to be 2 characters).
@changelog_1069_h2
@changelog_1073_h2
#Version 1.0.79 (2008-09-26)
@changelog_1070_li
@changelog_1074_li
#Linked tables that point to the same database can now share the connection within the same database. Access to the same connection is serialized. To enable this feature, set the system property h2.shareLinkedConnections to true.
@changelog_1071_li
@changelog_1075_li
#Multiple processes can now access the same database without having to explicitly start the server. To do that, append ;AUTO_SERVER=TRUE to the database URL. In this case, the server is started automatically if the connection is in embedded mode, and the server mode is used if a server is running. If the process that opened the first connection is closed, the other client need to reconnect (there is no automatic re-connect so far). Remote connections are allowed, but only to this database.
@changelog_1072_li
@changelog_1076_li
#The server tool now displays the correct IP address if networked.
@changelog_1073_li
@changelog_1077_li
#Can now start a TCP server with port 0 (automatically select a port).
@changelog_1074_li
@changelog_1078_li
#Result sets with just a unique index can now be updated (previously a primary key was required).
@changelog_1075_li
@changelog_1079_li
#LINKED TABLE: the schema name can now be set. When multiple tables exist in different schema, and the schema name is not set, an exception is thrown.
@changelog_1076_li
@changelog_1080_li
#LINKED TABLE: worked around a bug in Oracle with the CHAR data type.
@changelog_1077_li
@changelog_1081_li
#Faster hash code calculation for large binary arrays.
@changelog_1078_li
@changelog_1082_li
#Faster storage re-use algorithm thanks to Greg Dhuse from cleversafe.com.
@changelog_1079_li
@changelog_1083_li
#The database supports the SHOW command for better MySQL and PostgreSQL compatibility.
@changelog_1080_li
@changelog_1084_li
#The H2 Console now abbreviates large texts in results.
@changelog_1081_li
@changelog_1085_li
#Multiple UNION queries could not be used in derived tables.
@changelog_1082_li
@changelog_1086_li
#Linked tables can now be read-only.
@changelog_1083_li
@changelog_1087_li
#Temporary linked tables are now supported.
@changelog_1084_li
@changelog_1088_li
#It was possible to create tables in read-only databases.
@changelog_1085_li
@changelog_1089_li
#SET SCHEMA_SEARCH_PATH is now documented.
@changelog_1086_li
@changelog_1090_li
#SET SCHEMA did not work for views.
@changelog_1087_li
@changelog_1091_li
#Row level locking for MVCC is now enabled. The exception 'Concurrent update in table ...' is still thrown, but only after the lock timeout.
@changelog_1088_li
@changelog_1092_li
#The maximum log file size setting was ignored for large databases.
@changelog_1089_li
@changelog_1093_li
#Multi-Version Concurrency (MVCC) may no longer be used when using the multi-threaded kernel feature (MULTI_THREADED). An exception is thrown when trying to connect with both settings. Additional synchronization is required before those features can be used together.
@changelog_1090_li
@changelog_1094_li
#The data type JAVA_OBJECT could not be used in updatable result sets.
@changelog_1091_li
@changelog_1095_li
#The system property h2.optimizeInJoin did not work correctly.
@changelog_1092_li
@changelog_1096_li
#Conditions such as ID=? AND ID>? were slow.
@changelog_1093_h2
@changelog_1097_h2
#Version 1.0.78 (2008-08-28)
@changelog_1094_li
@changelog_1098_li
#The documentation no longer uses a frameset (except the Javadocs).
@changelog_1095_li
@changelog_1099_li
#When using DB_CLOSE_DELAY, sometimes a NullPointerException is thrown when the database is opened almost at the same time as it is closed automatically. Thanks a lot to Dmitry Pekar for finding this!
@changelog_1096_li
@changelog_1100_li
#Java methods with variable number of parameters can now be used (for Java 1.5 or newer).
@changelog_1097_li
@changelog_1101_li
#The Japanese translation has been improved by Masahiro Ikemoto. Thanks a lot!
@changelog_1098_li
@changelog_1102_li
#The H2 Console replaced an empty user name with a single space.
@changelog_1099_li
@changelog_1103_li
#The build target 'build jarSmall' now includes the embedded database.
@changelog_1100_li
@changelog_1104_li
#JdbcDataSource now keeps the password in a char array where possible.
@changelog_1101_li
@changelog_1105_li
#ResultSet.absolute did not always work with large result sets.
@changelog_1102_li
@changelog_1106_li
#Column aliases can now be used in GROUP BY and HAVING.
@changelog_1103_li
@changelog_1107_li
#Jason Brittain has contributed MySQL date functions. Thanks a lot! They are not in the h2.jar file currently, but in src/tools/org/h2/mode/FunctionsMySQL.java. To install, add this class to the classpath and call FunctionsMySQL.register(conn) in the Java code.
@changelog_1104_h2
@changelog_1108_h2
#Version 1.0.77 (2008-08-16)
@changelog_1105_li
@changelog_1109_li
#JaQu is now using prepared statements and supports Date, Time, Timestamp.
@changelog_1106_li
@changelog_1110_li
#When using remote in-memory databases, large LOB objects did not work.
@changelog_1107_li
@changelog_1111_li
#Timestamp columns such as TIMESTAMP(6) were not compatible to other database.
@changelog_1108_li
@changelog_1112_li
#Opening a large database was slow if there was a problem opening the previous time.
@changelog_1109_li
@changelog_1113_li
#NOT IN(SELECT ...) was incorrect if the subquery returns no rows.
@changelog_1110_li
@changelog_1114_li
#CREATE TABLE AS SELECT did not work correctly in the multi-version concurrency mode.
@changelog_1111_li
@changelog_1115_li
#Support a comma before closing a list, as in: create table test(id int,)
@changelog_1112_li
@changelog_1116_li
#MySQL compatibility: linked tables had lower case column names on some systems.
@changelog_1113_li
@changelog_1117_li
#DB2 compatibility: the DB2 fetch-first-clause is supported.
@changelog_1114_li
@changelog_1118_li
#Oracle compatibility: old style outer join syntax using (+) did work correctly sometimes.
@changelog_1115_li
@changelog_1119_li
#ResultSet.setFetchSize is now supported.
@changelog_1116_li
@changelog_1120_li
#It has been reported that when using Install4j on some Linux systems and enabling the 'pack200' option, the h2.jar becomes corrupted by the install process, causing application failure. A workaround is to add an empty file h2.jar.nopack next to the h2.jar file. The reason for this problem is not known.
@changelog_1117_h2
@changelog_1121_h2
#Version 1.0.76 (2008-07-27)
@changelog_1118_li
@changelog_1122_li
#The comment of a domain (user defined data type) is now used as the default column comment when creating a column with this domain.
@changelog_1119_li
@changelog_1123_li
#Invalid database names are now detected and a better error message is thrown.
@changelog_1120_li
@changelog_1124_li
#ResultSetMetaData.getColumnClassName now returns the correct class name for BLOB and CLOB.
@changelog_1121_li
@changelog_1125_li
#Fixed the Oracle mode: Oracle allows multiple rows only where all columns of the unique index are NULL.
@changelog_1122_li
@changelog_1126_li
#There is a problem with Hibernate when using Boolean columns. A patch for Hibernate has been submitted at http://opensource.atlassian.com/projects/hibernate/browse/HHH-3401
@changelog_1123_li
@changelog_1127_li
#ORDER BY on tableName.columnName didn't work correctly if the column name was also used as an alias.
@changelog_1124_li
@changelog_1128_li
#H2 Console: The progress display when opening a database has been improved.
@changelog_1125_li
@changelog_1129_li
#The error message when the server doesn't start has been improved.
@changelog_1126_li
@changelog_1130_li
#Key values can now be changed in updatable result sets.
@changelog_1127_li
@changelog_1131_li
#Changes in updatable result sets are now visible even when resetting the result set.
@changelog_1128_li
@changelog_1132_li
#Temporary files were sometimes deleted too late when executing large insert, update, or delete operations.
@changelog_1129_li
@changelog_1133_li
#The database file was growing after deleting many rows, and after large update operations.
@changelog_1130_h2
@changelog_1134_h2
#Version 1.0.75 (2008-07-14)
@changelog_1131_li
@changelog_1135_li
#Multi version concurrency (MVCC): when a row was updated or deleted, but this change was rolled back, the row was not visible by other sessions if no index was used to access it. Fixed.
@changelog_1132_li
@changelog_1136_li
#Views with multiple joined tables (where one was an outer join) couldn't be used in some cases. Fixed.
@changelog_1133_li
@changelog_1137_li
#The CSVREAD method did not process NULL correctly when using a whitespace field separator.
@changelog_1134_li
@changelog_1138_li
#Fixed the Oracle mode: Oracle allows multiple rows with NULL in a unique index.
@changelog_1135_li
@changelog_1139_li
#Running out of memory could result in incomplete transactions or corrupted databases. Fixed.
@changelog_1136_li
@changelog_1140_li
#When using order by in a query that uses the same table multiple times, the order could be incorrect. Fixed.
@changelog_1137_li
@changelog_1141_li
#Referential constraint checking improvement: now the constraint is only checked if the key column values change.
@changelog_1138_li
@changelog_1142_li
#Some database metadata calls returned the wrong data type for DATA_TYPE columns.
@changelog_1139_li
@changelog_1143_li
#The Lucene fulltext index was empty when opening a database with fulltext index enabled, and re-indexing it didn't work. Fixed.
@changelog_1140_li
@changelog_1144_li
#The character '$' could not be used in identifier names (table name, column names and so on). Fixed.
@changelog_1141_li
@changelog_1145_li
#The new method org.h2.tools.Server.startWebServer(conn) starts the H2 Console to inspect a database while debugging.
@changelog_1142_li
@changelog_1146_li
#Stopping a WebServer didn't always work. Fixed.
@changelog_1143_h2
@changelog_1147_h2
#Version 1.0.74 (2008-06-21)
@changelog_1144_li
@changelog_1148_li
#Work on row level locking has been started (but there is nothing usable yet).
@changelog_1145_li
@changelog_1149_li
#JaQu (Java Query), a tool similar to LINQ (Language Integrated Query; from Microsoft) is now included under src/tools/org/h2/jaqu. A small sample application is included under src/test/org/h2/test/jaqu.
@changelog_1146_li
@changelog_1150_li
#The source code is now switched to Java 1.6 by default. To switch back to Java 1.4, run 'build compile'. The h2.jar file is still Java 1.4.
@changelog_1147_li
@changelog_1151_li
#The ChangePassword tool is now called ChangeFileEncryption.
@changelog_1148_li
@changelog_1152_li
#It is no longer allowed to create columns with the data type NULL. Also, it is no longer allowed to convert a column to the data type NULL. This was possible before but caused data loss.
@changelog_1149_li
@changelog_1153_li
#When using computed columns or default values with a different data type than the column data type, a class cast exception could occur. Fixed.
@changelog_1150_li
@changelog_1154_li
#Opening databases larger than 1 GB was sometimes very slow if a lot of data was deleted previously. Fixed.
@changelog_1151_li
@changelog_1155_li
#RUNSCRIPT could throw a NullPointerException if the script name was an expression.
@changelog_1152_li
@changelog_1156_li
#Improved compatibility. New compatibility modes for Oracle and Derby. New compatibility flag uniqueIndexNullDistinct to only allow one row with 'NULL' in a unique index. This flag is enabled for Derby, Oracle, MSSQLServer, and HSQLDB.
@changelog_1153_li
@changelog_1157_li
#Linked tables: To view the statements that are executed against the target table, set the trace level to 3.
@changelog_1154_li
@changelog_1158_li
#RunScript tool: new options to show and check the results of queries.
@changelog_1155_li
@changelog_1159_li
#Deadlocks are now detected. One transaction is rolled back automatically.
@changelog_1156_li
@changelog_1160_li
#The Lucene fulltext index was always re-created when opening a database with fulltext index enabled.
@changelog_1157_li
@changelog_1161_li
#Support for overloaded Java methods. A user defined function can now be bound to multiple Java methods, if the Java methods have the same name but a different number of parameters. Thanks to Gary Tong for providing a patch!
@changelog_1158_h2
@changelog_1162_h2
#Version 1.0.73 (2008-05-31)
@changelog_1159_li
@changelog_1163_li
#ParameterMetaData now returns the right data type for most conditions, as in WHERE ID=?.
@changelog_1160_li
@changelog_1164_li
#The table SYSTEM_RANGE now supports expressions and parameters.
@changelog_1161_li
@changelog_1165_li
#New column INFORMATION_SCHEMA.CONSTRAINTS.UNIQUE_INDEX_NAME that contains the name of the unique index used to enforce this constraint, if there is such an index.
@changelog_1162_li
@changelog_1166_li
#SET QUERY_TIMEOUT and Statement.setQueryTimeout no longer commits a transaction. The same applies to SET @VARIABLE, SET LOCK_TIMEOUT, SET TRACE_LEVEL_*, SET THROTTLE, and SET PATH.
@changelog_1163_li
@changelog_1167_li
#The SCRIPT command does now emit IF NOT EXISTS for CREATE ROLE.
@changelog_1164_li
@changelog_1168_li
#MySQL compatibility: auto_increment column are no longer automatically converted to primary key columns.
@changelog_1165_li
@changelog_1169_li
#PostgreSQL compatibility: support for BOOL_OR and BOOL_AND aggregate functions.
@changelog_1166_li
@changelog_1170_li
#Negative scale values for DECIMAL or NUMBER columns are now supported in regular tables and in linked tables.
@changelog_1167_li
@changelog_1171_li
#A role or right can now be granted or revoked multiple times without getting an exception.
@changelog_1168_li
@changelog_1172_li
#Infinite numbers in SQL scripts are listed as POWER(0, -1)), negative infinite as (-POWER(0, -1)), and NaN (not a number) as SQRT(-1).
@changelog_1169_li
@changelog_1173_li
#The special double and float values 'NaN' (not a number) did not work correctly when sorting or comparing.
@changelog_1170_li
@changelog_1174_li
#The fulltext search did not support CLOB data types.
@changelog_1171_li
@changelog_1175_li
#If the drive with the database files was disconnected or unmounted while writing, sometimes a stack overflow exception was thrown instead of a IO exception.
@changelog_1172_li
@changelog_1176_li
#The H2 Console could not be shut down from within the tool if the browser supports keepAlive (most browsers do).
@changelog_1173_li
@changelog_1177_li
#If the password was passed as a char array, it was kept in an internal buffer longer than required. Theoretically the password could have been stolen if the main memory was swapped to disk before the garbage collection was run.
@changelog_1174_h2
@changelog_1178_h2
#Version 1.0.72 (2008-05-10)
@changelog_1175_li
@changelog_1179_li
#Some databases could not be opened when appending ;RECOVER=1 to the database URL.
@changelog_1176_li
@changelog_1180_li
#The Japanese translation of the error messages and the H2 Console has been completed by Masahiro Ikemoto (Arizona Design Inc.)
@changelog_1177_li
@changelog_1181_li
#Updates made to updatable rows are now visible within the same result set. DatabaseMetaData.ownUpdatesAreVisible now returns true.
@changelog_1178_li
@changelog_1182_li
#ParameterMetaData now returns the correct data for INSERT and UPDATE statements.
@changelog_1179_li
@changelog_1183_li
#H2 Shell: DESCRIBE now supports an schema name.
@changelog_1180_li
@changelog_1184_li
#A subset of the PostgreSQL 'dollar quoting' feature is now supported.
@changelog_1181_li
@changelog_1185_li
#SLF4J is now supported by using adding TRACE_LEVEL_FILE=4 to the database URL.
@changelog_1182_li
@changelog_1186_li
#The recovery tool did not work if the table name contained spaces or if there was a comment on the table.
@changelog_1183_li
@changelog_1187_li
#Triggers are no longer executed when changing the table structure (ALTER TABLE).
@changelog_1184_li
@changelog_1188_li
#When setting BLOB or CLOB values larger than 65 KB using a remote connection, temporary files were kept on the client longer than required (until the connection was closed or the object is garbage collected). Now they are removed as soon as the PreparedStatement is closed, or when the value is overwritten.
@changelog_1185_li
@changelog_1189_li
#Statements can now be canceled remotely (when using remote connections).
@changelog_1186_li
@changelog_1190_li
#The Shell tool now uses java.io.Console to read the password when using JDK 1.6
@changelog_1187_li
@changelog_1191_li
#When using read-only databases and setting LOG=2, an exception was written to the trace file when closing the database. Fixed.
@changelog_1188_h2
@changelog_1192_h2
#Version 1.0.71 (2008-04-25)
@changelog_1189_li
@changelog_1193_li
#H2 is now dual-licensed under the Eclipse Public License (EPL) and the old 'H2 License' (which is basically MPL).
@changelog_1190_li
@changelog_1194_li
#Sometimes an exception 'File ID mismatch' or 'try to add a record twice' occurred after large records (8 KB or larger) are updated or deleted. See also http://code.google.com/p/h2database/issues/detail?id=22
@changelog_1191_li
@changelog_1195_li
#H2 Console: The tools can now be translated (it didn't work in the last release).
@changelog_1192_li
@changelog_1196_li
#New traditional Chinese translation. Thanks a lot to Derek Chao!
@changelog_1193_li
@changelog_1197_li
#Indexes were not used when enabling the optimization for IN(SELECT...) (system property h2.optimizeInJoin).
@changelog_1194_h2
@changelog_1198_h2
#Version 1.0.70 (2008-04-20)
@changelog_1195_li
@changelog_1199_li
#The plan is to dual-license H2. The additional license is EPL (Eclipse Public License). The current license (MPL, Mozilla Public License) will stay. Current users are not affected because they can keep MPL. EPL is very similar to MPL, the only bigger difference is related to patents (EPL is a bit more business friendly in this regard). See also http://opensource.org/licenses/eclipse-1.0.php, http://www.eclipse.org/legal/eplfaq.php (FAQ), http://blogs.zdnet.com/Burnette/?p=131
@changelog_1196_li
@changelog_1200_li
#Multi version concurrency (MVCC): when a row was updated, and the updated column was not indexed, this update was visible sometimes for other sessions even if it was not committed.
@changelog_1197_li
@changelog_1201_li
#Calling SHUTDOWN on one connection and starting a query on another connection concurrently could result in a Java level deadlock.
@changelog_1198_li
@changelog_1202_li
#New system property h2.enableAnonymousSSL (default: true) to enable anonymous SSL connections.
@changelog_1199_li
@changelog_1203_li
#The precision if SUBSTR is now calculated if possible.
@changelog_1200_li
@changelog_1204_li
#The autocomplete in the H2 Console has been improved a bit.
@changelog_1201_li
@changelog_1205_li
#The tools in the H2 Console are now translatable.
@changelog_1202_li
@changelog_1206_li
#The servlet and lucene jar files are now automatically downloaded when building.
@changelog_1203_li
@changelog_1207_li
#The code switch tool has been replaced by a simpler tool called SwitchSource that just uses find and replace.
@changelog_1204_li
@changelog_1208_li
#Started to write a Ant replacement ('JAnt') that uses pure Java build definitions. Advantages: ability to debug the build, extensible, flexible, no XML, a bit faster. Future plan: support creating custom h2 distributions (for embedded use). Maybe create a new project 'Jant' or 'Javen' if other people are interested.
@changelog_1205_li
@changelog_1209_li
#The jar file is now about 10% smaller because the variable debugging info is no longer included. The source file and line number debugging info is still included. If required, the jar file size of the full version can be further reduced to about 720 KB using 'build jarSmall' or even more by removing unneeded components.
@changelog_1206_li
@changelog_1210_li
#Added shell scripts run.sh and build.sh. chmod +x is required, but otherwise it should work. Feedback or improvements are welcome!
@changelog_1207_li
@changelog_1211_li
#Databases in zip files: large queries are now supported. Temp files are created in the temp directory if required. The documentation how to create the zip file has been corrected.
@changelog_1208_li
@changelog_1212_li
#Invalid inline views threw confusing SQL exceptions.
@changelog_1209_li
@changelog_1213_li
#The Japanese translation of the error messages and the H2 Console has been improved. Thanks a lot to Masahiro IKEMOTO.
@changelog_1210_li
@changelog_1214_li
#Optimization for MIN() and MAX() when using MVCC.
@changelog_1211_li
@changelog_1215_li
#To protect against remote brute force password attacks, the delay after each unsuccessful login now gets double as long. New system properties h2.delayWrongPasswordMin and h2.delayWrongPasswordMax.
@changelog_1212_li
@changelog_1216_li
#After setting the query timeout and then resetting it, the next query would still timeout. Fixed.
@changelog_1213_li
@changelog_1217_li
#Adding a IDENTITY column to a table with data threw a lock timeout.
@changelog_1214_li
@changelog_1218_li
#OutOfMemoryError could occur when using EXISTS or IN(SELECT ..).
@changelog_1215_li
@changelog_1219_li
#The built-in connection pool is not called JdbcConnectionPool. The API and documentation has been changed.
@changelog_1216_li
@changelog_1220_li
#The ConvertTraceFile tool now generates SQL statement statistics at the end of the SQL script file (similar to the profiling data generated when using java -Xrunhprof).
@changelog_1217_li
@changelog_1221_li
#Nested joins are now supported (A JOIN B JOIN C ON .. ON ..)
@changelog_1218_h2
@changelog_1222_h2
#Version 1.0.69 (2008-03-29)
@changelog_1219_li
@changelog_1223_li
#Most command line tools can now be called from within the H2 Console.
@changelog_1220_li
@changelog_1224_li
#A new Shell tools is now included (org.h2.tools.Shell) to query a database from the command line.
@changelog_1221_li
@changelog_1225_li
#The command line options in the tools have changed: instead of '-log true' now '-trace' is used. Also, '-ifExists', '-tcpSSL' and '-tcpAllowOthers' and so on have changed: now the 'true' is no longer needed. The old behavior is still supported.
@changelog_1222_li
@changelog_1226_li
#New system property h2.sortNullsHigh to invert the default sorting behavior for NULL. The default didn't change.
@changelog_1223_li
@changelog_1227_li
#Performance was very slow when using LOG=2 and deleting or updating all rows of a table in a loop. Fixed.
@changelog_1224_li
@changelog_1228_li
#ALTER TABLE or CREATE TABLE now support parameters for the password field.
@changelog_1225_li
@changelog_1229_li
#The linear hash has been removed. It was always slower than the b-tree index, and there were some bugs that would be hard to fix.
@changelog_1226_li
@changelog_1230_li
#TRACE_LEVEL_ settings are no longer persistent. This was a problem when database initialization code caused a lot of trace output.
@changelog_1227_li
@changelog_1231_li
#Fulltext search (native implementation): The words table is no longer an in-memory table because this caused memory problems in some cases.
@changelog_1228_li
@changelog_1232_li
#It was possible to create a role with the name as an existing user (but not vice versa). This is not allowed any more.
@changelog_1229_li
@changelog_1233_li
#The recovery tool didn't work correctly for tables without rows.
@changelog_1230_li
@changelog_1234_li
#For years below 1, the YEAR method didn't return the correct value, and the conversion from date and timestamp to varchar was incorrect.
@changelog_1231_li
@changelog_1235_li
#CSVWRITE caused a NullPointerException when not specifying a nullString.
@changelog_1232_li
@changelog_1236_li
#When a log file switch occurred just after a truncate table or drop table statement, the database could not be started normally (RECOVER=1 was required). Fixed.
@changelog_1233_li
@changelog_1237_li
#When a log file switch occurred in the middle of a sequence flush (sequences are only flushed every 32 values by default), the sequence value was lost. Fixed.
@changelog_1234_li
@changelog_1238_li
#Altering a sequence didn't unlock the system table when autocommit switched off.
@changelog_1235_h2
@changelog_1239_h2
#Version 1.0.68 (2008-03-18)
@changelog_1236_li
@changelog_1240_li
#Very large SELECT DISTINCT and UNION EXCEPT queries are now supported, however this feature is disabled by default. To enable it, set the system property h2.maxMemoryRowsDistinct to a lower value, for example 10000.
@changelog_1237_li
@changelog_1241_li
#A error is now thrown when trying to call a method inside a trigger that implicitly commits the current transaction, if an object is locked.
@changelog_1238_li
@changelog_1242_li
#Unused LOB files were deleted much too late. Now they are deleted if no longer referenced in memory.
@changelog_1239_li
@changelog_1243_li
#ALTER SEQUENCE and ALTER TABLE ALTER COLUMN RESTART can now be used inside a transaction.
@changelog_1240_li
@changelog_1244_li
#New system property h2.aliasColumnName. When enabled, aliased columns (as in SELECT ID AS I FROM TEST) return the real table and column name in ResultSetMetaData.getTableName() and getColumnName(). This is disabled by default for compatibility with other databases (HSQLDB, Apache Derby, PostgreSQL, some version of MySQL). In version 1.1 this setting will be enabled.
@changelog_1241_li
@changelog_1245_li
#When using encrypted databases, and using the wrong file password, the log file was renamed if the database was not already open. Fixed.
@changelog_1242_li
@changelog_1246_li
#Improved performance when using lob files in directories (however this is still disabled by default)
@changelog_1243_li
@changelog_1247_li
#H2 Console: autocomplete didn't work with very large scripts. Fixed.
@changelog_1244_li
@changelog_1248_li
#Fulltext search: new method SEARCH_DATA that returns the column names and primary keys as arrays.
@changelog_1245_li
@changelog_1249_li
#New experimental optimization for GROUP BY queries if an index can be used that matches the group by columns. To enable this optimization, set the system property h2.optimizeGroupSorted to true.
@changelog_1246_li
@changelog_1250_li
#When using multi-version concurrency (MVCC=TRUE), duplicate rows could appear in the result set when running queries with uncommitted changes in the same session.
@changelog_1247_li
@changelog_1251_li
#H2 Console: remote connections were very slow because getHostName/getRemoteHost was used. Fixed (now using getHostAddress/getRemoteAddr.
@changelog_1248_li
@changelog_1252_li
#H2 Console: on Linux, Firefox, Konqueror, or Opera (in this order) are now started if available. This has been tested on Ubuntu.
@changelog_1249_li
@changelog_1253_li
#H2 Console: the start window works better with IKVM
@changelog_1250_li
@changelog_1254_li
#H2 Console: improved compatibility with Safari (Safari requires keep-alive)
@changelog_1251_li
@changelog_1255_li
#Random: the process didn't stop if generating the random seed using the standard way (SecureRandom.generateSeed) was very slow. Now using a daemon thread to avoid this problem.
@changelog_1252_li
@changelog_1256_li
#SELECT UNION with a different number of ORDER BY columns did throw an ArrayIndexOutOfBoundsException.
@changelog_1253_li
@changelog_1257_li
#When using a view, the column precision was changed to the default scale for some data types.
@changelog_1254_li
@changelog_1258_li
#CSVWRITE now supports a 'null string' that is used for parsing and writing NULL.
@changelog_1255_li
@changelog_1259_li
#Some long running queries could not be canceled.
@changelog_1256_li
@changelog_1260_li
#Queries with many outer join tables were very slow. Fixed.
@changelog_1257_li
@changelog_1261_li
#The performance of text comparison has been improved when using locale sensitive string comparison (SET COLLATOR). Now CollationKey is used with a LRU cache. The default cache size is 10000, and can be changed using the system property h2.collatorCacheSize. Use 0 to disable the cache.
@changelog_1258_li
@changelog_1262_li
#UPDATE SET column=DEFAULT is now supported.
@changelog_1259_h2
@changelog_1263_h2
#Version 1.0.67 (2008-02-22)
@changelog_1260_li
@changelog_1264_li
#New function FILE_READ to read a file or from an URL. Both binary and text data is supported.
@changelog_1261_li
@changelog_1265_li
#CREATE TABLE AS SELECT now supports specifying the column list and data types.
@changelog_1262_li
@changelog_1266_li
#Connecting to a TCP server and at shutting it down at the same time could cause a Java level deadlock.
@changelog_1263_li
@changelog_1267_li
#A user now has all rights on his own local temporary tables.
@changelog_1264_li
@changelog_1268_li
#The CSV tool now supports a custom lineSeparator.
@changelog_1265_li
@changelog_1269_li
#When using multiple connections, empty space was reused too early sometimes. This could corrupt the database when recovering.
@changelog_1266_li
@changelog_1270_li
#The H2 Console has been translated to Dutch. Thanks a lot to Remco Schoen!
@changelog_1267_li
@changelog_1271_li
#Databases can now be opened even if trigger classes are not in the classpath. The exception is thrown when trying to fire the trigger.
@changelog_1268_li
@changelog_1272_li
#Opening databases with ACCESS_MODE_DATA=r is now supported. In this case the database is read-only, but the files don't not need to be read-only.
@changelog_1269_li
@changelog_1273_li
#Security: The database now waits 200 ms before throwing an exception if the user name or password don't match, to slow down dictionary attacks.
@changelog_1270_li
@changelog_1274_li
#The value cache is now a soft reference cache. This should help save memory.
@changelog_1271_li
@changelog_1275_li
#CREATE INDEX on a table with many rows could run out of memory. Fixed.
@changelog_1272_li
@changelog_1276_li
#Large result sets are now a bit faster.
@changelog_1273_li
@changelog_1277_li
#ALTER TABLE ALTER COLUMN RESTART and ALTER SEQUENCE now support parameters (any expressions).
@changelog_1274_li
@changelog_1278_li
#When setting the base directory on the command line, the user directory prefix ('~') was ignored.
@changelog_1275_li
@changelog_1279_li
#The DbStarter servlet didn't start the TCP listener even if configured.
@changelog_1276_li
@changelog_1280_li
#Statement.setQueryTimeout() is now supported.
@changelog_1277_li
@changelog_1281_li
#New session setting QUERY_TIMEOUT, and new system property h2.maxQueryTimeout.
@changelog_1278_li
@changelog_1282_li
#Changing the transaction log level (SET LOG) is now written to the trace file by default.
@changelog_1279_li
@changelog_1283_li
#In a SQL script, primary key constraints are now ordered before foreign key constraints.
@changelog_1280_li
@changelog_1284_li
#It was not possible to create a referential constraint to a table in a different schema in some situations.
@changelog_1281_li
@changelog_1285_li
#The H2 Console was slow when the database contains many tables. Now the column names are not shown in this case.
@changelog_1282_h2
@changelog_1286_h2
#Version 1.0.66 (2008-02-02)
@changelog_1283_li
@changelog_1287_li
#There is a new online error analyzer tool.
@changelog_1284_li
@changelog_1288_li
#H2 Console: stack traces are now links to the source code in the source repository (H2 database only).
@changelog_1285_li
@changelog_1289_li
#CHAR data type equals comparison was case insensitive instead of case sensitive.
@changelog_1286_li
@changelog_1290_li
#The exception 'Value too long for column' now includes the data.
@changelog_1287_li
@changelog_1291_li
#The table name was missing in the documentation of CREATE INDEX.
@changelog_1288_li
@changelog_1292_li
#Better support for IKVM (www.ikvm.net): the H2 Console now opens a browser window.
@changelog_1289_li
@changelog_1293_li
#The cache size was not correctly calculated for tables with large objects (specially if compression is used). This could lead to out-of-memory exceptions.
@changelog_1290_li
@changelog_1294_li
#The exception "Hexadecimal string contains non-hex character" was not always thrown when it should have been. Fixed.
@changelog_1291_li
@changelog_1295_li
#The H2 Console now provides a link to the documentation when an error occurs (H2 databases only so far).
@changelog_1292_li
@changelog_1296_li
#The acting as PostgreSQL server, when a base directory was set, and the H2 Console was started as well, the base directory was applied twice.
@changelog_1293_li
@changelog_1297_li
#Calling EXTRACT(HOUR FROM ...) or EXTRACT(HH FROM ...) returned the wrong values (0 to 11 instead of 0 to 23). All other tested databases return values from 0 to 23. Please check if your application relies on the old behavior before upgrading.
@changelog_1294_li
@changelog_1298_li
#For compatibility with other databases the column default (COLUMN_DEF) for columns without default is now null (it was an empty string).
@changelog_1295_li
@changelog_1299_li
#Statements that contain very large subqueries (where the subquery result does not fit in memory) are now faster.
@changelog_1296_li
@changelog_1300_li
#Variables: large objects (CLOB and BLOB) that don't fit in memory did not work correctly when used as variables.
@changelog_1297_li
@changelog_1301_li
#Fulltext search is now supported in named in-memory databases.
@changelog_1298_li
@changelog_1302_li
#H2 Console: multiple consecutive spaces in the setting name did not work. Fixed.
@changelog_1299_h2
@changelog_1303_h2
#Version 1.0.65 (2008-01-18)
@changelog_1300_li
@changelog_1304_li
#The build (ant) now automatically switches the source code to the correct version (JDK 1.4/1.5 or 1.6).
@changelog_1301_li
@changelog_1305_li
#A recovery bug has been fixed. With older versions, it was necessary to add ;RECOVER=1 to the database URL in cases where it should not have been required.
@changelog_1302_li
@changelog_1306_li
#The performance for DROP and DROP ALL OBJECTS has been improved.
@changelog_1303_li
@changelog_1307_li
#The ChangePassword API has been improved.
@changelog_1304_li
@changelog_1308_li
#User defined variables are now supported. Examples: SET @VAR=10;CALL @VAR. This can be used for running totals as in: select x, set(@t, ifnull(@t, 0) + x) from system_range(1, 10)
@changelog_1305_li
@changelog_1309_li
#The Ukrainian translation has been improved.
@changelog_1306_li
@changelog_1310_li
#CALL statements can now be used in batch updates and called using Statement.executeUpdate.
@changelog_1307_li
@changelog_1311_li
#New read-only setting CREATE_BUILD (the build number of the database engine that created the database).
@changelog_1308_li
@changelog_1312_li
#The optimizer did not use multi column indexes for range queries in some cases. Fixed.
@changelog_1309_li
@changelog_1313_li
#The H2 Console now calls DataSource.getConnection() instead of DataSource.getConnection(user, password) when user name and password are not specified.
@changelog_1310_li
@changelog_1314_li
#The bind IP address can now be set when using multi-homed host (if multiple network adapters are available) using the system property h2.bindAddress.
@changelog_1311_li
@changelog_1315_li
#Batch update: Calling BatchUpdateException.printStackTrace() could result in out of memory. Fixed.
@changelog_1312_li
@changelog_1316_li
#Indexes of unique or foreign constraints where not dropped when the constraint was dropped after altering the table (for example dropping a column). Fixed.
@changelog_1313_li
@changelog_1317_li
#The performance for large result sets in the server mode has been improved.
@changelog_1314_li
@changelog_1318_li
#The setting h2.serverSmallResultSetSize has been renamed to h2.serverResultSetFetchSize.
@changelog_1315_li
@changelog_1319_li
#The SCRIPT command now uses multi-row insert statements to save space except if the option SIMPLE is used.
@changelog_1316_li
@changelog_1320_li
#The SCRIPT command did not split up CLOB data correctly. Fixed.
@changelog_1317_li
@changelog_1321_li
#Optimization for single column distinct queries with an index: select distinct name from test. Can be disabled by setting the system property h2.optimizeDistinct to false.
@changelog_1318_li
@changelog_1322_li
#DROP ALL OBJECTS did not drop user defined aggregate functions and domains.
@changelog_1319_li
@changelog_1323_li
#PostgreSQL compatibility: COUNT(T.*) is now supported.
@changelog_1320_li
@changelog_1324_li
#LIKE comparisons are now faster.
@changelog_1321_li
@changelog_1325_li
#Encrypted databases are now faster.
@download_1000_h1
......@@ -8073,13 +8085,16 @@ SQLコマンドがコマンドエリアに表示されます。
@roadmap_1354_li
#Avoid using java.util.Calendar internally because it's slow, complicated, and seems to be buggy.
@roadmap_1355_h2
@roadmap_1355_li
#Support TRUNCATE .. CASCADE like PostgreSQL.
@roadmap_1356_h2
#Not Planned
@roadmap_1356_li
@roadmap_1357_li
#HSQLDB (did) support this: select id i from test where i>0 (other databases don't). Supporting it may break compatibility.
@roadmap_1357_li
@roadmap_1358_li
#String.intern (so that Strings can be compared with ==) will not be used because some VMs have problems when used extensively.
@search_1000_b
......@@ -8200,628 +8215,631 @@ FAQ
起動とH2コンソールの使用
@tutorial_1002_a
JDBCを使用してデータベースに接続
#Settings of the H2 Console
@tutorial_1003_a
新しいデータベースを作成する
JDBCを使用してデータベースに接続
@tutorial_1004_a
サーバーを使用する
新しいデータベースを作成する
@tutorial_1005_a
Hibernateを使用する
サーバーを使用する
@tutorial_1006_a
#Using TopLink and Glassfish
Hibernateを使用する
@tutorial_1007_a
Webアプリケーションで データベースを使用する
#Using TopLink and Glassfish
@tutorial_1008_a
CSV (Comma Separated Values) サポート
Webアプリケーションで データベースを使用する
@tutorial_1009_a
アップグレード、 バックアップ、修復
CSV (Comma Separated Values) サポート
@tutorial_1010_a
#Command Line Tools
アップグレード、 バックアップ、修復
@tutorial_1011_a
OpenOffice Baseを使用する
#Command Line Tools
@tutorial_1012_a
Java Web Start / JNLP
OpenOffice Baseを使用する
@tutorial_1013_a
#Using a Connection Pool
Java Web Start / JNLP
@tutorial_1014_a
フルテキストサーチ
#Using a Connection Pool
@tutorial_1015_a
#User-Defined Variables
フルテキストサーチ
@tutorial_1016_a
#User-Defined Variables
@tutorial_1017_a
#Date and Time
@tutorial_1017_h2
@tutorial_1018_h2
起動とH2コンソールの使用
@tutorial_1018_p
@tutorial_1019_p
このアプリケーションはブラウザインターフェースを使ってSQLデータベースにアクセスします。 これは、H2データベース、またはJDBC APIをサポートする別のデータベースであるかもしれません。
@tutorial_1019_p
@tutorial_1020_p
これはクライアント / サーバーアプリケーションで、サーバーとクライアントの両方実行されることが必要です。
@tutorial_1020_p
@tutorial_1021_p
プラットフォームと環境によって、アプリケーションの起動方法が多数あります:
@tutorial_1021_th
@tutorial_1022_th
OS
@tutorial_1022_th
@tutorial_1023_th
起動
@tutorial_1023_td
@tutorial_1024_td
Windows
@tutorial_1024_td
@tutorial_1025_td
[スタート]、 [すべてのプログラム]、 [H2]、 [H2 Console]をクリックします
@tutorial_1025_td
@tutorial_1026_td
正しく動作したら、 システムトレイにアイコンが追加されます:
@tutorial_1026_td
@tutorial_1027_td
システムトレイアイコンが表示されなかったら、 Javaが正しくインストールされていないのかもしれません。 (この場合は、 他のアプリケーション起動方法を試して下さい) ブラウザウィンドウが開き、ログインページが表示されます。 (URL: http://localhost:8082/)
@tutorial_1027_td
@tutorial_1028_td
Windows
@tutorial_1028_td
@tutorial_1029_td
ファイルブラウザを開き、h2/binフォルダまで進み、h2.batをダブルクリックします。
@tutorial_1029_td
@tutorial_1030_td
正しく動作したら、システムトレイにアイコンが追加されます。 問題があれば、コンソールウィンドウにエラーメッセージが表示されます。 ブラウザウィンドウが開き、ログインページが表示されます。 (URL: http://localhost:8082/)
@tutorial_1030_td
@tutorial_1031_td
Any
@tutorial_1031_td
@tutorial_1032_td
コンソールウィンドウを開き、'h2/lib'ディレクトリまで進み、下記を実行します:
@tutorial_1032_h3
@tutorial_1033_h3
ファイアウォール
@tutorial_1033_p
@tutorial_1034_p
サーバーを起動させたら、ファイアウォールによるセキュリティ警告を受けるでしょう (1度インストールした場合)。外部ネットワークからあなたのマシンのデータベースにアクセスされたくないのであれば、ファイアーウォールが他の接続を遮断します。ローカルマシンからの接続はまだつながっています。他のコンピュータから、このコンピューターのデータベースにアクセスしたい場合のみ、 ファイアウォールでリモート接続を許可する必要があります。
@tutorial_1034_p
@tutorial_1035_p
小さなファイアーウォールはすでにサーバーに組み込まれています。 デフォルトによるこの構造は、他のコンピューターがサーバーにアクセスすることを許可していません。 これは、好きなように変更することができます (他のコンピューターからの接続を許可します)。
@tutorial_1035_h3
@tutorial_1036_h3
ネイティブ バージョン
@tutorial_1036_p
@tutorial_1037_p
ネイティブ バージョンはJavaを必要としていません。なぜなら、これはGCJを使用してコンパイルされるからです。しかし、H2は現在、Windows上のGCJプロジェクトでは実行されません。異なったプラットフォームでソフトウェアをコンパイルすることが可能です。
@tutorial_1037_h3
@tutorial_1038_h3
Javaをテストする
@tutorial_1038_p
@tutorial_1039_p
インストールしたJavaのバージョンを調べるためには、 コマンドプロンプトを開き、 下記を入力します:
@tutorial_1039_p
@tutorial_1040_p
もしエラーメッセージが表示されたら、Javaのバイナリディレクトリを環境変数のPathに追加します。
@tutorial_1040_h3
@tutorial_1041_h3
エラーメッセージ 'Port is in use'
@tutorial_1041_p
@tutorial_1042_p
ひとつのH2コンソールのみ起動することができます。 そうでなければ、次のようなエラーメッセージが表示されます:
<code>Port is in use, maybe another ... server already running on...</code>
複数のコンソールアプリケーションを同じコンピューターで起動することは可能です (異なったポートを使用します)、しかし、コンソールが複数の同時接続を維持するということは、普通は必要とされていません。
@tutorial_1042_h3
@tutorial_1043_h3
他のポートを使用する
@tutorial_1043_p
@tutorial_1044_p
もしポートが他のアプリケーションによって使用されている場合は、H2コンソールを異なったポートで起動したいはずです。これは、.h2.server.properties.ファイル内のポートを変更することにより実行できます。このファイルはユーザディレクトリ内に格納されています (Windowsでは通常、"Documents and Settings/&lt;ユーザ名>")。関連する項目はwebPortです。
@tutorial_1044_h3
@tutorial_1045_h3
起動成功
@tutorial_1045_p
@tutorial_1046_p
コンソールウィンドウからのサーバー起動が成功したら、新しいウィンドウが開き、 下記のように表示されます:
@tutorial_1046_p
@tutorial_1047_p
ウィンドウ内をクリックしないで下さい; アプリケーションが遮断されてしまいます (Fast-Edit モードが有効の場合)。
@tutorial_1047_h3
@tutorial_1048_h3
ブラウザを使用してサーバーに接続
@tutorial_1048_p
@tutorial_1049_p
#If the server started successfully, you can connect to it using a web browser. The browser needs to support JavaScript, frames and cascading stylesheets (css). If you started the server on the same computer as the browser, go to http://localhost:8082 in the browser. If you want to connect to the application from another computer, you need to provide the IP address of the server, for example: <a href="http://192.168.0.2:8082">http://192.168.0.2:8082</a> . If you enabled SSL on the server side, the URL needs to start with HTTPS.
@tutorial_1049_h3
@tutorial_1050_h3
複数の同時セッション
@tutorial_1050_p
@tutorial_1051_p
複数の同時ブラウザセッションがサポートされています。 データベースオブジェクトはサーバーに属しているため、同時接続の数はサーバーアプリケーションの利用可能メモリによって制限されています。
@tutorial_1051_h3
アプリケーションプロパティ
@tutorial_1052_p
サーバーを起動するとローカルのホームディレクトリに .h2.server.properties と呼ばれるファイル構成が作成されます。Windowsのインストールでは、このファイルは will be in the directory C:\Documents and Settings\[ユーザ名]のディレクトリ内にあります。このファイルはアプリケーションのセッティングに含まれています。
@tutorial_1053_h3
@tutorial_1052_h3
ログイン
@tutorial_1054_p
@tutorial_1053_p
ログインページでは、データベースに接続するための接続情報を設定する必要があります。 JDBCドライバをデータベースのクラスに設定し、JDBCのURL、ユーザ名とパスワードを入力します。 完了したら [Connect] をクリックします。
@tutorial_1055_p
@tutorial_1054_p
保存された設定をあらかじめ保存し、再び使用することができます。設定はアプリケーションプロパティファイルに記憶されます。
@tutorial_1056_h3
@tutorial_1055_h3
エラーメッセージ
@tutorial_1057_p
@tutorial_1056_p
エラーメッセージは赤で表示されます。 メッセージをクリックすることによって、例外の記録の表示、非表示を切り替えることができます。
@tutorial_1058_h3
@tutorial_1057_h3
データベースドライバの追加
@tutorial_1059_p
@tutorial_1058_p
H2DRIVERSかCLASSPATHの環境変数に、ドライバのJarファイルの位置を追加することにより、データベースドライバの追加を行うことができます。 例 (Windowsの場合): データベースドライバのライブラリに C:\Programs\hsqldb\lib\hsqldb.jar を追加し、H2DRIVERSの環境変数に C:\Programs\hsqldb\lib\hsqldb.jar を設定します。
@tutorial_1060_p
@tutorial_1059_p
複数のドライバを設定することも可能です; それぞれのパスは ';' (Windows) や ':' (他のOS) で区切ります。 パス名内のスペースは有効です。設定は引用されません。
@tutorial_1061_h3
@tutorial_1060_h3
アプリケーションを使用する
@tutorial_1062_p
@tutorial_1061_p
アプリケーションは3つのメインパネルを保持しています。上部のツールバー、左側のツリーとクエリ、右側の結果表示パネルです。データベースオブジェクト (例; テーブル) は左側のパネルに一覧表示されます。クエリパネルにSQLコマンドを打ち、 'Run' をクリックします。 コマンドの結果は、コマンドのすぐ下に表示されます。
@tutorial_1063_h3
@tutorial_1062_h3
テーブル名、またはカラム名をインサートする
@tutorial_1064_p
@tutorial_1063_p
テーブル名やカラム名は、ツリー内のテーブル名、カラム名をクリックすることによってスクリプトにインサートすることができます。クエリが空の時にテーブルをクリックすると、 'SELECT * FROM ...' も同様に追加されます。 クエリを入力している間、使用されているテーブルはツリー内で自動的に拡張されます。例えば、 'SELECT * FROM TEST T WHERE T.' と入力すると、ツリー内のTESTテーブルは自動的に拡張されます。
@tutorial_1065_h3
@tutorial_1064_h3
切断とアプリケーションの終了
@tutorial_1066_p
@tutorial_1065_p
ブラウザでは、ツールバーパネルの 'Disconnect' をクリックします。データベースからログアウトします。しかし、サーバーはまだ接続されていて、 新しいセッションを受け入れる準備をしています。
@tutorial_1067_p
@tutorial_1066_p
サーバーを止めるためには、システムトレイアイコンを右クリックし、 [Exit] を選択します。もしアイコンが表示されていないのであれば、 (別の方法で実行した場合) サーバーが実行されたコンソール上で [Ctrl]+[C] を押すか (Windowsの場合)、コンソールウィンドウを閉じます。
@tutorial_1068_h2
@tutorial_1067_h2
#Settings of the H2 Console
@tutorial_1068_p
#The settings of the H2 Console are stored in a configuration file called <code>.h2.server.properties</code> in you user home directory. For Windows installations, the user home directory is usually <code>C:\Documents and Settings\[username]</code> . The configuration file contains the settings of the application and is automatically created when the H2 Console is first started.
@tutorial_1069_h2
JDBCを使用してデータベースに接続
@tutorial_1069_p
@tutorial_1070_p
#To connect to a database, a Java application first needs to load the database driver, and then get a connection. A simple way to do that is using the following code:
@tutorial_1070_p
@tutorial_1071_p
このコードは最初にドライバをロードして (Class.forName())、 接続を開始します (DriverManager.getConnection())。 このドライバの名前は全てのケースにおいて "org.h2.Driver" です。 データベースに認識されるため、データベースのURLは常に jdbc:h2: から始まります。 getConnection() 内の2番目のパラメーターはユーザ名を指しています ('sa' はこの場合、システム管理者を表しています)。3番目のパラメーターはパスワードです。このデータベースでは、ユーザ名は大文字と小文字を区別していませんが、パスワードは大文字と小文字を区別しています。
@tutorial_1071_h2
@tutorial_1072_h2
新しいデータベースを作成する
@tutorial_1072_p
@tutorial_1073_p
初期設定では、データベースの指定されたURLがまだ存在しない場合、自動的に新しい (空の) データベースが作られます。
@tutorial_1073_h2
@tutorial_1074_h2
サーバーを使用する
@tutorial_1074_p
@tutorial_1075_p
H2は現在、3つのサーバーをサポートしています: Webサーバー、TCPサーバー、ODBCサーバーです。 これらのサーバーは異なった方法で起動します。
@tutorial_1075_h3
@tutorial_1076_h3
コマンドラインから起動する
@tutorial_1076_p
@tutorial_1077_p
初期設定でコマンドラインからサーバーを起動させるには、次のように実行します。
@tutorial_1077_p
@tutorial_1078_p
サーバーはデフォルトオプションで起動します。オプションの一覧を取得するには、次のように実行します。
@tutorial_1078_p
@tutorial_1079_p
異なったポートの使用が可能なオプションや、サーバーの一部を起動、終了させるオプションなどがあります。 詳細はサーバーツールのAPIドキュメントをご覧下さい。
@tutorial_1079_h3
@tutorial_1080_h3
TCPサーバーに接続する
@tutorial_1080_p
@tutorial_1081_p
データベースへリモート接続するためには、TCPサーバーを使用します。次のドライバとデータベースURLを利用します:
@tutorial_1081_li
@tutorial_1082_li
JDBCドライバクラス: org.h2.Driver
@tutorial_1082_li
@tutorial_1083_li
データベースURL: jdbc:h2:tcp://localhost/~/test
@tutorial_1083_p
@tutorial_1084_p
データベースURLについての詳細は、特徴内のページをご覧下さい。
@tutorial_1084_h3
@tutorial_1085_h3
アプリケーション内で起動する
@tutorial_1085_p
@tutorial_1086_p
アプリケーション内からサーバーを起動、終了することも可能です。 以下はサンプルコードです:
@tutorial_1086_h3
@tutorial_1087_h3
他の過程からTCPサーバーを終了する
@tutorial_1087_p
@tutorial_1088_p
TCPサーバーは他の過程から終了することができます。 コマンドラインからサーバーを終了するには、次のように実行します:
@tutorial_1088_p
@tutorial_1089_p
ユーザアプリケーションからサーバーを終了するには、次のコードを使用します:
@tutorial_1089_p
@tutorial_1090_p
この機能はサーバー上の System.exit を呼んでいます。この機能は、データベースが次回起動された時のリカバリーを回避するため、データベースへの全ての接続が切断された後に呼ばれます。リモートサーバーを終了するには、サーバー上でリモート接続が可能である必要があります。
@tutorial_1090_h2
@tutorial_1091_h2
Hibernateを使用する
@tutorial_1091_p
@tutorial_1092_p
#This database supports Hibernate version 3.1 and newer. You can use the HSQLDB Dialect, or the native H2 Dialect. Unfortunately the H2 Dialect included in Hibernate is buggy. A <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-3401">patch for Hibernate</a> has been submitted. The dialect for the newest version of Hibernate is also available at src/tools/org/hibernate/dialect/H2Dialect.java.txt. You can rename it to H2Dialect.java and include this as a patch in your application.
@tutorial_1092_h2
@tutorial_1093_h2
#Using TopLink and Glassfish
@tutorial_1093_p
@tutorial_1094_p
#To use H2 with Glassfish (or Sun AS), set the Datasource Classname to <code>org.h2.jdbcx.JdbcDataSource</code> . You can set this in the GUI at Application Server - Resources - JDBC - Connection Pools, or by editing the file <code>sun-resources.xml</code> : at element <code>jdbc-connection-pool</code> , set the attribute <code>datasource-classname</code> to <code>org.h2.jdbcx.JdbcDataSource</code> .
@tutorial_1094_p
@tutorial_1095_p
#The H2 database is compatible with HSQLDB and PostgreSQL. To take advantage of H2 specific features, use the <code>H2Platform</code> . The source code of this platform is included in H2 at <code>src/tools/oracle/toplink/essentials/platform/database/DatabasePlatform.java.txt</code> . You will need to copy this file to your application, and rename it to .java. To enable it, change the following setting in persistence.xml:
@tutorial_1095_p
@tutorial_1096_p
#In old versions of Glassfish, the property name is <code>toplink.platform.class.name</code> .
@tutorial_1096_h2
@tutorial_1097_h2
Webアプリケーションで データベースを使用する
@tutorial_1097_p
@tutorial_1098_p
Webアプリケーション内からデータベースに接続するには様々な方法があります。 以下はTomcatかJBossを使用の場合のいくつかの例です。
@tutorial_1098_h3
@tutorial_1099_h3
エンベッドモード
@tutorial_1099_p
@tutorial_1100_p
(現在)最も簡単なソリューションはエンベッドモードでデータベースを使用することです。 それは、アプリケーションが起動する時や (良いソリューションは Servletリスナーを使用します。下記参照)、セッションが起動する時、アプリケーションにおける接続が開始するということを意味します。データベースは、セッションやアプリケーションが同じ過程で実行している限り、多様なセッションやアプリケーションから同時に接続されることが可能です。 多くのServletコンテナは (例； Tomcat) ただひとつのプロセスで利用されるので、問題はありません。 (Tomcatをクラスターモードで起動している場合を除いて)。 Tomcatはマルチスレッドとマルチクラスローダーを使用しています。もし複数のアプリケーションが同じデータベースに同時にアクセスする場合、データベースjarをshared/lib、またはserver/libディレクトリに置く必要があります。 webアプリケーションが起動した時にデータベースを開き、webアプリケーションが終了した時にデータベースを閉じるのが良い方法です。もし複数のアプリケーションを使用する場合、そのうちひとつのアプリケーションをこのように動作することが必要です。アプリケーションでは、セッションごとにひとつの接続を使うか、リクエスト(アクション)ごとにひとつの接続を使うという概念があります。これらの接続はできる限り、使用後に終了させます(しかし、終了させなくても悪くはありません)。
@tutorial_1100_h3
@tutorial_1101_h3
サーバーモード
@tutorial_1101_p
@tutorial_1102_p
サーバーモードは類似していますが、他のプロセスでサーバーを起動させることを許可しています。
@tutorial_1102_h3
@tutorial_1103_h3
データベースの起動と終了にServletリスナーを使用する
@tutorial_1103_p
@tutorial_1104_p
以下を web.xmlファイルに追記して下さい。 (context-paramとfilterの間):
@tutorial_1104_p
@tutorial_1105_p
データベースへのアクセス方法についての詳細は、DbStarter.javaコードをご覧下さい。
@tutorial_1105_p
@tutorial_1106_p
#By default the DbStarter listener opens an embedded connection using the database URL jdbc:h2:~/test and user name and password 'sa'. It can also start the TCP server, however this is disabled by default. To enable it, use the db.tcpServer parameter in web.xml. Here is the complete list of options. These options are set just after the display-name and description tag, but before any listener and filter tags:
@tutorial_1106_p
@tutorial_1107_p
#When the web application is stopped, the database connection will be closed automatically. If the server is started within the DbStarter, it will also be stopped automatically when the web application is stopped.
@tutorial_1107_h3
@tutorial_1108_h3
#Using the H2 Console Servlet
@tutorial_1108_p
@tutorial_1109_p
#The H2 Console is a standalone application and includes its own web server, but it can be used as a servlet as well. To do that, include the the h2 jar file in your application, and add the following configuration to your web.xml:
@tutorial_1109_p
@tutorial_1110_p
#For details, see also <code>src/tools/WEB-INF/web.xml</code> .
@tutorial_1110_p
@tutorial_1111_p
#To create a web application that creates just the H2 Console, run the following command:
@tutorial_1111_h2
@tutorial_1112_h2
CSV (Comma Separated Values) サポート
@tutorial_1112_p
@tutorial_1113_p
データベースにCSVREADとCSVWRITEの関数を使用することで、 CSVファイルサポートを使用することができ、スタンドアロンツールとしてデータベースの外でCSVライブラリを使用することができます。
@tutorial_1113_h3
@tutorial_1114_h3
データベース内からCSVファイルに書き込む
@tutorial_1114_p
@tutorial_1115_p
クエリからCSVファイルを作成するのに、組込み関数 CSVWRITEを使用することができます。例:
@tutorial_1115_h3
@tutorial_1116_h3
データベース内からCSVファイルを読み込む
@tutorial_1116_p
@tutorial_1117_p
CSVREAD関数を使用してCSVファイルを読み込むことができます。 例:
@tutorial_1117_h3
@tutorial_1118_h3
JavaアプリケーションからCSVファイルに書き込む
@tutorial_1118_p
@tutorial_1119_p
データベースを全く使用しなくても、JavaアプリケーションでCSVツールを使用することができます。 例:
@tutorial_1119_h3
@tutorial_1120_h3
JavaアプリケーションからCSVファイルを読み込む
@tutorial_1120_p
@tutorial_1121_p
データベースを開かなくてもCSVファイルを読み込むことができます。 例:
@tutorial_1121_h2
@tutorial_1122_h2
アップグレード、 バックアップ、修復
@tutorial_1122_h3
@tutorial_1123_h3
データベースのアップグレー
@tutorial_1123_p
@tutorial_1124_p
あるバージョンのデータベースエンジンを次のバージョンにアップグレードする際の推奨する方法は、 古いエンジンを使って(SQLスクリプトのフォームでの)データベースのバックアップを作成し、新しいエンジンを使ってSQLスクリプトを実行します。
@tutorial_1124_h3
@tutorial_1125_h3
バックアップ
@tutorial_1125_p
@tutorial_1126_p
異なった方法のデータベースのバックアップがあります。例えば、データベースファイルをコピーすることが可能です。しかしながら、この方法はデータベースが使用されている間は推奨しません。データベースは人が判読しやすく、極めて大きいというわけではありません。データベースバックアップの推奨する方法は、圧縮したSQLスクリプトを作成することです。この方法は、バックアップツールを使用することで可能です:
@tutorial_1126_p
@tutorial_1127_p
オプションについての情報は、SQLコマンドスクリプトをご覧下さい。バックアップは遠隔で行えますが、ファイルはサーバー側に作られます。サーバーからファイルを取るのに、ビルトインFTPサーバーを使用することができます。データベースのバックアップを作るのに、SQLコマンドスクリプトを 使用することもできます。
@tutorial_1127_h3
@tutorial_1128_h3
修復
@tutorial_1128_p
@tutorial_1129_p
SQLスクリプトファイルからデータベースを修復するには、RunScriptツールを使用する必要があります:
@tutorial_1129_p
@tutorial_1130_p
オプションについての情報は、SQLコマンド RUNSCRIPTをご覧下さい。修復は遠隔で行えますが、サーバー側にファイルが存在する必要があります。サーバーからファイルをコピーするのに、ビルトインFTPサーバーを使用することができます。SQLスクリプトを実行するために、 SQLコマンド RUNSCRIPTを使用することができます。SQLスクリプトファイルには、RUNSCRIPTコマンドのフォーム内に他のスクリプトファイルのリファレンスが含まれています。しかしながら、サーバーモードを使用している時、リファレンススクリプトファイルはサーバー側で利用可能であることが必要です。
@tutorial_1130_h3
@tutorial_1131_h3
オンラインバックアップ
@tutorial_1131_p
@tutorial_1132_p
BACKUP SQLステートメントとバックアップツールの両方が全てのデータベースファイルをzipファイル形式で作成します。しかし、このファイルのコンテンツは人間が解読可能なものではありません。SCRIPTステートメントを除いて、BACKUPステートメントはデータベースオブジェクトをロックしないため、他のユーザーをブロックしません。結果として、バックアップは一貫性のあるトランザクションです:
@tutorial_1132_p
@tutorial_1133_p
バックアップツール (org.h2.tools.Backup) はオンラインバックアップを作成するために利用されません; このプログラムが実行されている間、データベースは使用されてはいけません。
@tutorial_1133_h2
@tutorial_1134_h2
#Command Line Tools
@tutorial_1134_p
@tutorial_1135_p
#This database comes with a number of command line tools. To get more information about a tool, start it with the parameter '-?', for example:
@tutorial_1135_p
@tutorial_1136_p
#The command line tools are:
@tutorial_1136_b
@tutorial_1137_b
バックアップ
@tutorial_1137_li
@tutorial_1138_li
#creates a backup of a database.
@tutorial_1138_b
@tutorial_1139_b
#ChangeFileEncryption
@tutorial_1139_li
@tutorial_1140_li
#allows changing the file encryption password or algorithm of a database.
@tutorial_1140_b
@tutorial_1141_b
#Console
@tutorial_1141_li
@tutorial_1142_li
#starts the browser based H2 Console.
@tutorial_1142_b
@tutorial_1143_b
#ConvertTraceFile
@tutorial_1143_li
@tutorial_1144_li
#converts a .trace.db file to a Java application and SQL script.
@tutorial_1144_b
@tutorial_1145_b
#CreateCluster
@tutorial_1145_li
@tutorial_1146_li
#creates a cluster from a standalone database.
@tutorial_1146_b
@tutorial_1147_b
#DeleteDbFiles
@tutorial_1147_li
@tutorial_1148_li
#deletes all files belonging to a database.
@tutorial_1148_b
@tutorial_1149_b
#Script
@tutorial_1149_li
@tutorial_1150_li
#allows converting a database to a SQL script for backup or migration.
@tutorial_1150_b
@tutorial_1151_b
#Recover
@tutorial_1151_li
@tutorial_1152_li
#helps recovering a corrupted database.
@tutorial_1152_b
@tutorial_1153_b
#Restore
@tutorial_1153_li
@tutorial_1154_li
#restores a backup of a database.
@tutorial_1154_b
@tutorial_1155_b
#RunScript
@tutorial_1155_li
@tutorial_1156_li
#runs a SQL script against a database.
@tutorial_1156_b
@tutorial_1157_b
Server
@tutorial_1157_li
@tutorial_1158_li
#is used in the server mode to start a H2 server.
@tutorial_1158_b
@tutorial_1159_b
#Shell
@tutorial_1159_li
@tutorial_1160_li
#is a command line database tool.
@tutorial_1160_p
@tutorial_1161_p
#The tools can also be called from an application by calling the main or another public methods. For details, see the Javadoc documentation.
@tutorial_1161_h2
@tutorial_1162_h2
OpenOffice Baseを使用する
@tutorial_1162_p
@tutorial_1163_p
OpenOffice.org Base はJDBC API上のデータベースアクセスをサポートしています。 OpenOffice Baseを使ってH2データベースに接続するためには、最初にOpenOfficeにJDBCドライバを追加する必要があります。H2データベースに接続する手順:
@tutorial_1163_li
@tutorial_1164_li
#Start OpenOffice Writer, go to [Tools], [Options]
@tutorial_1164_li
@tutorial_1165_li
#Make sure you have selected a Java runtime environment in OpenOffice.org / Java
@tutorial_1165_li
@tutorial_1166_li
#Click [Class Path...], [Add Archive...]
@tutorial_1166_li
@tutorial_1167_li
#Select your h2.jar (location is up to you, could be wherever you choose)
@tutorial_1167_li
@tutorial_1168_li
#Click [OK] (as much as needed), stop OpenOffice (including the Quickstarter)
@tutorial_1168_li
@tutorial_1169_li
OpenOffice Base を起動する
@tutorial_1169_li
@tutorial_1170_li
存在するデータベースに接続し、JDBCを選択し、[Next] をクリックする
@tutorial_1170_li
@tutorial_1171_li
#Example datasource URL: jdbc:h2:~/test
@tutorial_1171_li
@tutorial_1172_li
JDBCドライバクラス: org.h2.Driver
@tutorial_1172_p
@tutorial_1173_p
#Now you can access the database stored in the current users home directory.
@tutorial_1173_p
@tutorial_1174_p
#To use H2 in NeoOffice (OpenOffice without X11):
@tutorial_1174_li
@tutorial_1175_li
#In NeoOffice, go to [NeoOffice], [Preferences]
@tutorial_1175_li
@tutorial_1176_li
#Look for the page under [NeoOffice], [Java]
@tutorial_1176_li
@tutorial_1177_li
#Click [Classpath], [Add Archive...]
@tutorial_1177_li
@tutorial_1178_li
#Select your h2.jar (location is up to you, could be wherever you choose)
@tutorial_1178_li
@tutorial_1179_li
#Click [OK] (as much as needed), restart NeoOffice.
@tutorial_1179_p
@tutorial_1180_p
#Now, when creating a new database using the "Database Wizard":
@tutorial_1180_li
@tutorial_1181_li
#Select "connect to existing database" and the type "jdbc". Click next.
@tutorial_1181_li
@tutorial_1182_li
#Enter your h2 database URL. The normal behavior of H2 is that a new db is created if it doesn't exist.
@tutorial_1182_li
@tutorial_1183_li
#Next step - up to you... you can just click finish and start working.
@tutorial_1183_p
@tutorial_1184_p
#Another solution to use H2 in NeoOffice is:
@tutorial_1184_li
@tutorial_1185_li
#Package the h2 jar within an extension package
@tutorial_1185_li
@tutorial_1186_li
#Install it as a Java extension in NeoOffice
@tutorial_1186_p
@tutorial_1187_p
#This can be done by create it using the NetBeans OpenOffice plugin. See also <a href="http://wiki.services.openoffice.org/wiki/Extensions_development_java">Extensions Development</a> .
@tutorial_1187_h2
@tutorial_1188_h2
Java Web Start / JNLP
@tutorial_1188_p
@tutorial_1189_p
Java Web Start / JNLP (Java Network Launch Protocol) を使用している時、パーミッションタグは.jnlp ファイルに設定され、application.jarファイルは署名されていなければなりません。そうでなければ、ファイルシステムに書き込もうとした時、次の例外が発生するでしょう: java.security.AccessControlException: access denied (java.io.FilePermission ... read) パーミッションタグの例:
@tutorial_1189_h2
@tutorial_1190_h2
#Using a Connection Pool
@tutorial_1190_p
@tutorial_1191_p
#For many databases, opening a connection is slow, and it is a good idea to use a connection pool to re-use connections. For H2 however opening a connection usually is fast if the database is already open. Using a connection pool for H2 actually slows down the process a bit, except if file encryption is used (in this case opening a connection is about half as fast as using a connection pool). A simple connection pool is included in H2. It is based on the <a href="http://www.source-code.biz/snippets/java/8.htm">Mini Connection Pool Manager</a> from Christian d'Heureuse. There are other, more complex connection pools available, for example <a href="http://jakarta.apache.org/commons/dbcp/">DBCP</a> . The build-in connection pool is used as follows:
@tutorial_1191_h2
@tutorial_1192_h2
フルテキストサーチ
@tutorial_1192_p
@tutorial_1193_p
H2はLuceneフルテキストサーチとnativeフルテキストサーチの実装をサポートしています。
@tutorial_1193_h3
@tutorial_1194_h3
Nativeフルテキストサーチを使用する
@tutorial_1194_p
@tutorial_1195_p
初期化するには、次を呼び出します:
@tutorial_1195_p
@tutorial_1196_p
#You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using:
@tutorial_1196_p
@tutorial_1197_p
PUBLICはスキーマ、TESTはテーブル名です。カラム名のリスト (分離されたカラム) はオプションです。このケースでは、全てのカラムがインデックスです。インデックスはリードタイムに更新されます。インデックスを検索するには、次のクエリーを使用します:
@tutorial_1197_p
@tutorial_1198_p
Javaアプリケーション内からインデックスを呼び出すことも可能です:
@tutorial_1198_h3
@tutorial_1199_h3
Luceneフルテキストサーチを使用する
@tutorial_1199_p
@tutorial_1200_p
#To use the Lucene full text search, you need the Lucene library in the classpath. How his is done depends on the application; if you use the H2 Console, you can add the Lucene jar file to the environment variables H2DRIVERS or CLASSPATH. To initialize the Lucene full text search in a database, call:
@tutorial_1200_p
@tutorial_1201_p
#You need to initialize it in each database where you want to use it. Afterwards, you can create a full text index for a table using:
@tutorial_1201_p
@tutorial_1202_p
PUBLICはスキーマ、TESTはテーブル名です。カラム名のリスト (分離されたカラム) はオプションです。このケースでは、全てのカラムがインデックスです。インデックスはリードタイムに更新されます。インデックスを検索するには、次のクエリーを使用します:
@tutorial_1202_p
@tutorial_1203_p
Javaアプリケーション内からインデックスを呼び出すことも可能です:
@tutorial_1203_h2
@tutorial_1204_h2
#User-Defined Variables
@tutorial_1204_p
@tutorial_1205_p
#This database supports user-defined variables. Variables start with @ and can be used wherever expressions or parameters are used. Variables not persisted and session scoped, that means only visible for the session where they are defined. A value is usually assigned using the SET command:
@tutorial_1205_p
@tutorial_1206_p
#It is also possible to change a value using the SET() method. This is useful in queries:
@tutorial_1206_p
@tutorial_1207_p
#Variables that are not set evaluate to NULL. The data type of a user-defined variable is the data type of the value assigned to it, that means it is not necessary (or possible) to declare variable names before using them. There are no restrictions on the assigned values; large objects (LOBs) are supported as well.
@tutorial_1207_h2
@tutorial_1208_h2
#Date and Time
@tutorial_1208_p
@tutorial_1209_p
#Date, time and timestamp values support ISO 8601 formatting, including time zone:
@tutorial_1209_p
@tutorial_1210_p
#If the time zone is not set, the value is parsed using the current time zone setting of the system. Date and time information is stored in H2 database files in GMT (Greenwich Mean Time). If the database is opened using another system time zone, the date and time will change accordingly. If you want to move a database from one time zone to the other and don't want this to happen, you need to create a SQL script file using the SCRIPT command or Script tool, and then load the database using the RUNSCRIPT command or the RunScript tool in the new time zone.
h2/src/docsrc/textbase/_docs_en.properties
浏览文件 @ adf661ad
This source diff could not be displayed because it is too large. You can view the blob instead.
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论