diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml new file mode 100644 index 0000000000..0535ccd7dc --- /dev/null +++ b/.github/workflows/CI.yml @@ -0,0 +1,33 @@ +name: CI + +on: [push, pull_request] + +jobs: + java-8: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up JDK 1.8 + uses: actions/setup-java@v1 + with: + java-version: 1.8 + - name: Test + run: | + cd h2 + echo $JAVA_OPTS + export JAVA_OPTS=-Xmx512m + ./build.sh jar testCI + java-11: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + - name: Set up JDK 11 + uses: actions/setup-java@v1 + with: + java-version: 11 + - name: Test + run: | + cd h2 + echo $JAVA_OPTS + export JAVA_OPTS=-Xmx512m + ./build.sh jar testCI diff --git a/.lift.toml b/.lift.toml new file mode 100644 index 0000000000..3c7beccf52 --- /dev/null +++ b/.lift.toml @@ -0,0 +1,8 @@ +# Config file for SonaType Lift analysis tool +# +# config reference here: https://help.sonatype.com/lift/configuration-reference +# + +# Tell sonatype where our pom file lives, so it can build it again +# +build = "maven -f h2/pom.xml compile" \ No newline at end of file diff --git a/.travis.yml b/.travis.yml deleted file mode 100644 index 49701c993f..0000000000 --- a/.travis.yml +++ /dev/null @@ -1,32 +0,0 @@ -language: java - -script: ./build.sh jar testTravis - -cache: - directories: - - $HOME/.m2/repository - -matrix: - include: - - jdk: oraclejdk8 - dist: trusty - group: edge - sudo: required - addons: - apt: - packages: - - oracle-java8-installer - before_script: - - "cd h2" - - "echo $JAVA_OPTS" - - "export JAVA_OPTS=-Xmx512m" - - jdk: openjdk7 - dist: trusty - group: edge - sudo: required - addons: - apt: - packages: - - openjdk-7-jdk - before_script: - - "cd h2" diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000000..eed8e4b1a1 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,552 @@ +H2 is dual licensed and available under the MPL 2.0 (Mozilla Public License +Version 2.0) or under the EPL 1.0 (Eclipse Public License). + +------------------------------------------------------------------------------- + +Mozilla Public License, version 2.0 + +1. Definitions + + 1.1. “Contributor” + means each individual or legal entity that creates, contributes to the + creation of, or owns Covered Software. + + 1.2. “Contributor Version” + means the combination of the Contributions of others (if any) used by a + Contributor and that particular Contributor’s Contribution. + + 1.3. “Contribution” + means Covered Software of a particular Contributor. + + 1.4. “Covered Software” + means Source Code Form to which the initial Contributor has attached the + notice in Exhibit A, the Executable Form of such Source Code Form, + and Modifications of such Source Code Form, in each case + including portions thereof. + + 1.5. “Incompatible With Secondary Licenses” + means + + a. that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + b. that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the terms + of a Secondary License. + + 1.6. “Executable Form” + means any form of the work other than Source Code Form. + + 1.7. “Larger Work” + means a work that combines Covered Software with other material, + in a separate file or files, that is not Covered Software. + + 1.8. “License” + means this document. + + 1.9. “Licensable” + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, + any and all of the rights conveyed by this License. + + 1.10. “Modifications” + means any of the following: + + a. any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered Software; or + + b. any new file in Source Code Form that contains any Covered Software. + + 1.11. “Patent Claims” of a Contributor + means any patent claim(s), including without limitation, method, process, + and apparatus claims, in any patent Licensable by such Contributor that + would be infringed, but for the grant of the License, by the making, + using, selling, offering for sale, having made, import, or transfer of + either its Contributions or its Contributor Version. + + 1.12. “Secondary License” + means either the GNU General Public License, Version 2.0, the + GNU Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those licenses. + + 1.13. “Source Code Form” + means the form of the work preferred for making modifications. + + 1.14. “You” (or “Your”) + means an individual or a legal entity exercising rights under this License. + For legal entities, “You” includes any entity that controls, + is controlled by, or is under common control with You. For purposes of + this definition, “control” means (a) the power, direct or indirect, + to cause the direction or management of such entity, whether by contract + or otherwise, or (b) ownership of more than fifty percent (50%) of the + outstanding shares or beneficial ownership of such entity. + +2. License Grants and Conditions + + 2.1. Grants + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + + a. under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, + or as part of a Larger Work; and + + b. under Patent Claims of such Contributor to make, use, sell, + offer for sale, have made, import, and otherwise transfer either + its Contributions or its Contributor Version. + + 2.2. Effective Date + The licenses granted in Section 2.1 with respect to any Contribution + become effective for each Contribution on the date the Contributor + first distributes such Contribution. + + 2.3. Limitations on Grant Scope + The licenses granted in this Section 2 are the only rights granted + under this License. No additional rights or licenses will be implied + from the distribution or licensing of Covered Software under this License. + Notwithstanding Section 2.1(b) above, no patent license is granted + by a Contributor: + + a. for any code that a Contributor has removed from + Covered Software; or + + b. for infringements caused by: (i) Your and any other third party’s + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its + Contributor Version); or + + c. under Patent Claims infringed by Covered Software in the + absence of its Contributions. + + This License does not grant any rights in the trademarks, service marks, + or logos of any Contributor (except as may be necessary to comply with + the notice requirements in Section 3.4). + + 2.4. Subsequent Licenses + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this + License (see Section 10.2) or under the terms of a Secondary License + (if permitted under the terms of Section 3.3). + + 2.5. Representation + Each Contributor represents that the Contributor believes its + Contributions are its original creation(s) or it has sufficient rights + to grant the rights to its Contributions conveyed by this License. + + 2.6. Fair Use + This License is not intended to limit any rights You have under + applicable copyright doctrines of fair use, fair dealing, + or other equivalents. + + 2.7. Conditions + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the + licenses granted in Section 2.1. + +3. Responsibilities + + 3.1. Distribution of Source Form + All distribution of Covered Software in Source Code Form, including + any Modifications that You create or to which You contribute, must be + under the terms of this License. You must inform recipients that the + Source Code Form of the Covered Software is governed by the terms + of this License, and how they can obtain a copy of this License. + You may not attempt to alter or restrict the recipients’ rights + in the Source Code Form. + + 3.2. Distribution of Executable Form + If You distribute Covered Software in Executable Form then: + + a. such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more than + the cost of distribution to the recipient; and + + b. You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients’ rights in the Source Code Form under this License. + + 3.3. Distribution of a Larger Work + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for + the Covered Software. If the Larger Work is a combination of + Covered Software with a work governed by one or more Secondary Licenses, + and the Covered Software is not Incompatible With Secondary Licenses, + this License permits You to additionally distribute such Covered Software + under the terms of such Secondary License(s), so that the recipient of + the Larger Work may, at their option, further distribute the + Covered Software under the terms of either this License or such + Secondary License(s). + + 3.4. Notices + You may not remove or alter the substance of any license notices + (including copyright notices, patent notices, disclaimers of warranty, + or limitations of liability) contained within the Source Code Form of + the Covered Software, except that You may alter any license notices to + the extent required to remedy known factual inaccuracies. + + 3.5. Application of Additional Terms + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of + Covered Software. However, You may do so only on Your own behalf, + and not on behalf of any Contributor. You must make it absolutely clear + that any such warranty, support, indemnity, or liability obligation is + offered by You alone, and You hereby agree to indemnify every Contributor + for any liability incurred by such Contributor as a result of warranty, + support, indemnity or liability terms You offer. You may include + additional disclaimers of warranty and limitations of liability + specific to any jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + +If it is impossible for You to comply with any of the terms of this License +with respect to some or all of the Covered Software due to statute, +judicial order, or regulation then You must: (a) comply with the terms of +this License to the maximum extent possible; and (b) describe the limitations +and the code they affect. Such description must be placed in a text file +included with all distributions of the Covered Software under this License. +Except to the extent prohibited by statute or regulation, such description +must be sufficiently detailed for a recipient of ordinary skill +to be able to understand it. + +5. Termination + + 5.1. The rights granted under this License will terminate automatically + if You fail to comply with any of its terms. However, if You become + compliant, then the rights granted under this License from a particular + Contributor are reinstated (a) provisionally, unless and until such + Contributor explicitly and finally terminates Your grants, and (b) on an + ongoing basis, if such Contributor fails to notify You of the + non-compliance by some reasonable means prior to 60 days after You have + come back into compliance. Moreover, Your grants from a particular + Contributor are reinstated on an ongoing basis if such Contributor + notifies You of the non-compliance by some reasonable means, + this is the first time You have received notice of non-compliance with + this License from such Contributor, and You become compliant prior to + 30 days after Your receipt of the notice. + + 5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, + counter-claims, and cross-claims) alleging that a Contributor Version + directly or indirectly infringes any patent, then the rights granted + to You by any and all Contributors for the Covered Software under + Section 2.1 of this License shall terminate. + + 5.3. In the event of termination under Sections 5.1 or 5.2 above, all + end user license agreements (excluding distributors and resellers) which + have been validly granted by You or Your distributors under this License + prior to termination shall survive termination. + +6. Disclaimer of Warranty + +Covered Software is provided under this License on an “as is” basis, without +warranty of any kind, either expressed, implied, or statutory, including, +without limitation, warranties that the Covered Software is free of defects, +merchantable, fit for a particular purpose or non-infringing. The entire risk +as to the quality and performance of the Covered Software is with You. +Should any Covered Software prove defective in any respect, You +(not any Contributor) assume the cost of any necessary servicing, repair, +or correction. This disclaimer of warranty constitutes an essential part of +this License. No use of any Covered Software is authorized under this +License except under this disclaimer. + +7. Limitation of Liability + +Under no circumstances and under no legal theory, whether tort +(including negligence), contract, or otherwise, shall any Contributor, or +anyone who distributes Covered Software as permitted above, be liable to +You for any direct, indirect, special, incidental, or consequential damages +of any character including, without limitation, damages for lost profits, +loss of goodwill, work stoppage, computer failure or malfunction, or any and +all other commercial damages or losses, even if such party shall have been +informed of the possibility of such damages. This limitation of liability +shall not apply to liability for death or personal injury resulting from +such party’s negligence to the extent applicable law prohibits such +limitation. Some jurisdictions do not allow the exclusion or limitation of +incidental or consequential damages, so this exclusion and limitation may +not apply to You. + +8. Litigation + +Any litigation relating to this License may be brought only in the courts of +a jurisdiction where the defendant maintains its principal place of business +and such litigation shall be governed by laws of that jurisdiction, without +reference to its conflict-of-law provisions. Nothing in this Section shall +prevent a party’s ability to bring cross-claims or counter-claims. + +9. Miscellaneous + +This License represents the complete agreement concerning the subject matter +hereof. If any provision of this License is held to be unenforceable, +such provision shall be reformed only to the extent necessary to make it +enforceable. Any law or regulation which provides that the language of a +contract shall be construed against the drafter shall not be used to construe +this License against a Contributor. + +10. Versions of the License + + 10.1. New Versions + Mozilla Foundation is the license steward. Except as provided in + Section 10.3, no one other than the license steward has the right to + modify or publish new versions of this License. Each version will be + given a distinguishing version number. + + 10.2. Effect of New Versions + You may distribute the Covered Software under the terms of the version + of the License under which You originally received the Covered Software, + or under the terms of any subsequent version published + by the license steward. + + 10.3. Modified Versions + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a modified + version of this License if you rename the license and remove any + references to the name of the license steward (except to note that such + modified license differs from this License). + + 10.4. Distributing Source Code Form that is + Incompatible With Secondary Licenses + If You choose to distribute Source Code Form that is + Incompatible With Secondary Licenses under the terms of this version of + the License, the notice described in Exhibit B of this + License must be attached. + +Exhibit A - Source Code Form License Notice + + This Source Code Form is subject to the terms of the + Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed + with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular file, +then You may include the notice in a location (such as a LICENSE file in a +relevant directory) where a recipient would be likely to +look for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - “Incompatible With Secondary Licenses” Notice + + This Source Code Form is “Incompatible With Secondary Licenses”, + as defined by the Mozilla Public License, v. 2.0. + +------------------------------------------------------------------------------- + +Eclipse Public License, Version 1.0 (EPL-1.0) + +THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC +LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM +CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT. + +1. DEFINITIONS + +"Contribution" means: + + a) in the case of the initial Contributor, the initial code and + documentation distributed under this Agreement, and + + b) in the case of each subsequent Contributor: + i) changes to the Program, and + ii) additions to the Program; + +where such changes and/or additions to the Program originate from and are +distributed by that particular Contributor. A Contribution 'originates' +from a Contributor if it was added to the Program by such Contributor itself +or anyone acting on such Contributor's behalf. Contributions do not include +additions to the Program which: (i) are separate modules of software +distributed in conjunction with the Program under their own license agreement, +and (ii) are not derivative works of the Program. + +"Contributor" means any person or entity that distributes the Program. + +"Licensed Patents " mean patent claims licensable by a Contributor which are +necessarily infringed by the use or sale of its Contribution alone or +when combined with the Program. + +"Program" means the Contributions distributed in accordance with +this Agreement. + +"Recipient" means anyone who receives the Program under this Agreement, +including all Contributors. + +2. GRANT OF RIGHTS + + a) Subject to the terms of this Agreement, each Contributor hereby grants + Recipient a non-exclusive, worldwide, royalty-free copyright license to + reproduce, prepare derivative works of, publicly display, publicly + perform, distribute and sublicense the Contribution of such + Contributor, if any, and such derivative works, + in source code and object code form. + + b) Subject to the terms of this Agreement, each Contributor hereby grants + Recipient a non-exclusive, worldwide, royalty-free patent license under + Licensed Patents to make, use, sell, offer to sell, import and + otherwise transfer the Contribution of such Contributor, if any, + in source code and object code form. This patent license shall apply + to the combination of the Contribution and the Program if, at the time + the Contribution is added by the Contributor, such addition of the + Contribution causes such combination to be covered by the + Licensed Patents. The patent license shall not apply to any other + combinations which include the Contribution. + No hardware per se is licensed hereunder. + + c) Recipient understands that although each Contributor grants the + licenses to its Contributions set forth herein, no assurances are + provided by any Contributor that the Program does not infringe the + patent or other intellectual property rights of any other entity. + Each Contributor disclaims any liability to Recipient for claims + brought by any other entity based on infringement of intellectual + property rights or otherwise. As a condition to exercising the + rights and licenses granted hereunder, each Recipient hereby assumes + sole responsibility to secure any other intellectual property rights + needed, if any. For example, if a third party patent license is + required to allow Recipient to distribute the Program, it is + Recipient's responsibility to acquire that license + before distributing the Program. + + d) Each Contributor represents that to its knowledge it has sufficient + copyright rights in its Contribution, if any, to grant the copyright + license set forth in this Agreement. + +3. REQUIREMENTS + +A Contributor may choose to distribute the Program in object code form under +its own license agreement, provided that: + + a) it complies with the terms and conditions of this Agreement; and + + b) its license agreement: + + i) effectively disclaims on behalf of all Contributors all warranties + and conditions, express and implied, including warranties or + conditions of title and non-infringement, and implied warranties or + conditions of merchantability and fitness for a particular purpose; + + ii) effectively excludes on behalf of all Contributors all liability + for damages, including direct, indirect, special, incidental and + consequential damages, such as lost profits; + + iii) states that any provisions which differ from this Agreement are + offered by that Contributor alone and not by any other party; and + + iv) states that source code for the Program is available from such + Contributor, and informs licensees how to obtain it in a reasonable + manner on or through a medium customarily used for software exchange. + +When the Program is made available in source code form: + + a) it must be made available under this Agreement; and + b) a copy of this Agreement must be included with each copy of the Program. + +Contributors may not remove or alter any copyright notices contained +within the Program. + +Each Contributor must identify itself as the originator of its Contribution, +if any, in a manner that reasonably allows subsequent Recipients to +identify the originator of the Contribution. + +4. COMMERCIAL DISTRIBUTION + +Commercial distributors of software may accept certain responsibilities with +respect to end users, business partners and the like. While this license is +intended to facilitate the commercial use of the Program, the Contributor who +includes the Program in a commercial product offering should do so in a manner +which does not create potential liability for other Contributors. Therefore, +if a Contributor includes the Program in a commercial product offering, +such Contributor ("Commercial Contributor") hereby agrees to defend and +indemnify every other Contributor ("Indemnified Contributor") against any +losses, damages and costs (collectively "Losses") arising from claims, +lawsuits and other legal actions brought by a third party against the +Indemnified Contributor to the extent caused by the acts or omissions of +such Commercial Contributor in connection with its distribution of the Program +in a commercial product offering. The obligations in this section do not apply +to any claims or Losses relating to any actual or alleged intellectual +property infringement. In order to qualify, an Indemnified Contributor must: +a) promptly notify the Commercial Contributor in writing of such claim, +and b) allow the Commercial Contributor to control, and cooperate with the +Commercial Contributor in, the defense and any related settlement +negotiations. The Indemnified Contributor may participate in any such +claim at its own expense. + +For example, a Contributor might include the Program in a commercial product +offering, Product X. That Contributor is then a Commercial Contributor. +If that Commercial Contributor then makes performance claims, or offers +warranties related to Product X, those performance claims and warranties +are such Commercial Contributor's responsibility alone. Under this section, +the Commercial Contributor would have to defend claims against the other +Contributors related to those performance claims and warranties, and if a +court requires any other Contributor to pay any damages as a result, +the Commercial Contributor must pay those damages. + +5. NO WARRANTY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR +IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, +NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. +Each Recipient is solely responsible for determining the appropriateness of +using and distributing the Program and assumes all risks associated with its +exercise of rights under this Agreement , including but not limited to the +risks and costs of program errors, compliance with applicable laws, damage to +or loss of data, programs or equipment, and unavailability +or interruption of operations. + +6. DISCLAIMER OF LIABILITY + +EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY +CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION +LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE +EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + +7. GENERAL + +If any provision of this Agreement is invalid or unenforceable under +applicable law, it shall not affect the validity or enforceability of the +remainder of the terms of this Agreement, and without further action by +the parties hereto, such provision shall be reformed to the minimum extent +necessary to make such provision valid and enforceable. + +If Recipient institutes patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Program itself +(excluding combinations of the Program with other software or hardware) +infringes such Recipient's patent(s), then such Recipient's rights granted +under Section 2(b) shall terminate as of the date such litigation is filed. + +All Recipient's rights under this Agreement shall terminate if it fails to +comply with any of the material terms or conditions of this Agreement and +does not cure such failure in a reasonable period of time after becoming +aware of such noncompliance. If all Recipient's rights under this +Agreement terminate, Recipient agrees to cease use and distribution of the +Program as soon as reasonably practicable. However, Recipient's obligations +under this Agreement and any licenses granted by Recipient relating to the +Program shall continue and survive. + +Everyone is permitted to copy and distribute copies of this Agreement, +but in order to avoid inconsistency the Agreement is copyrighted and may +only be modified in the following manner. The Agreement Steward reserves +the right to publish new versions (including revisions) of this Agreement +from time to time. No one other than the Agreement Steward has the right to +modify this Agreement. The Eclipse Foundation is the initial +Agreement Steward. The Eclipse Foundation may assign the responsibility to +serve as the Agreement Steward to a suitable separate entity. Each new version +of the Agreement will be given a distinguishing version number. The Program +(including Contributions) may always be distributed subject to the version +of the Agreement under which it was received. In addition, after a new version +of the Agreement is published, Contributor may elect to distribute the Program +(including its Contributions) under the new version. Except as expressly +stated in Sections 2(a) and 2(b) above, Recipient receives no rights or +licenses to the intellectual property of any Contributor under this Agreement, +whether expressly, by implication, estoppel or otherwise. All rights in the +Program not expressly granted under this Agreement are reserved. + +This Agreement is governed by the laws of the State of New York and the +intellectual property laws of the United States of America. No party to +this Agreement will bring a legal action under this Agreement more than one +year after the cause of action arose. Each party waives its rights to a +jury trial in any resulting litigation. diff --git a/README.md b/README.md index d812afff0b..70de378686 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,40 @@ -# Welcome to H2, the Java SQL database. [![Build Status](https://travis-ci.org/h2database/h2database.svg?branch=master)](https://travis-ci.org/h2database/h2database) +[![CI](h2/src/docsrc/images/h2-logo-2.png)](https://github.com/h2database/h2database/actions?query=workflow%3ACI) +# Welcome to H2, the Java SQL database. ## The main features of H2 are: -1. Very fast, open source, JDBC API -2. Embedded and server modes; in-memory databases -3. Browser based Console application -4. Small footprint: around 2 MB jar file size - -More information: http://h2database.com - -## Features - -| | [H2](http://www.h2database.com/) | [Derby](http://db.apache.org/derby) | [HSQLDB](http://hsqldb.org) | [MySQL](https://www.mysql.com/) | [PostgreSQL](https://www.postgresql.org) | -|--------------------------------|---------|---------|---------|-------|---------| -| Pure Java | Yes | Yes | Yes | No | No | -| Memory Mode | Yes | Yes | Yes | No | No | -| Encrypted Database | Yes | Yes | Yes | No | No | -| ODBC Driver | Yes | No | No | Yes | Yes | -| Fulltext Search | Yes | No | No | Yes | Yes | -| Multi Version Concurrency | Yes | No | Yes | Yes | Yes | -| Footprint (embedded database) | ~2 MB | ~3 MB | ~1.5 MB | — | — | -| Footprint (JDBC client driver) | ~500 KB | ~600 KB | ~1.5 MB | ~1 MB | ~700 KB | +* Very fast, open source, JDBC API +* Embedded and server modes; disk-based or in-memory databases +* Transaction support, multi-version concurrency +* Browser based Console application +* Encrypted databases +* Fulltext search +* Pure Java with small footprint: around 2.5 MB jar file size +* ODBC driver + +More information: https://h2database.com + +## Downloads + +[Download latest version](https://h2database.com/html/download.html) or add to `pom.xml`: + +```XML + + com.h2database + h2 + 2.1.210 + +``` + +## Documentation + +* [Tutorial](https://h2database.com/html/tutorial.html) +* [SQL commands](https://h2database.com/html/commands.html) +* [Functions](https://h2database.com/html/functions.html), [aggregate functions](https://h2database.com/html/functions-aggregate.html), [window functions](https://h2database.com/html/functions-window.html) +* [Data types](https://h2database.com/html/datatypes.html) + +## Support + +* [Issue tracker](https://github.com/h2database/h2database/issues) for bug reports and feature requests +* [Mailing list / forum](https://groups.google.com/g/h2-database) for questions about H2 +* ['h2' tag on Stack Overflow](https://stackoverflow.com/questions/tagged/h2) for other questions (Hibernate with H2 etc.) diff --git a/h2/.gitignore b/h2/.gitignore index 05251400f0..b90461133b 100644 --- a/h2/.gitignore +++ b/h2/.gitignore @@ -14,5 +14,4 @@ test.out.txt .idea/ *.log target/ -src/main/org/h2/res/help.csv _tmp* diff --git a/h2/.mvn/wrapper/maven-wrapper.properties b/h2/.mvn/wrapper/maven-wrapper.properties index eb91947648..c9023edfe7 100644 --- a/h2/.mvn/wrapper/maven-wrapper.properties +++ b/h2/.mvn/wrapper/maven-wrapper.properties @@ -1 +1 @@ -distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.3.3/apache-maven-3.3.3-bin.zip \ No newline at end of file +distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.4/apache-maven-3.5.4-bin.zip \ No newline at end of file diff --git a/h2/MAVEN.md b/h2/MAVEN.md index 6636fcd9b8..427fa8a622 100644 --- a/h2/MAVEN.md +++ b/h2/MAVEN.md @@ -5,24 +5,59 @@ Welcome to H2, the Java SQL database. The main features of H2 are: * Very fast, open source, JDBC API * Embedded and server modes; in-memory databases * Browser based Console application -* Small footprint: around 1.5 MB jar file size +* Small footprint: around 2.5 MB jar file size ## Experimental Building & Testing with Maven +### Preparation + +Use non-Maven build to create all necessary resources: + +```Batchfile +./build.cmd compile +``` + +or + +```sh +./build.sh compile +``` + ### Building -H2 uses [Maven Wrapper](https://github.com/takari/maven-wrapper) setup, you can instruct users to run wrapper scripts: +To build only the database jar use + +```sh +mvn -Dmaven.test.skip=true package +``` + +If you don't have Maven installed use included [Maven Wrapper](https://github.com/takari/maven-wrapper) setup: -> $ ./mvnw clean test +```sh +./mvnw -Dmaven.test.skip=true package +``` or -> $ ./mvnw.cmd clean test +```Batchfile +./mvnw.cmd -Dmaven.test.skip=true package +``` + +Please note that jar generated with Maven is larger than official one and it does not include OSGi attributes. +Use build script with `jar` target instead if you need a compatible jar. + +### Testing + +To run the tests use + +```sh +mvn clean test +``` ### Running You can run the server like this -``` +```sh mvn exec:java -Dexec.mainClass=org.h2.tools.Server -``` \ No newline at end of file +``` diff --git a/h2/build.sh b/h2/build.sh index 7196287ca4..558a7945ab 100755 --- a/h2/build.sh +++ b/h2/build.sh @@ -1,11 +1,16 @@ #!/bin/sh if [ -z "$JAVA_HOME" ] ; then - if [ -d "/System/Library/Frameworks/JavaVM.framework/Home" ] ; then - export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home - else - echo "Error: JAVA_HOME is not defined." + if [[ "$OSTYPE" == "darwin"* ]]; then + if [ -d "/System/Library/Frameworks/JavaVM.framework/Home" ] ; then + export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home + else + export JAVA_HOME=`/usr/libexec/java_home` + fi fi fi +if [ -z "$JAVA_HOME" ] ; then + echo "Error: JAVA_HOME is not defined." +fi if [ "$1" = "clean" ] ; then rm -rf temp bin ; fi if [ ! -d "temp" ] ; then mkdir temp ; fi if [ ! -d "bin" ] ; then mkdir bin ; fi diff --git a/h2/pom.xml b/h2/pom.xml index fbe53597c4..a0c0085569 100644 --- a/h2/pom.xml +++ b/h2/pom.xml @@ -4,10 +4,10 @@ com.h2database h2 - 1.4.196-SNAPSHOT + 2.1.210 jar H2 Database Engine - http://www.h2database.com + https://h2database.com H2 Database Engine @@ -37,11 +37,17 @@ - 1.7 - 1.7 - 10.10.1.1 - 4.2.0 - 1.6.0 + 1.8 + 1.8 + 8.0.1 + 1.17.0 + 5.6.2 + 8.5.2 + 5.0.0 + 42.2.14 + 4.0.1 + 5.0.0 + 1.7.30 UTF-8 @@ -51,12 +57,27 @@ javax.servlet javax.servlet-api - 3.1.0 + ${javax.servlet.version} + + + jakarta.servlet + jakarta.servlet-api + ${jakarta.servlet.version} org.apache.lucene lucene-core - 3.6.2 + ${lucene.version} + + + org.apache.lucene + lucene-analyzers-common + ${lucene.version} + + + org.apache.lucene + lucene-queryparser + ${lucene.version} org.slf4j @@ -76,7 +97,7 @@ org.locationtech.jts jts-core - 1.15.0 + ${jts.version} @@ -84,67 +105,41 @@ org.slf4j - slf4j-simple + slf4j-nop ${slf4j.version} test - - org.hsqldb - hsqldb - 2.3.2 - test - - - org.apache.derby - derby - ${derby.version} - test - - - org.apache.derby - derbyclient - ${derby.version} - test - - - org.apache.derby - derbynet - ${derby.version} - test - org.postgresql postgresql - 9.4.1209.jre6 + ${pgjdbc.version} test - mysql - mysql-connector-java - 5.1.6 + org.junit.jupiter + junit-jupiter-engine + ${junit.version} test - junit - junit - 4.12 + org.ow2.asm + asm + ${asm.version} test - - - - com.sun - tools - 1.7 - system - ${tools.jar} - + + jigsaw-jdk + + [1.9,) + + + default-tools.jar @@ -152,9 +147,15 @@ ${java.home}/../lib/tools.jar - - ${java.home}/../lib/tools.jar - + + + com.sun + tools + system + 1.8 + ${java.home}/../lib/tools.jar + + default-tools.jar-mac @@ -163,9 +164,15 @@ ${java.home}/../Classes/classes.jar - - ${java.home}/../Classes/classes.jar - + + + com.sun + tools + system + 1.8 + ${java.home}/../Classes/classes.jar + + @@ -186,22 +193,49 @@ **/*.js org/h2/res/help.csv org/h2/res/javadoc.properties - org/h2/server/pg/pg_catalog.sql + META-INF/** + + src/java9/precompiled + META-INF/versions/9 + + + src/java10/precompiled + META-INF/versions/10 + src/test - org/h2/test/scripts/testSimple.in.txt - org/h2/test/scripts/testScript.sql + org/h2/test/bench/test.properties + org/h2/test/script/testScrip.sql + org/h2/test/scripts/**/*.sql org/h2/samples/newsfeed.sql org/h2/samples/optimizations.sql + + org.apache.maven.plugins + maven-jar-plugin + 3.1.2 + + + + true + org.h2.tools.Console + + + com.h2database + true + org.h2.util.Profiler + + + + org.codehaus.mojo @@ -221,53 +255,10 @@ - - org.apache.maven.plugins maven-surefire-plugin - 2.20.1 + 2.22.2 TestAllJunit.java @@ -278,5 +269,4 @@ - diff --git a/h2/src/docsrc/help/help.csv b/h2/src/docsrc/help/help.csv deleted file mode 100644 index a9afbe8ece..0000000000 --- a/h2/src/docsrc/help/help.csv +++ /dev/null @@ -1,4591 +0,0 @@ -# Copyright 2004-2018 H2 Group. Multiple-Licensed under the MPL 2.0, -# and the EPL 1.0 (http://h2database.com/html/license.html). -# Initial Developer: H2 Group -"SECTION","TOPIC","SYNTAX","TEXT","EXAMPLE" -"Commands (DML)","SELECT"," -SELECT [ TOP term ] [ DISTINCT | ALL ] selectExpression [,...] -FROM tableExpression [,...] [ WHERE expression ] -[ GROUP BY expression [,...] ] [ HAVING expression ] -[ { UNION [ ALL ] | MINUS | EXCEPT | INTERSECT } select ] -[ ORDER BY order [,...] ] -[ { LIMIT expression [ OFFSET expression ] [ SAMPLE_SIZE rowCountInt ] } - | { [ OFFSET expression { ROW | ROWS } ] - [ { FETCH { FIRST | NEXT } expression { ROW | ROWS } ONLY } ] } ] -[ FOR UPDATE ] -"," -Selects data from a table or multiple tables. -GROUP BY groups the the result by the given expression(s). -HAVING filter rows after grouping. -ORDER BY sorts the result by the given column(s) or expression(s). -UNION combines the result of this query with the results of another query. - -LIMIT and FETCH FIRST/NEXT ROW(S) ONLY limits the number of rows returned by the query (no limit if null or smaller than zero). -OFFSET specified how many rows to skip. -Please note using high offset values should be avoided because it can cause performance problems. -SAMPLE_SIZE limits the number of rows read for aggregate queries. - -Multiple set operators (UNION, INTERSECT, MINUS, EXCEPT) are evaluated -from left to right. For compatibility with other databases and future versions -of H2 please use parentheses. - -If FOR UPDATE is specified, the tables are locked for writing. When using -MVCC, only the selected rows are locked as in an UPDATE statement. -In this case, aggregate, GROUP BY, DISTINCT queries or joins -are not allowed in this case. -"," -SELECT * FROM TEST; -SELECT * FROM TEST ORDER BY NAME; -SELECT ID, COUNT(*) FROM TEST GROUP BY ID; -SELECT NAME, COUNT(*) FROM TEST GROUP BY NAME HAVING COUNT(*) > 2; -SELECT 'ID' COL, MAX(ID) AS MAX FROM TEST UNION SELECT 'NAME', MAX(NAME) FROM TEST; -SELECT * FROM TEST LIMIT 1000; -SELECT * FROM (SELECT ID, COUNT(*) FROM TEST - GROUP BY ID UNION SELECT NULL, COUNT(*) FROM TEST) - ORDER BY 1 NULLS LAST; -" - -"Commands (DML)","INSERT"," -INSERT INTO tableName -{ [ ( columnName [,...] ) ] - { VALUES { ( { DEFAULT | expression } [,...] ) } [,...] - | [ DIRECT ] [ SORTED ] select } } | - { SET { columnName = { DEFAULT | expression } } [,...] } -"," -Inserts a new row / new rows into a table. - -When using DIRECT, then the results from the query are directly applied in the target table without any intermediate step. - -When using SORTED, b-tree pages are split at the insertion point. This can improve performance and reduce disk usage. -"," -INSERT INTO TEST VALUES(1, 'Hello') -" - -"Commands (DML)","UPDATE"," -UPDATE tableName [ [ AS ] newTableAlias ] SET -{ { columnName = { DEFAULT | expression } } [,...] } | - { ( columnName [,...] ) = ( select ) } -[ WHERE expression ] [ ORDER BY order [,...] ] [ LIMIT expression ] -"," -Updates data in a table. -ORDER BY is supported for MySQL compatibility, but it is ignored. -"," -UPDATE TEST SET NAME='Hi' WHERE ID=1; -UPDATE PERSON P SET NAME=(SELECT A.NAME FROM ADDRESS A WHERE A.ID=P.ID); -" - -"Commands (DML)","DELETE"," -DELETE [ TOP term ] FROM tableName [ WHERE expression ] [ LIMIT term ] -"," -Deletes rows form a table. -If TOP or LIMIT is specified, at most the specified number of rows are deleted (no limit if null or smaller than zero). -"," -DELETE FROM TEST WHERE ID=2 -" - -"Commands (DML)","BACKUP"," -BACKUP TO fileNameString -"," -Backs up the database files to a .zip file. Objects are not locked, but -the backup is transactionally consistent because the transaction log is also copied. -Admin rights are required to execute this command. -"," -BACKUP TO 'backup.zip' -" - -"Commands (DML)","CALL"," -CALL expression -"," -Calculates a simple expression. This statement returns a result set with one row, -except if the called function returns a result set itself. -If the called function returns an array, then each element in this array is returned as a column. -"," -CALL 15*25 -" - -"Commands (DML)","EXPLAIN"," -EXPLAIN { [ PLAN FOR ] | ANALYZE } -{ select | insert | update | delete | merge } -"," -Shows the execution plan for a statement. -When using EXPLAIN ANALYZE, the statement is actually executed, and the query plan -will include the actual row scan count for each table. -"," -EXPLAIN SELECT * FROM TEST WHERE ID=1 -" - -"Commands (DML)","MERGE"," -MERGE INTO tableName [ ( columnName [,...] ) ] -[ KEY ( columnName [,...] ) ] -{ VALUES { ( { DEFAULT | expression } [,...] ) } [,...] | select } -"," -Updates existing rows, and insert rows that don't exist. If no key column is -specified, the primary key columns are used to find the row. If more than one -row per new row is affected, an exception is thrown. -"," -MERGE INTO TEST KEY(ID) VALUES(2, 'World') -" - -"Commands (DML)","MERGE USING"," -MERGE INTO targetTableName [ [AS] targetAlias] -USING { ( select ) | sourceTableName }[ [AS] sourceAlias ] -ON ( expression ) -[ WHEN MATCHED THEN [ update ] [ delete] ] -[ WHEN NOT MATCHED THEN insert ] -"," -Updates or deletes existing rows, and insert rows that don't exist. The ON clause -specifies the matching column expression and must be specified. If more than one row -is updated per input row, an exception is thrown. -If the source data contains duplicate rows (specifically those columns used in the -row matching ON clause), then an exception is thrown to prevent two updates applying -to the same target row. The embedded update, delete or insert statements can not re-specify -the target table name. -"," -MERGE INTO TARGET_TABLE AS T USING SOURCE_TABLE AS S - ON (T.ID = S.ID) - WHEN MATCHED THEN - UPDATE SET T.COL1 = S.COL1 WHERE T.COL2<>'FINAL' - DELETE WHERE T.COL2='FINAL' - WHEN NOT MATCHED THEN - INSERT (ID,COL1,COL2) VALUES(S.ID,S.COL1,S.COL2) -MERGE INTO TARGET_TABLE AS T USING (SELECT * FROM SOURCE_TABLE) AS S - ON (T.ID = S.ID) - WHEN MATCHED THEN - UPDATE SET T.COL1 = S.COL1 WHERE T.COL2<>'FINAL' - DELETE WHERE T.COL2='FINAL' - WHEN NOT MATCHED THEN - INSERT (ID,COL1,COL2) VALUES(S.ID,S.COL1,S.COL2) -" - -"Commands (DML)","RUNSCRIPT"," -RUNSCRIPT FROM fileNameString scriptCompressionEncryption -[ CHARSET charsetString ] -"," -Runs a SQL script from a file. The script is a text file containing SQL -statements; each statement must end with ';'. This command can be used to -restore a database from a backup. The password must be in single quotes; it is -case sensitive and can contain spaces. - -Instead of a file name, an URL may be used. -To read a stream from the classpath, use the prefix 'classpath:'. -See the Pluggable File System section on the Advanced page. - -The compression algorithm must match the one used when creating the script. -Instead of a file, an URL may be used. - -Admin rights are required to execute this command. -"," -RUNSCRIPT FROM 'backup.sql' -RUNSCRIPT FROM 'classpath:/com/acme/test.sql' -" - -"Commands (DML)","SCRIPT"," -SCRIPT [ SIMPLE ] [ NODATA ] [ NOPASSWORDS ] [ NOSETTINGS ] -[ DROP ] [ BLOCKSIZE blockSizeInt ] -[ TO fileNameString scriptCompressionEncryption - [ CHARSET charsetString ] ] -[ TABLE tableName [, ...] ] -[ SCHEMA schemaName [, ...] ] -"," -Creates a SQL script from the database. - -SIMPLE does not use multi-row insert statements. -NODATA will not emit INSERT statements. -If the DROP option is specified, drop statements are created for tables, views, -and sequences. If the block size is set, CLOB and BLOB values larger than this -size are split into separate blocks. -BLOCKSIZE is used when writing out LOB data, and specifies the point at the -values transition from being inserted as inline values, to be inserted using -out-of-line commands. -NOSETTINGS turns off dumping the database settings (the SET XXX commands) - -If no 'TO fileName' clause is specified, the -script is returned as a result set. This command can be used to create a backup -of the database. For long term storage, it is more portable than copying the -database files. - -If a 'TO fileName' clause is specified, then the whole -script (including insert statements) is written to this file, and a result set -without the insert statements is returned. - -The password must be in single quotes; it is case sensitive and can contain spaces. - -This command locks objects while it is running. -Admin rights are required to execute this command. - -When using the TABLE or SCHEMA option, only the selected table(s) / schema(s) are included. -"," -SCRIPT NODATA -" - -"Commands (DML)","SHOW"," -SHOW { SCHEMAS | TABLES [ FROM schemaName ] | - COLUMNS FROM tableName [ FROM schemaName ] } -"," -Lists the schemas, tables, or the columns of a table. -"," -SHOW TABLES -" - -"Commands (DML)","WITH"," -WITH [ RECURSIVE ] { name [( columnName [,...] )] AS ( select ) [,...] } -{ select | insert | update | merge | delete | createTable } -"," -Can be used to create a recursive or non-recursive query (common table expression). -For recursive queries the first select has to be a UNION. -One or more common table entries can be referred to by name. -Column name declarations are now optional - the column names will be inferred from the named select queries. -The final action in a WITH statement can be a select, insert, update, merge, delete or create table. -"," -WITH RECURSIVE cte(n) AS ( - SELECT 1 - UNION ALL - SELECT n + 1 - FROM cte - WHERE n < 100 -) -SELECT sum(n) FROM cte; - -Example 2: -WITH cte1 AS ( - SELECT 1 AS FIRST_COLUMN -), cte2 AS ( - SELECT FIRST_COLUMN+1 AS FIRST_COLUMN FROM cte1 -) -SELECT sum(FIRST_COLUMN) FROM cte2; -" - -"Commands (DDL)","ALTER INDEX RENAME"," -ALTER INDEX [ IF EXISTS ] indexName RENAME TO newIndexName -"," -Renames an index. -This command commits an open transaction in this connection. -"," -ALTER INDEX IDXNAME RENAME TO IDX_TEST_NAME -" - -"Commands (DDL)","ALTER SCHEMA RENAME"," -ALTER SCHEMA [ IF EXISTS ] schema RENAME TO newSchemaName -"," -Renames a schema. -This command commits an open transaction in this connection. -"," -ALTER SCHEMA TEST RENAME TO PRODUCTION -" - -"Commands (DDL)","ALTER SEQUENCE"," -ALTER SEQUENCE [ IF EXISTS ] sequenceName -[ RESTART WITH long ] -[ INCREMENT BY long ] -[ MINVALUE long | NOMINVALUE | NO MINVALUE ] -[ MAXVALUE long | NOMAXVALUE | NO MAXVALUE ] -[ CYCLE long | NOCYCLE | NO CYCLE ] -[ CACHE long | NOCACHE | NO CACHE ] -"," -Changes the parameters of a sequence. -This command does not commit the current transaction; however the new value is used by other -transactions immediately, and rolling back this command has no effect. -"," -ALTER SEQUENCE SEQ_ID RESTART WITH 1000 -" - -"Commands (DDL)","ALTER TABLE ADD"," -ALTER TABLE [ IF EXISTS ] tableName ADD [ COLUMN ] -{ [ IF NOT EXISTS ] columnName columnDefinition - | ( { columnName columnDefinition | constraint } [,...] ) } -[ { { BEFORE | AFTER } columnName } | FIRST ] -"," -Adds a new column to a table. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST ADD CREATEDATE TIMESTAMP -" - -"Commands (DDL)","ALTER TABLE ADD CONSTRAINT"," -ALTER TABLE [ IF EXISTS ] tableName ADD constraint [ CHECK | NOCHECK ] -"," -Adds a constraint to a table. If NOCHECK is specified, existing rows are not -checked for consistency (the default is to check consistency for existing rows). -The required indexes are automatically created if they don't exist yet. -It is not possible to disable checking for unique constraints. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST ADD CONSTRAINT NAME_UNIQUE UNIQUE(NAME) -" - -"Commands (DDL)","ALTER TABLE RENAME CONSTRAINT"," -ALTER TABLE [ IF EXISTS ] tableName RENAME oldConstraintName -TO newConstraintName -"," -Renames a constraint. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST RENAME CONSTRAINT FOO TO BAR -" - -"Commands (DDL)","ALTER TABLE ALTER COLUMN"," -ALTER TABLE [ IF EXISTS ] tableName ALTER COLUMN columnName -{ { columnDefinition } - | { RENAME TO name } - | { RESTART WITH long } - | { SELECTIVITY int } - | { SET DEFAULT expression } - | { SET ON UPDATE expression } - | { SET NULL } - | { SET NOT NULL } - | { SET { VISIBLE | INVISIBLE } } - | { DROP { DEFAULT | ON UPDATE } } } -"," -Changes the data type of a column, rename a column, -change the identity value, or change the selectivity. - -Changing the data type fails if the data can not be converted. - -RESTART changes the next value of an auto increment column. -The column must already be an auto increment column. -For RESTART, the same transactional rules as for ALTER SEQUENCE apply. - -SELECTIVITY sets the selectivity (1-100) for a column. -Setting the selectivity to 0 means the default value. -Selectivity is used by the cost based optimizer to calculate the estimated cost of an index. -Selectivity 100 means values are unique, 10 means every distinct value appears 10 times on average. - -SET DEFAULT changes the default value of a column. - -SET ON UPDATE changes the value that is set on update if value for this column is not specified in update statement. - -SET NULL sets a column to allow NULL. The row may not be part of a primary key. -Single column indexes on this column are dropped. - -SET NOT NULL sets a column to not allow NULL. Rows may not contains NULL in this column. - -SET INVISIBLE makes the column hidden, i.e. it will not appear in SELECT * results. -SET VISIBLE has the reverse effect. - -DROP DEFAULT removes the default value of a column. - -DROP ON UPDATE removes the value that is set on update of a column. - -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST ALTER COLUMN NAME CLOB; -ALTER TABLE TEST ALTER COLUMN NAME RENAME TO TEXT; -ALTER TABLE TEST ALTER COLUMN ID RESTART WITH 10000; -ALTER TABLE TEST ALTER COLUMN NAME SELECTIVITY 100; -ALTER TABLE TEST ALTER COLUMN NAME SET DEFAULT ''; -ALTER TABLE TEST ALTER COLUMN NAME SET NOT NULL; -ALTER TABLE TEST ALTER COLUMN NAME SET NULL; -ALTER TABLE TEST ALTER COLUMN NAME SET VISIBLE; -ALTER TABLE TEST ALTER COLUMN NAME SET INVISIBLE; -" - -"Commands (DDL)","ALTER TABLE DROP COLUMN"," -ALTER TABLE [ IF EXISTS ] tableName DROP COLUMN [ IF EXISTS ] -columnName [,...] | ( columnName [,...] ) -"," -Removes column(s) from a table. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST DROP COLUMN NAME -ALTER TABLE TEST DROP COLUMN NAME1, NAME2 -ALTER TABLE TEST DROP COLUMN (NAME1, NAME2) -" - -"Commands (DDL)","ALTER TABLE DROP CONSTRAINT"," -ALTER TABLE [ IF EXISTS ] tableName DROP -{ CONSTRAINT [ IF EXISTS ] constraintName | PRIMARY KEY } -"," -Removes a constraint or a primary key from a table. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST DROP CONSTRAINT UNIQUE_NAME -" - -"Commands (DDL)","ALTER TABLE SET"," -ALTER TABLE [ IF EXISTS ] tableName SET REFERENTIAL_INTEGRITY -{ FALSE | TRUE } [ CHECK | NOCHECK ] -"," -Disables or enables referential integrity checking for a table. This command can -be used inside a transaction. Enabling referential integrity does not check -existing data, except if CHECK is specified. Use SET REFERENTIAL_INTEGRITY to -disable it for all tables; the global flag and the flag for each table are -independent. - -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST SET REFERENTIAL_INTEGRITY FALSE -" - -"Commands (DDL)","ALTER TABLE RENAME"," -ALTER TABLE [ IF EXISTS ] tableName RENAME TO newName -"," -Renames a table. -This command commits an open transaction in this connection. -"," -ALTER TABLE TEST RENAME TO MY_DATA -" - -"Commands (DDL)","ALTER USER ADMIN"," -ALTER USER userName ADMIN { TRUE | FALSE } -"," -Switches the admin flag of a user on or off. - -Only unquoted or uppercase user names are allowed. -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -ALTER USER TOM ADMIN TRUE -" - -"Commands (DDL)","ALTER USER RENAME"," -ALTER USER userName RENAME TO newUserName -"," -Renames a user. -After renaming a user, the password becomes invalid and needs to be changed as well. - -Only unquoted or uppercase user names are allowed. -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -ALTER USER TOM RENAME TO THOMAS -" - -"Commands (DDL)","ALTER USER SET PASSWORD"," -ALTER USER userName SET { PASSWORD string | SALT bytes HASH bytes } -"," -Changes the password of a user. -Only unquoted or uppercase user names are allowed. -The password must be enclosed in single quotes. It is case sensitive -and can contain spaces. The salt and hash values are hex strings. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -ALTER USER SA SET PASSWORD 'rioyxlgt' -" - -"Commands (DDL)","ALTER VIEW"," -ALTER VIEW [ IF EXISTS ] viewName RECOMPILE -"," -Recompiles a view after the underlying tables have been changed or created. -This command is used for views created using CREATE FORCE VIEW. -This command commits an open transaction in this connection. -"," -ALTER VIEW ADDRESS_VIEW RECOMPILE -" - -"Commands (DDL)","ANALYZE"," -ANALYZE [ TABLE tableName ] [ SAMPLE_SIZE rowCountInt ] -"," -Updates the selectivity statistics of tables. -If no table name is given, all tables are analyzed. -The selectivity is used by the -cost based optimizer to select the best index for a given query. If no sample -size is set, up to 10000 rows per table are read. The value 0 means all rows are -read. The selectivity can be set manually using ALTER TABLE ALTER COLUMN -SELECTIVITY. Manual values are overwritten by this statement. The selectivity is -available in the INFORMATION_SCHEMA.COLUMNS table. - -This command commits an open transaction in this connection. -"," -ANALYZE SAMPLE_SIZE 1000 -" - -"Commands (DDL)","COMMENT"," -COMMENT ON -{ { COLUMN [ schemaName. ] tableName.columnName } - | { { TABLE | VIEW | CONSTANT | CONSTRAINT | ALIAS | INDEX | ROLE - | SCHEMA | SEQUENCE | TRIGGER | USER | DOMAIN } [ schemaName. ] objectName } } -IS expression -"," -Sets the comment of a database object. Use NULL to remove the comment. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -COMMENT ON TABLE TEST IS 'Table used for testing' -" - -"Commands (DDL)","CREATE AGGREGATE"," -CREATE AGGREGATE [ IF NOT EXISTS ] newAggregateName FOR className -"," -Creates a new user-defined aggregate function. The method name must be the full -qualified class name. The class must implement the interface -""org.h2.api.AggregateFunction"". - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -CREATE AGGREGATE SIMPLE_MEDIAN FOR ""com.acme.db.Median"" -" - -"Commands (DDL)","CREATE ALIAS"," -CREATE ALIAS [ IF NOT EXISTS ] newFunctionAliasName [ DETERMINISTIC ] -[ NOBUFFER ] { FOR classAndMethodName | AS sourceCodeString } -"," -Creates a new function alias. If this is a ResultSet returning function, -by default the return value is cached in a local temporary file. - -NOBUFFER - disables caching of ResultSet return value to temporary file. - -DETERMINISTIC - Deterministic functions must always return the same value for the same parameters. - -The method name must be the full qualified class and method name, -and may optionally include the parameter classes as in -""java.lang.Integer.parseInt(java.lang.String, int)"". The class and the method -must both be public, and the method must be static. The class must be available -in the classpath of the database engine (when using the server mode, -it must be in the classpath of the server). - -When defining a function alias with source code, the Sun ""javac"" is compiler -is used if the file ""tools.jar"" is in the classpath. If not, ""javac"" is run as a separate process. -Only the source code is stored in the database; the class is compiled each time -the database is re-opened. Source code is usually passed -as dollar quoted text to avoid escaping problems. If import statements are used, -then the tag @CODE must be added before the method. - -If the method throws an SQLException, it is directly re-thrown to the calling application; -all other exceptions are first converted to a SQLException. - -If the first parameter of the Java function is a ""java.sql.Connection"", then a -connection to the database is provided. This connection must not be closed. -If the class contains multiple methods with the given name but different -parameter count, all methods are mapped. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. - -If you have the Groovy jar in your classpath, it is also possible to write methods using Groovy. -"," -CREATE ALIAS MY_SQRT FOR ""java.lang.Math.sqrt""; -CREATE ALIAS GET_SYSTEM_PROPERTY FOR ""java.lang.System.getProperty""; -CALL GET_SYSTEM_PROPERTY('java.class.path'); -CALL GET_SYSTEM_PROPERTY('com.acme.test', 'true'); -CREATE ALIAS REVERSE AS $$ String reverse(String s) { return new StringBuilder(s).reverse().toString(); } $$; -CALL REVERSE('Test'); -CREATE ALIAS tr AS $$@groovy.transform.CompileStatic - static String tr(String str, String sourceSet, String replacementSet){ - return str.tr(sourceSet, replacementSet); - } -$$ -" - -"Commands (DDL)","CREATE CONSTANT"," -CREATE CONSTANT [ IF NOT EXISTS ] newConstantName VALUE expression -"," -Creates a new constant. -This command commits an open transaction in this connection. -"," -CREATE CONSTANT ONE VALUE 1 -" - -"Commands (DDL)","CREATE DOMAIN"," -CREATE DOMAIN [ IF NOT EXISTS ] newDomainName AS dataType -[ DEFAULT expression ] [ [ NOT ] NULL ] [ SELECTIVITY selectivity ] -[ CHECK condition ] -"," -Creates a new data type (domain). The check condition must evaluate to true or -to NULL (to prevent NULL, use ""NOT NULL""). In the condition, the term VALUE refers -to the value being tested. - -Domains are usable within the whole database. They can not be created in a specific schema. - -This command commits an open transaction in this connection. -"," -CREATE DOMAIN EMAIL AS VARCHAR(255) CHECK (POSITION('@', VALUE) > 1) -" - -"Commands (DDL)","CREATE INDEX"," -CREATE -{ [ UNIQUE ] [ HASH | SPATIAL] INDEX [ [ IF NOT EXISTS ] newIndexName ] - | PRIMARY KEY [ HASH ] } -ON tableName ( indexColumn [,...] ) -"," -Creates a new index. -This command commits an open transaction in this connection. - -Hash indexes are meant for in-memory databases and memory tables (CREATE MEMORY TABLE). -For other tables, or if the index contains multiple columns, the HASH keyword is ignored. -Hash indexes can only test for equality, and do not support range queries (similar to a hash table). -Non-unique keys are supported. -Spatial indexes are supported only on Geometry columns. -"," -CREATE INDEX IDXNAME ON TEST(NAME) -" - -"Commands (DDL)","CREATE LINKED TABLE"," -CREATE [ FORCE ] [ [ GLOBAL | LOCAL ] TEMPORARY ] -LINKED TABLE [ IF NOT EXISTS ] -name ( driverString, urlString, userString, passwordString, -[ originalSchemaString, ] originalTableString ) [ EMIT UPDATES | READONLY ] -"," -Creates a table link to an external table. The driver name may be empty if the -driver is already loaded. If the schema name is not set, only one table with -that name may exist in the target database. - -FORCE - Create the LINKED TABLE even if the remote database/table does not exist. - -EMIT UPDATES - Usually, for update statements, the old rows are deleted first and then the new -rows are inserted. It is possible to emit update statements (except on -rollback), however in this case multi-row unique key updates may not always -work. Linked tables to the same database share one connection. - -READONLY - is set, the remote table may not be updated. This is enforced by H2. - -If the connection to the source database is lost, the connection is re-opened -(this is a workaround for MySQL that disconnects after 8 hours of inactivity by default). - -If a query is used instead of the original table name, the table is read only. -Queries must be enclosed in parenthesis: ""(SELECT * FROM ORDERS)"". - -To use JNDI to get the connection, the driver class must be a -javax.naming.Context (for example ""javax.naming.InitialContext""), and the URL must -be the resource name (for example ""java:comp/env/jdbc/Test""). - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -CREATE LINKED TABLE LINK('org.h2.Driver', 'jdbc:h2:test2', - 'sa', 'sa', 'TEST'); -CREATE LINKED TABLE LINK('', 'jdbc:h2:test2', 'sa', 'sa', - '(SELECT * FROM TEST WHERE ID>0)'); -CREATE LINKED TABLE LINK('javax.naming.InitialContext', - 'java:comp/env/jdbc/Test', NULL, NULL, - '(SELECT * FROM TEST WHERE ID>0)'); -" - -"Commands (DDL)","CREATE ROLE"," -CREATE ROLE [ IF NOT EXISTS ] newRoleName -"," -Creates a new role. -This command commits an open transaction in this connection. -"," -CREATE ROLE READONLY -" - -"Commands (DDL)","CREATE SCHEMA"," -CREATE SCHEMA [ IF NOT EXISTS ] name -[ AUTHORIZATION ownerUserName ] -[ WITH tableEngineParamName [,...] ] -"," -Creates a new schema. If no owner is specified, the current user is used. The -user that executes the command must have admin rights, as well as the owner. -Specifying the owner currently has no effect. -Optional table engine parameters are used when CREATE TABLE command -is run on this schema without having its engine params set. - -This command commits an open transaction in this connection. -"," -CREATE SCHEMA TEST_SCHEMA AUTHORIZATION SA -" - -"Commands (DDL)","CREATE SEQUENCE"," -CREATE SEQUENCE [ IF NOT EXISTS ] newSequenceName -[ START WITH long ] -[ INCREMENT BY long ] -[ MINVALUE long | NOMINVALUE | NO MINVALUE ] -[ MAXVALUE long | NOMAXVALUE | NO MAXVALUE ] -[ CYCLE long | NOCYCLE | NO CYCLE ] -[ CACHE long | NOCACHE | NO CACHE ] -"," -Creates a new sequence. -The data type of a sequence is BIGINT. -Used values are never re-used, even when the transaction is rolled back. - -The cache is the number of pre-allocated numbers. -If the system crashes without closing the database, at most this many numbers are lost. -The default cache size is 32. -To disable caching, use the cache size 1 or lower. - -This command commits an open transaction in this connection. -"," -CREATE SEQUENCE SEQ_ID -" - -"Commands (DDL)","CREATE TABLE"," -CREATE [ CACHED | MEMORY ] [ TEMP | [ GLOBAL | LOCAL ] TEMPORARY ] -TABLE [ IF NOT EXISTS ] name -[ ( { columnName columnDefinition | constraint } [,...] ) ] -[ ENGINE tableEngineName ] -[ WITH tableEngineParamName [,...] ] -[ NOT PERSISTENT ] [ TRANSACTIONAL ] -[ AS select ]"," -Creates a new table. - -Cached tables (the default for regular tables) are persistent, -and the number of rows is not limited by the main memory. -Memory tables (the default for temporary tables) are persistent, -but the index data is kept in main memory, -that means memory tables should not get too large. - -Temporary tables are deleted when closing or opening a database. -Temporary tables can be global (accessible by all connections) -or local (only accessible by the current connection). -The default for temporary tables is global. -Indexes of temporary tables are kept fully in main memory, -unless the temporary table is created using CREATE CACHED TABLE. - -The ENGINE option is only required when custom table implementations are used. -The table engine class must implement the interface ""org.h2.api.TableEngine"". -Any table engine parameters are passed down in the tableEngineParams field of the CreateTableData object. - -Either ENGINE, or WITH (table engine params), or both may be specified. If ENGINE is not specified -in CREATE TABLE, then the engine specified by DEFAULT_TABLE_ENGINE option of database params is used. - -Tables with the NOT PERSISTENT modifier are kept fully in memory, and all -rows are lost when the database is closed. - -The column definition is optional if a query is specified. -In that case the column list of the query is used. - -This command commits an open transaction, except when using -TRANSACTIONAL (only supported for temporary tables). -"," -CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR(255)) -" - -"Commands (DDL)","CREATE TRIGGER"," -CREATE TRIGGER [ IF NOT EXISTS ] newTriggerName -{ BEFORE | AFTER | INSTEAD OF } -{ INSERT | UPDATE | DELETE | SELECT | ROLLBACK } -[,...] ON tableName [ FOR EACH ROW ] -[ QUEUE int ] [ NOWAIT ] -{ CALL triggeredClassName | AS sourceCodeString } -"," -Creates a new trigger. -The trigger class must be public and implement ""org.h2.api.Trigger"". -Inner classes are not supported. -The class must be available in the classpath of the database engine -(when using the server mode, it must be in the classpath of the server). - -The sourceCodeString must define a single method with no parameters that returns ""org.h2.api.Trigger"". -See CREATE ALIAS for requirements regarding the compilation. -Alternatively, javax.script.ScriptEngineManager can be used to create an instance of ""org.h2.api.Trigger"". -Currently javascript (included in every JRE) and ruby (with JRuby) are supported. -In that case the source must begin respectively with ""//javascript"" or ""#ruby"". - -BEFORE triggers are called after data conversion is made, default values are set, -null and length constraint checks have been made; -but before other constraints have been checked. -If there are multiple triggers, the order in which they are called is undefined. - -ROLLBACK can be specified in combination with INSERT, UPDATE, and DELETE. -Only row based AFTER trigger can be called on ROLLBACK. -Exceptions that occur within such triggers are ignored. -As the operations that occur within a trigger are part of the transaction, -ROLLBACK triggers are only required if an operation communicates outside of the database. - -INSTEAD OF triggers are implicitly row based and behave like BEFORE triggers. -Only the first such trigger is called. Such triggers on views are supported. -They can be used to make views updatable. - -A BEFORE SELECT trigger is fired just before the database engine tries to read from the table. -The trigger can be used to update a table on demand. -The trigger is called with both 'old' and 'new' set to null. - -The MERGE statement will call both INSERT and UPDATE triggers. -Not supported are SELECT triggers with the option FOR EACH ROW, -and AFTER SELECT triggers. - -Committing or rolling back a transaction within a trigger is not allowed, except for SELECT triggers. - -By default a trigger is called once for each statement, without the old and new rows. -FOR EACH ROW triggers are called once for each inserted, updated, or deleted row. - -QUEUE is implemented for syntax compatibility with HSQL and has no effect. - -The trigger need to be created in the same schema as the table. -The schema name does not need to be specified when creating the trigger. - -This command commits an open transaction in this connection. -"," -CREATE TRIGGER TRIG_INS BEFORE INSERT ON TEST FOR EACH ROW CALL ""MyTrigger""; -CREATE TRIGGER TRIG_SRC BEFORE INSERT ON TEST AS $$org.h2.api.Trigger create() { return new MyTrigger(""constructorParam""); } $$; -CREATE TRIGGER TRIG_JS BEFORE INSERT ON TEST AS $$//javascript\nreturn new Packages.MyTrigger(""constructorParam""); $$; -CREATE TRIGGER TRIG_RUBY BEFORE INSERT ON TEST AS $$#ruby\nJava::MyPackage::MyTrigger.new(""constructorParam"") $$; -" -"Commands (DDL)","CREATE USER"," -CREATE USER [ IF NOT EXISTS ] newUserName -{ PASSWORD string | SALT bytes HASH bytes } [ ADMIN ] -"," -Creates a new user. For compatibility, only unquoted or uppercase user names are allowed. -The password must be in single quotes. It is case sensitive and can contain spaces. -The salt and hash values are hex strings. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -CREATE USER GUEST PASSWORD 'abc' -" - -"Commands (DDL)","CREATE VIEW"," -CREATE [ OR REPLACE ] [ FORCE ] VIEW [ IF NOT EXISTS ] newViewName -[ ( columnName [,...] ) ] AS select -"," -Creates a new view. If the force option is used, then the view is created even -if the underlying table(s) don't exist. - -If the OR REPLACE clause is used an existing view will be replaced, and any -dependent views will not need to be recreated. If dependent views will become -invalid as a result of the change an error will be generated, but this error -can be ignored if the FORCE clause is also used. - -Views are not updatable except when using 'instead of' triggers. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -CREATE VIEW TEST_VIEW AS SELECT * FROM TEST WHERE ID < 100 -" - -"Commands (DDL)","DROP AGGREGATE"," -DROP AGGREGATE [ IF EXISTS ] aggregateName -"," -Drops an existing user-defined aggregate function. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -DROP AGGREGATE SIMPLE_MEDIAN -" - -"Commands (DDL)","DROP ALIAS"," -DROP ALIAS [ IF EXISTS ] existingFunctionAliasName -"," -Drops an existing function alias. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -DROP ALIAS MY_SQRT -" - -"Commands (DDL)","DROP ALL OBJECTS"," -DROP ALL OBJECTS [ DELETE FILES ] -"," -Drops all existing views, tables, sequences, schemas, function aliases, roles, -user-defined aggregate functions, domains, and users (except the current user). -If DELETE FILES is specified, the database files will be removed when the last -user disconnects from the database. Warning: this command can not be rolled -back. - -Admin rights are required to execute this command. -"," -DROP ALL OBJECTS -" - -"Commands (DDL)","DROP CONSTANT"," -DROP CONSTANT [ IF EXISTS ] constantName -"," -Drops a constant. -This command commits an open transaction in this connection. -"," -DROP CONSTANT ONE -" - -"Commands (DDL)","DROP DOMAIN"," -DROP DOMAIN [ IF EXISTS ] domainName -"," -Drops a data type (domain). -This command commits an open transaction in this connection. -"," -DROP DOMAIN EMAIL -" - -"Commands (DDL)","DROP INDEX"," -DROP INDEX [ IF EXISTS ] indexName -"," -Drops an index. -This command commits an open transaction in this connection. -"," -DROP INDEX IF EXISTS IDXNAME -" - -"Commands (DDL)","DROP ROLE"," -DROP ROLE [ IF EXISTS ] roleName -"," -Drops a role. -This command commits an open transaction in this connection. -"," -DROP ROLE READONLY -" - -"Commands (DDL)","DROP SCHEMA"," -DROP SCHEMA [ IF EXISTS ] schemaName [ RESTRICT | CASCADE ] -"," -Drops a schema. -The command will fail if objects in this schema exist and the RESTRICT clause is used (the default). -All objects in this schema are dropped as well if the CASCADE clause is used. -This command commits an open transaction in this connection. -"," -DROP SCHEMA TEST_SCHEMA -" - -"Commands (DDL)","DROP SEQUENCE"," -DROP SEQUENCE [ IF EXISTS ] sequenceName -"," -Drops a sequence. -This command commits an open transaction in this connection. -"," -DROP SEQUENCE SEQ_ID -" - -"Commands (DDL)","DROP TABLE"," -DROP TABLE [ IF EXISTS ] tableName [,...] [ RESTRICT | CASCADE ] -"," -Drops an existing table, or a list of tables. -The command will fail if dependent objects exist and the RESTRICT clause is used (the default). -All dependent views and constraints are dropped as well if the CASCADE clause is used. -This command commits an open transaction in this connection. -"," -DROP TABLE TEST -" - -"Commands (DDL)","DROP TRIGGER"," -DROP TRIGGER [ IF EXISTS ] triggerName -"," -Drops an existing trigger. -This command commits an open transaction in this connection. -"," -DROP TRIGGER TRIG_INS -" - -"Commands (DDL)","DROP USER"," -DROP USER [ IF EXISTS ] userName -"," -Drops a user. The current user cannot be dropped. -For compatibility, only unquoted or uppercase user names are allowed. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -DROP USER TOM -" - -"Commands (DDL)","DROP VIEW"," -DROP VIEW [ IF EXISTS ] viewName [ RESTRICT | CASCADE ] -"," -Drops an existing view. -All dependent views are dropped as well if the CASCADE clause is used (the default). -The command will fail if dependent views exist and the RESTRICT clause is used. -This command commits an open transaction in this connection. -"," -DROP VIEW TEST_VIEW -" - -"Commands (DDL)","TRUNCATE TABLE"," -TRUNCATE TABLE tableName -"," -Removes all rows from a table. -Unlike DELETE FROM without where clause, this command can not be rolled back. -This command is faster than DELETE without where clause. -Only regular data tables without foreign key constraints can be truncated -(except if referential integrity is disabled for this database or for this table). -Linked tables can't be truncated. - -This command commits an open transaction in this connection. -"," -TRUNCATE TABLE TEST -" - -"Commands (Other)","CHECKPOINT"," -CHECKPOINT -"," -Flushes the data to disk. - -Admin rights are required to execute this command. -"," -CHECKPOINT -" - -"Commands (Other)","CHECKPOINT SYNC"," -CHECKPOINT SYNC -"," -Flushes the data to disk and and forces all system buffers be written -to the underlying device. - -Admin rights are required to execute this command. -"," -CHECKPOINT SYNC -" - -"Commands (Other)","COMMIT"," -COMMIT [ WORK ] -"," -Commits a transaction. -"," -COMMIT -" - -"Commands (Other)","COMMIT TRANSACTION"," -COMMIT TRANSACTION transactionName -"," -Sets the resolution of an in-doubt transaction to 'commit'. - -Admin rights are required to execute this command. -This command is part of the 2-phase-commit protocol. -"," -COMMIT TRANSACTION XID_TEST -" - -"Commands (Other)","GRANT RIGHT"," -GRANT { SELECT | INSERT | UPDATE | DELETE | ALL } [,...] ON -{ { SCHEMA schemaName } | { tableName [,...] } } -TO { PUBLIC | userName | roleName } -"," -Grants rights for a table to a user or role. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -GRANT SELECT ON TEST TO READONLY -" - -"Commands (Other)","GRANT ALTER ANY SCHEMA"," -GRANT ALTER ANY SCHEMA TO userName -"," -Grant schema altering rights to a user. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -GRANT ALTER ANY SCHEMA TO Bob -" - -"Commands (Other)","GRANT ROLE"," -GRANT roleName TO { PUBLIC | userName | roleName } -"," -Grants a role to a user or role. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -GRANT READONLY TO PUBLIC -" - -"Commands (Other)","HELP"," -HELP [ anything [...] ] -"," -Displays the help pages of SQL commands or keywords. -"," -HELP SELECT -" - -"Commands (Other)","PREPARE COMMIT"," -PREPARE COMMIT newTransactionName -"," -Prepares committing a transaction. -This command is part of the 2-phase-commit protocol. -"," -PREPARE COMMIT XID_TEST -" - -"Commands (Other)","REVOKE RIGHT"," -REVOKE { SELECT | INSERT | UPDATE | DELETE | ALL } [,...] ON -{ { SCHEMA schemaName } | { tableName [,...] } } -FROM { PUBLIC | userName | roleName } -"," -Removes rights for a table from a user or role. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -REVOKE SELECT ON TEST FROM READONLY -" - -"Commands (Other)","REVOKE ROLE"," -REVOKE roleName FROM { PUBLIC | userName | roleName } -"," -Removes a role from a user or role. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -REVOKE READONLY FROM TOM -" - -"Commands (Other)","ROLLBACK"," -ROLLBACK [ TO SAVEPOINT savepointName ] -"," -Rolls back a transaction. If a savepoint name is used, the transaction is only -rolled back to the specified savepoint. -"," -ROLLBACK -" - -"Commands (Other)","ROLLBACK TRANSACTION"," -ROLLBACK TRANSACTION transactionName -"," -Sets the resolution of an in-doubt transaction to 'rollback'. - -Admin rights are required to execute this command. -This command is part of the 2-phase-commit protocol. -"," -ROLLBACK TRANSACTION XID_TEST -" - -"Commands (Other)","SAVEPOINT"," -SAVEPOINT savepointName -"," -Create a new savepoint. See also ROLLBACK. -Savepoints are only valid until the transaction is committed or rolled back. -"," -SAVEPOINT HALF_DONE -" - -"Commands (Other)","SET @"," -SET @variableName [ = ] expression -"," -Updates a user-defined variable. -Variables are not persisted and session scoped, that means only visible from within the session in which they are defined. -This command does not commit a transaction, and rollback does not affect it. -"," -SET @TOTAL=0 -" - -"Commands (Other)","SET ALLOW_LITERALS"," -SET ALLOW_LITERALS { NONE | ALL | NUMBERS } -"," -This setting can help solve the SQL injection problem. By default, text and -number literals are allowed in SQL statements. However, this enables SQL -injection if the application dynamically builds SQL statements. SQL injection is -not possible if user data is set using parameters ('?'). - -NONE means literals of any kind are not allowed, only parameters and constants -are allowed. NUMBERS mean only numerical and boolean literals are allowed. ALL -means all literals are allowed (default). - -See also CREATE CONSTANT. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;ALLOW_LITERALS=NONE"" -"," -SET ALLOW_LITERALS NONE -" - -"Commands (Other)","SET AUTOCOMMIT"," -SET AUTOCOMMIT { TRUE | ON | FALSE | OFF } -"," -Switches auto commit on or off. -This setting can be appended to the database URL: ""jdbc:h2:test;AUTOCOMMIT=OFF"" - -however this will not work as expected when using a connection pool -(the connection pool manager will re-enable autocommit when returning -the connection to the pool, so autocommit will only be disabled the first -time the connection is used. -"," -SET AUTOCOMMIT OFF -" - -"Commands (Other)","SET CACHE_SIZE"," -SET CACHE_SIZE int -"," -Sets the size of the cache in KB (each KB being 1024 bytes) for the current database. -The default is 65536 per available GB of RAM, i.e. 64 MB per GB. -The value is rounded to the next higher power of two. -Depending on the virtual machine, the actual memory required may be higher. - -This setting is persistent and affects all connections as there is only one cache per database. -Using a very small value (specially 0) will reduce performance a lot. -This setting only affects the database engine (the server in a client/server environment; -in embedded mode, the database engine is in the same process as the application). -It has no effect for in-memory databases. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;CACHE_SIZE=8192"" -"," -SET CACHE_SIZE 8192 -" - -"Commands (Other)","SET CLUSTER"," -SET CLUSTER serverListString -"," -This command should not be used directly by an application, the statement is -executed automatically by the system. The behavior may change in future -releases. Sets the cluster server list. An empty string switches off the cluster -mode. Switching on the cluster mode requires admin rights, but any user can -switch it off (this is automatically done when the client detects the other -server is not responding). - -This command is effective immediately, but does not commit an open transaction. -"," -SET CLUSTER '' -" - -"Commands (Other)","SET BINARY_COLLATION"," -SET BINARY_COLLATION -{ UNSIGNED | SIGNED } ] } -"," -Sets the collation used for comparing BINARY columns, the default is SIGNED -for version 1.3 and older, and UNSIGNED for version 1.4 and newer. -This command can only be executed if there are no tables defined. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -This setting is persistent. -"," -SET BINARY_COLLATION SIGNED -" - -"Commands (Other)","SET BUILTIN_ALIAS_OVERRIDE"," -SET BUILTIN_ALIAS_OVERRIDE -{ TRUE | FALSE } ] } -"," -Allows the overriding of the builtin system date/time functions -for unit testing purposes. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -SET BUILTIN_ALIAS_OVERRIDE TRUE -" - -"Commands (Other)","SET COLLATION"," -SET [ DATABASE ] COLLATION -{ OFF | collationName - [ STRENGTH { PRIMARY | SECONDARY | TERTIARY | IDENTICAL } ] } -"," -Sets the collation used for comparing strings. -This command can only be executed if there are no tables defined. -See ""java.text.Collator"" for details about the supported collations and the STRENGTH -(PRIMARY is usually case- and umlaut-insensitive; SECONDARY is case-insensitive but umlaut-sensitive; -TERTIARY is both case- and umlaut-sensitive; IDENTICAL is sensitive to all differences and only affects ordering). - -The ICU4J collator is used if it is in the classpath. -It is also used if the collation name starts with ICU4J_ -(in that case, the ICU4J must be in the classpath, otherwise an exception is thrown). -The default collator is used if the collation name starts with DEFAULT_ -(even if ICU4J is in the classpath). -The charset collator is used if the collation name starts with CHARSET_ (e.g. CHARSET_CP500). This collator sorts -strings according to the binary representation in the given charset. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;COLLATION='ENGLISH'"" -"," -SET COLLATION ENGLISH -SET COLLATION CHARSET_CP500 -" - -"Commands (Other)","SET COMPRESS_LOB"," -SET COMPRESS_LOB { NO | LZF | DEFLATE } -"," -This feature is only available for the PageStore storage engine. -For the MVStore engine (the default for H2 version 1.4.x), -append "";COMPRESS=TRUE"" to the database URL instead. - -Sets the compression algorithm for BLOB and CLOB data. Compression is usually -slower, but needs less disk space. LZF is faster but uses more space. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -"," -SET COMPRESS_LOB LZF -" - -"Commands (Other)","SET DATABASE_EVENT_LISTENER"," -SET DATABASE_EVENT_LISTENER classNameString -"," -Sets the event listener class. An empty string ('') means no listener should be -used. This setting is not persistent. - -Admin rights are required to execute this command, except if it is set when -opening the database (in this case it is reset just after opening the database). -This setting can be appended to the database URL: ""jdbc:h2:test;DATABASE_EVENT_LISTENER='sample.MyListener'"" -"," -SET DATABASE_EVENT_LISTENER 'sample.MyListener' -" - -"Commands (Other)","SET DB_CLOSE_DELAY"," -SET DB_CLOSE_DELAY int -"," -Sets the delay for closing a database if all connections are closed. -The value -1 means the database is never closed until the close delay is set to some other value or SHUTDOWN is called. -The value 0 means no delay (default; the database is closed if the last connection to it is closed). -Values 1 and larger mean the number of seconds the database is left open after closing the last connection. - -If the application exits normally or System.exit is called, the database is closed immediately, even if a delay is set. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;DB_CLOSE_DELAY=-1"" -"," -SET DB_CLOSE_DELAY -1 -" - -"Commands (Other)","SET DEFAULT_LOCK_TIMEOUT"," -SET DEFAULT LOCK_TIMEOUT int -"," -Sets the default lock timeout (in milliseconds) in this database that is used -for the new sessions. The default value for this setting is 1000 (one second). - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -"," -SET DEFAULT_LOCK_TIMEOUT 5000 -" - -"Commands (Other)","SET DEFAULT_TABLE_TYPE"," -SET DEFAULT_TABLE_TYPE { MEMORY | CACHED } -"," -Sets the default table storage type that is used when creating new tables. -Memory tables are kept fully in the main memory (including indexes), however -the data is still stored in the database file. The size of memory tables is -limited by the memory. The default is CACHED. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -It has no effect for in-memory databases. -"," -SET DEFAULT_TABLE_TYPE MEMORY -" - -"Commands (Other)","SET EXCLUSIVE"," -SET EXCLUSIVE { 0 | 1 | 2 } -"," -Switched the database to exclusive mode (1, 2) and back to normal mode (0). - -In exclusive mode, new connections are rejected, and operations by -other connections are paused until the exclusive mode is disabled. -When using the value 1, existing connections stay open. -When using the value 2, all existing connections are closed -(and current transactions are rolled back) except the connection -that executes SET EXCLUSIVE. -Only the connection that set the exclusive mode can disable it. -When the connection is closed, it is automatically disabled. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -"," -SET EXCLUSIVE 1 -" - -"Commands (Other)","SET IGNORECASE"," -SET IGNORECASE { TRUE | FALSE } -"," -If IGNORECASE is enabled, text columns in newly created tables will be -case-insensitive. Already existing tables are not affected. The effect of -case-insensitive columns is similar to using a collation with strength PRIMARY. -Case-insensitive columns are compared faster than when using a collation. -String literals and parameters are however still considered case sensitive even if this option is set. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;IGNORECASE=TRUE"" -"," -SET IGNORECASE TRUE -" - -"Commands (Other)","SET JAVA_OBJECT_SERIALIZER"," -SET JAVA_OBJECT_SERIALIZER -{ null | className } -"," -Sets the object used to serialize and deserialize java objects being stored in column of type OTHER. -The serializer class must be public and implement ""org.h2.api.JavaObjectSerializer"". -Inner classes are not supported. -The class must be available in the classpath of the database engine -(when using the server mode, it must be both in the classpath of the server and the client). -This command can only be executed if there are no tables defined. - -Admin rights are required to execute this command. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;JAVA_OBJECT_SERIALIZER='com.acme.SerializerClassName'"" -"," -SET JAVA_OBJECT_SERIALIZER 'com.acme.SerializerClassName' -" - - -"Commands (Other)","SET LAZY_QUERY_EXECUTION"," -SET LAZY_QUERY_EXECUTION int -"," -Sets the lazy query execution mode. The values 0, 1 are supported. - -If true, then large results are retrieved in chunks. - -Note that not all queries support this feature, queries which do not are processed normally. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is not persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;LAZY_QUERY_EXECUTION=1"" -"," -SET LAZY_QUERY_EXECUTION 1 -" - -"Commands (Other)","SET LOG"," -SET LOG int -"," -Sets the transaction log mode. The values 0, 1, and 2 are supported, the default is 2. -This setting affects all connections. - -LOG 0 means the transaction log is disabled completely. It is the fastest mode, -but also the most dangerous: if the process is killed while the database is open in this mode, -the data might be lost. It must only be used if this is not a problem, for example when -initially loading a database, or when running tests. - -LOG 1 means the transaction log is enabled, but FileDescriptor.sync is disabled. -This setting is about half as fast as with LOG 0. This setting is useful if no protection -against power failure is required, but the data must be protected against killing the process. - -LOG 2 (the default) means the transaction log is enabled, and FileDescriptor.sync is called -for each checkpoint. This setting is about half as fast as LOG 1. Depending on the -file system, this will also protect against power failure in the majority if cases. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is not persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;LOG=0"" -"," -SET LOG 1 -" - -"Commands (Other)","SET LOCK_MODE"," -SET LOCK_MODE int -"," -Sets the lock mode. The values 0, 1, 2, and 3 are supported. The default is 3 -(READ_COMMITTED). This setting affects all connections. - -The value 0 means no locking (should only be used for testing; also known as -READ_UNCOMMITTED). Please note that using SET LOCK_MODE 0 while at the same time -using multiple connections may result in inconsistent transactions. - -The value 1 means table level locking (also known as SERIALIZABLE). - -The value 2 means table level locking with garbage collection (if the -application does not close all connections). - -The value 3 means table level locking, but read locks are released immediately -(default; also known as READ_COMMITTED). - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;LOCK_MODE=3"" -"," -SET LOCK_MODE 1 -" - -"Commands (Other)","SET LOCK_TIMEOUT"," -SET LOCK_TIMEOUT int -"," -Sets the lock timeout (in milliseconds) for the current session. The default -value for this setting is 1000 (one second). - -This command does not commit a transaction, and rollback does not affect it. -This setting can be appended to the database URL: ""jdbc:h2:test;LOCK_TIMEOUT=10000"" -"," -SET LOCK_TIMEOUT 1000 -" - -"Commands (Other)","SET MAX_LENGTH_INPLACE_LOB"," -SET MAX_LENGTH_INPLACE_LOB int -"," -Sets the maximum size of an in-place LOB object. - -This is the maximum length of an LOB that is stored with the record itself, -and the default value is 128. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -"," -SET MAX_LENGTH_INPLACE_LOB 128 -" - -"Commands (Other)","SET MAX_LOG_SIZE"," -SET MAX_LOG_SIZE int -"," -Sets the maximum size of the transaction log, in megabytes. -If the log is larger, and if there is no open transaction, the transaction log is truncated. -If there is an open transaction, the transaction log will continue to grow however. -The default max size is 16 MB. -This setting has no effect for in-memory databases. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -"," -SET MAX_LOG_SIZE 2 -" - -"Commands (Other)","SET MAX_MEMORY_ROWS"," -SET MAX_MEMORY_ROWS int -"," -The maximum number of rows in a result set that are kept in-memory. If more rows -are read, then the rows are buffered to disk. -The default is 40000 per GB of available RAM. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -It has no effect for in-memory databases. -"," -SET MAX_MEMORY_ROWS 1000 -" - -"Commands (Other)","SET MAX_MEMORY_UNDO"," -SET MAX_MEMORY_UNDO int -"," -The maximum number of undo records per a session that are kept in-memory. -If a transaction is larger, the records are buffered to disk. -The default value is 50000. -Changes to tables without a primary key can not be buffered to disk. -This setting is not supported when using multi-version concurrency. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -It has no effect for in-memory databases. -"," -SET MAX_MEMORY_UNDO 1000 -" - -"Commands (Other)","SET MAX_OPERATION_MEMORY"," -SET MAX_OPERATION_MEMORY int -"," -Sets the maximum memory used for large operations (delete and insert), in bytes. -Operations that use more memory are buffered to disk, slowing down the -operation. The default max size is 100000. 0 means no limit. - -This setting is not persistent. -Admin rights are required to execute this command, as it affects all connections. -It has no effect for in-memory databases. -This setting can be appended to the database URL: ""jdbc:h2:test;MAX_OPERATION_MEMORY=10000"" -"," -SET MAX_OPERATION_MEMORY 0 -" - -"Commands (Other)","SET MODE"," -SET MODE { REGULAR | DB2 | DERBY | HSQLDB | MSSQLSERVER | MYSQL | ORACLE | POSTGRESQL } -"," -Changes to another database compatibility mode. For details, see Compatibility -Modes in the feature section. - -This setting is not persistent. -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting can be appended to the database URL: ""jdbc:h2:test;MODE=MYSQL"" -"," -SET MODE HSQLDB -" - -"Commands (Other)","SET MULTI_THREADED"," -SET MULTI_THREADED { 0 | 1 } -"," -Enabled (1) or disabled (0) multi-threading inside the database engine. By -default, this setting is disabled. Currently, enabling this is experimental -only. - -This is a global setting, which means it is not possible to open multiple databases with different modes at the same time in the same virtual machine. -This setting is not persistent, however the value is kept until the virtual machine exits or it is changed. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting can be appended to the database URL: ""jdbc:h2:test;MULTI_THREADED=1"" -"," -SET MULTI_THREADED 1 -" - -"Commands (Other)","SET OPTIMIZE_REUSE_RESULTS"," -SET OPTIMIZE_REUSE_RESULTS { 0 | 1 } -"," -Enabled (1) or disabled (0) the result reuse optimization. If enabled, -subqueries and views used as subqueries are only re-run if the data in one of -the tables was changed. This option is enabled by default. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting can be appended to the database URL: ""jdbc:h2:test;OPTIMIZE_REUSE_RESULTS=0"" -"," -SET OPTIMIZE_REUSE_RESULTS 0 -" - -"Commands (Other)","SET PASSWORD"," -SET PASSWORD string -"," -Changes the password of the current user. The password must be in single quotes. -It is case sensitive and can contain spaces. - -This command commits an open transaction in this connection. -"," -SET PASSWORD 'abcstzri!.5' -" - -"Commands (Other)","SET QUERY_STATISTICS"," -SET QUERY_STATISTICS { TRUE | FALSE } -"," -Disabled or enables query statistics gathering for the whole database. -The statistics are reflected in the INFORMATION_SCHEMA.QUERY_STATISTICS meta-table. - -This setting is not persistent. -This command commits an open transaction in this connection. -Admin rights are required to execute this command, as it affects all connections. -"," -SET QUERY_STATISTICS FALSE -" - -"Commands (Other)","SET QUERY_STATISTICS_MAX_ENTRIES"," -SET QUERY_STATISTICS int -"," -Set the maximum number of entries in query statistics meta-table. -Default value is 100. - -This setting is not persistent. -This command commits an open transaction in this connection. -Admin rights are required to execute this command, as it affects all connections. -"," -SET QUERY_STATISTICS_MAX_ENTRIES 500 -" - -"Commands (Other)","SET QUERY_TIMEOUT"," -SET QUERY_TIMEOUT int -"," -Set the query timeout of the current session to the given value. The timeout is -in milliseconds. All kinds of statements will throw an exception if they take -longer than the given value. The default timeout is 0, meaning no timeout. - -This command does not commit a transaction, and rollback does not affect it. -"," -SET QUERY_TIMEOUT 10000 -" - -"Commands (Other)","SET REFERENTIAL_INTEGRITY"," -SET REFERENTIAL_INTEGRITY { TRUE | FALSE } -"," -Disabled or enables referential integrity checking for the whole database. -Enabling it does not check existing data. Use ALTER TABLE SET to disable it only -for one table. - -This setting is not persistent. -This command commits an open transaction in this connection. -Admin rights are required to execute this command, as it affects all connections. -"," -SET REFERENTIAL_INTEGRITY FALSE -" - -"Commands (Other)","SET RETENTION_TIME"," -SET RETENTION_TIME int -"," -This property is only used when using the MVStore storage engine. -How long to retain old, persisted data, in milliseconds. -The default is 45000 (45 seconds), 0 means overwrite data as early as possible. -It is assumed that a file system and hard disk will flush all write buffers within this time. -Using a lower value might be dangerous, unless the file system and hard disk flush the buffers earlier. -To manually flush the buffers, use CHECKPOINT SYNC, -however please note that according to various tests this does not always work as expected -depending on the operating system and hardware. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting is persistent. -This setting can be appended to the database URL: ""jdbc:h2:test;RETENTION_TIME=0"" -"," -SET RETENTION_TIME 0 -" - -"Commands (Other)","SET SALT HASH"," -SET SALT bytes HASH bytes -"," -Sets the password salt and hash for the current user. The password must be in -single quotes. It is case sensitive and can contain spaces. - -This command commits an open transaction in this connection. -"," -SET SALT '00' HASH '1122' -" - -"Commands (Other)","SET SCHEMA"," -SET SCHEMA schemaName -"," -Changes the default schema of the current connection. The default schema is used -in statements where no schema is set explicitly. The default schema for new -connections is PUBLIC. - -This command does not commit a transaction, and rollback does not affect it. -This setting can be appended to the database URL: ""jdbc:h2:test;SCHEMA=ABC"" -"," -SET SCHEMA INFORMATION_SCHEMA -" - -"Commands (Other)","SET SCHEMA_SEARCH_PATH"," -SET SCHEMA_SEARCH_PATH schemaName [,...] -"," -Changes the schema search path of the current connection. The default schema is -used in statements where no schema is set explicitly. The default schema for new -connections is PUBLIC. - -This command does not commit a transaction, and rollback does not affect it. -This setting can be appended to the database URL: ""jdbc:h2:test;SCHEMA_SEARCH_PATH=ABC,DEF"" -"," -SET SCHEMA_SEARCH_PATH INFORMATION_SCHEMA, PUBLIC -" - -"Commands (Other)","SET THROTTLE"," -SET THROTTLE int -"," -Sets the throttle for the current connection. The value is the number of -milliseconds delay after each 50 ms. The default value is 0 (throttling -disabled). - -This command does not commit a transaction, and rollback does not affect it. -This setting can be appended to the database URL: ""jdbc:h2:test;THROTTLE=50"" -"," -SET THROTTLE 200 -" - -"Commands (Other)","SET TRACE_LEVEL"," -SET { TRACE_LEVEL_FILE | TRACE_LEVEL_SYSTEM_OUT } int -"," -Sets the trace level for file the file or system out stream. Levels are: 0=off, -1=error, 2=info, 3=debug. The default level is 1 for file and 0 for system out. -To use SLF4J, append "";TRACE_LEVEL_FILE=4"" to the database URL when opening the database. - -This setting is not persistent. -Admin rights are required to execute this command, as it affects all connections. -This command does not commit a transaction, and rollback does not affect it. -This setting can be appended to the database URL: ""jdbc:h2:test;TRACE_LEVEL_SYSTEM_OUT=3"" -"," -SET TRACE_LEVEL_SYSTEM_OUT 3 -" - -"Commands (Other)","SET TRACE_MAX_FILE_SIZE"," -SET TRACE_MAX_FILE_SIZE int -"," -Sets the maximum trace file size. If the file exceeds the limit, the file is -renamed to .old and a new file is created. If another .old file exists, it is -deleted. The default max size is 16 MB. - -This setting is persistent. -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting can be appended to the database URL: ""jdbc:h2:test;TRACE_MAX_FILE_SIZE=3"" -"," -SET TRACE_MAX_FILE_SIZE 10 -" - -"Commands (Other)","SET UNDO_LOG"," -SET UNDO_LOG int -"," -Enables (1) or disables (0) the per session undo log. The undo log is enabled by -default. When disabled, transactions can not be rolled back. This setting should -only be used for bulk operations that don't need to be atomic. - -This command commits an open transaction in this connection. -"," -SET UNDO_LOG 0 -" - -"Commands (Other)","SET WRITE_DELAY"," -SET WRITE_DELAY int -"," -Set the maximum delay between a commit and flushing the log, in milliseconds. -This setting is persistent. The default is 500 ms. - -Admin rights are required to execute this command, as it affects all connections. -This command commits an open transaction in this connection. -This setting can be appended to the database URL: ""jdbc:h2:test;WRITE_DELAY=0"" -"," -SET WRITE_DELAY 2000 -" - -"Commands (Other)","SHUTDOWN"," -SHUTDOWN [ IMMEDIATELY | COMPACT | DEFRAG ] -"," -This statement closes all open connections to the database and closes the -database. This command is usually not required, as the database is -closed automatically when the last connection to it is closed. - -If no option is used, then the database is closed normally. -All connections are closed, open transactions are rolled back. - -SHUTDOWN COMPACT fully compacts the database (re-creating the database may further reduce the database size). -If the database is closed normally (using SHUTDOWN or by closing all connections), then the database is also compacted, -but only for at most the time defined by the database setting ""h2.maxCompactTime"" in milliseconds (see there). - -SHUTDOWN IMMEDIATELY closes the database files without any cleanup and without compacting. - -SHUTDOWN DEFRAG re-orders the pages when closing the database so that table scans are faster. - -Admin rights are required to execute this command. -"," -SHUTDOWN COMPACT -" - -"Datetime fields","Datetime field"," -yearField | monthField | dayOfMonthField - | hourField | minuteField | secondField - | millisecondField | microsecondField | nanosecondField - | timezoneHourField | timezoneMinuteField - | dayOfWeekField | isoDayOfWeekField - | weekOfYearField | isoWeekOfYearField - | quarterField | dayOfYearField | epochField -"," -Fields for EXTRACT, DATEADD, and DATEDIFF functions. -"," -YEAR -" - -"Datetime fields","Year field"," -YEAR | YYYY | YY | SQL_TSI_YEAR -"," -Year. -"," -YEAR -" - -"Datetime fields","Month field"," -MONTH | MM | M | SQL_TSI_MONTH -"," -Month (1-12). -"," -MONTH -" - -"Datetime fields","Day of month field"," -DAY | DD | D | SQL_TSI_DAY -"," -Day of month (1-31). -"," -DAY -" - -"Datetime fields","Hour field"," -HOUR | HH | SQL_TSI_HOUR -"," -Hour (0-23). -"," -HOUR -" - -"Datetime fields","Minute field"," -MINUTE | MI | N | SQL_TSI_MINUTE -"," -Minute (0-59). -"," -MINUTE -" - -"Datetime fields","Second field"," -SECOND | SS | S | SQL_TSI_SECOND -"," -Second (0-59). -"," -SECOND -" - -"Datetime fields","Millisecond field"," -MILLISECOND | MS -"," -Millisecond (0-999). -"," -MILLISECOND -" - -"Datetime fields","Microsecond field"," -MICROSECOND | MCS -"," -Microsecond (0-999999). -"," -MICROSECOND -" - -"Datetime fields","Nanosecond field"," -NANOSECOND | NS -"," -Nanosecond (0-999999999). -"," -NANOSECOND -" - -"Datetime fields","Timezone hour field"," -TIMEZONE_HOUR -"," -Timezone hour (from -18 to +18). -"," -TIMEZONE_HOUR -" - -"Datetime fields","Timezone minute field"," -TIMEZONE_MINUTE -"," -Timezone minute (from -59 to +59). -"," -TIMEZONE_MINUTE -" - -"Datetime fields","Day of week field"," -DAY_OF_WEEK | DAYOFWEEK | DOW -"," -Day of week (1-7). Sunday is 1. -"," -DAY_OF_WEEK -" - -"Datetime fields","ISO day of week field"," -ISO_DAY_OF_WEEK -"," -ISO day of week (1-7). Monday is 1. -"," -ISO_DAY_OF_WEEK -" - -"Datetime fields","Week of year field"," -WEEK | WW | W | SQL_TSI_WEEK -"," -Week of year (1-53). -EXTRACT function uses local rules to get number of week in year. -DATEDIFF function uses Sunday as a first day of week. -"," -WEEK -" - -"Datetime fields","ISO week of year field"," -ISO_WEEK -"," -ISO week of year (1-53). -ISO definition is used when first week of year should have at least four days -and week is started with Monday. -"," -ISO_WEEK -" - -"Datetime fields","Quarter field"," -QUARTER -"," -Quarter (1-4). -"," -QUARTER -" - -"Datetime fields","Day of year field"," -DAYOFYEAR | DAY_OF_YEAR | DOY | DY -"," -Day of year (1-366). -"," -DAYOFYEAR -" - -"Datetime fields","Epoch field"," -EPOCH -"," -For TIMESTAMP values number of seconds since 1970-01-01 00:00:00 in local time zone. -For TIMESTAMP WITH TIME ZONE values number of seconds since 1970-01-01 00:00:00 in UTC time zone. -For DATE values number of seconds since 1970-01-01. -For TIME values number of seconds since midnight. -"," -EPOCH -" - -"Other Grammar","Alias"," -name -"," -An alias is a name that is only valid in the context of the statement. -"," -A -" - -"Other Grammar","And Condition"," -condition [ { AND condition } [...] ] -"," -Value or condition. -"," -ID=1 AND NAME='Hi' -" - -"Other Grammar","Array"," -( [ expression, [ expression [,...] ] ] ) -"," -An array of values. An empty array is '()'. Trailing commas are ignored. -An array with one element must contain a comma to be parsed as an array. -"," -(1, 2) -(1, ) -() -" - -"Other Grammar","Boolean"," -TRUE | FALSE -"," -A boolean value. -"," -TRUE -" - -"Other Grammar","Bytes"," -X'hex' -"," -A binary value. The hex value is not case sensitive. -"," -X'01FF' -" - -"Other Grammar","Case"," -CASE expression { WHEN expression THEN expression } [...] -[ ELSE expression ] END -"," -Returns the first expression where the value is equal to the test expression. If -no else part is specified, return NULL. -"," -CASE CNT WHEN 0 THEN 'No' WHEN 1 THEN 'One' ELSE 'Some' END -" - -"Other Grammar","Case When"," -CASE { WHEN expression THEN expression} [...] -[ ELSE expression ] END -"," -Returns the first expression where the condition is true. If no else part is -specified, return NULL. -"," -CASE WHEN CNT<10 THEN 'Low' ELSE 'High' END -" - -"Other Grammar","Cipher"," -AES -"," -Only the algorithm AES (""AES-128"") is supported currently. -"," -AES -" - -"Other Grammar","Column Definition"," -dataType [ VISIBLE | INVISIBLE ] -[ { DEFAULT expression | AS computedColumnExpression } ] -[ ON UPDATE expression ] [ [ NOT ] NULL ] -[ { AUTO_INCREMENT | IDENTITY } [ ( startInt [, incrementInt ] ) ] ] -[ SELECTIVITY selectivity ] [ COMMENT expression ] -[ PRIMARY KEY [ HASH ] | UNIQUE ] [ CHECK condition ] -"," -Default expressions are used if no explicit value was used when adding a row. -The computed column expression is evaluated and assigned whenever the row changes. -On update column expression is used if row is updated, -at least one column have a new value that is different from its previous value -and value for this column is not set explicitly in update statement. - -Identity and auto-increment columns are columns with a sequence as the -default. The column declared as the identity columns is implicitly the -primary key column of this table (unlike auto-increment columns). - -The invisible column will not be displayed as a result of SELECT * query. -Otherwise, it works as normal column. - -The options PRIMARY KEY, UNIQUE, and CHECK are not supported for ALTER statements. - -Check constraints can reference columns of the table, -and they can reference objects that exist while the statement is executed. -Conditions are only checked when a row is added or modified -in the table where the constraint exists. - -"," -CREATE TABLE TEST(ID INT PRIMARY KEY, NAME VARCHAR(255) DEFAULT ''); -CREATE TABLE TEST(ID BIGINT IDENTITY); -CREATE TABLE TEST(QUANTITY INT, PRICE DECIMAL, AMOUNT DECIMAL AS QUANTITY*PRICE); -" - -"Other Grammar","Comments"," --- anythingUntilEndOfLine | // anythingUntilEndOfLine | /* anythingUntilEndComment */ -"," -Comments can be used anywhere in a command and are ignored by the database. Line -comments end with a newline. Block comments cannot be nested, but can be -multiple lines long. -"," -// This is a comment -" - -"Other Grammar","Compare"," -<> | <= | >= | = | < | > | != | && -"," -Comparison operator. The operator != is the same as <>. -The operator ""&&"" means overlapping; it can only be used with geometry types. -"," -<> -" - -"Other Grammar","Condition"," -operand [ conditionRightHandSide ] | NOT condition | EXISTS ( select ) -"," -Boolean value or condition. -"," -ID<>2 -" - -"Other Grammar","Condition Right Hand Side"," -compare { { { ALL | ANY | SOME } ( select ) } | operand } - | IS [ NOT ] NULL - | IS [ NOT ] [ DISTINCT FROM ] operand - | BETWEEN operand AND operand - | IN ( { select | expression [,...] } ) - | [ NOT ] [ LIKE | ILIKE ] operand [ ESCAPE string ] - | [ NOT ] REGEXP operand -"," -The right hand side of a condition. - -The conditions ""IS [ NOT ]"" and ""IS [ NOT ] DISTINCT FROM"" are null-safe, meaning -NULL is considered the same as NULL, and the condition never evaluates to NULL. - -When comparing with LIKE, the wildcards characters are ""_"" (any one character) -and ""%"" (any characters). The database uses an index when comparing with LIKE -except if the operand starts with a wildcard. To search for the characters ""%"" and -""_"", the characters need to be escaped. The default escape character is "" \ "" (backslash). -To select no escape character, use ""ESCAPE ''"" (empty string). -At most one escape character is allowed. -Each character that follows the escape character in the pattern needs to match exactly. -Patterns that end with an escape character are invalid and the expression returns NULL. - -ILIKE does a case-insensitive compare. - -When comparing with REGEXP, regular expression matching is used. -See Java ""Matcher.find"" for details. -"," -LIKE 'Jo%' -" - -"Other Grammar","Constraint"," -[ constraintNameDefinition ] -{ CHECK expression - | UNIQUE ( columnName [,...] ) - | referentialConstraint - | PRIMARY KEY [ HASH ] ( columnName [,...] ) } -"," -Defines a constraint. -The check condition must evaluate to TRUE, FALSE or NULL. -TRUE and NULL mean the operation is to be permitted, -and FALSE means the operation is to be rejected. -To prevent NULL in a column, use NOT NULL instead of a check constraint. -"," -PRIMARY KEY(ID, NAME) -" - -"Other Grammar","Constraint Name Definition"," -CONSTRAINT [ IF NOT EXISTS ] newConstraintName -"," -Defines a constraint name. -"," -CONSTRAINT CONST_ID -" - -"Other Grammar","Csv Options"," -charsetString [, fieldSepString [, fieldDelimString [, escString [, nullString]]]]] - | optionString -"," -Optional parameters for CSVREAD and CSVWRITE. -Instead of setting the options one by one, all options can be -combined into a space separated key-value pairs, as follows: -""STRINGDECODE('charset=UTF-8 escape=\"" fieldDelimiter=\"" fieldSeparator=, ' ||"" -""'lineComment=# lineSeparator=\n null= rowSeparator=')"". -The following options are supported: - -""caseSensitiveColumnNames"" (true or false; disabled by default), - -""charset"" (for example 'UTF-8'), - -""escape"" (the character that escapes the field delimiter), - -""fieldDelimiter"" (a double quote by default), - -""fieldSeparator"" (a comma by default), - -""lineComment"" (disabled by default), - -""lineSeparator"" (the line separator used for writing; ignored for reading), - -""null"", Support reading existing CSV files that contain explicit ""null"" delimiters. -Note that an empty, unquoted values are also treated as null. - -""preserveWhitespace"" (true or false; disabled by default), - -""writeColumnHeader"" (true or false; enabled by default). - -For a newline or other special character, use STRINGDECODE as in the example above. -A space needs to be escaped with a backslash (""'\ '""), and -a backslash needs to be escaped with another backslash (""'\\'""). -All other characters are not to be escaped, that means -newline and tab characters are written as such. -"," -CALL CSVWRITE('test2.csv', 'SELECT * FROM TEST', 'charset=UTF-8 fieldSeparator=|'); -" - -"Other Grammar","Data Type"," -intType | booleanType | tinyintType | smallintType | bigintType | identityType - | decimalType | doubleType | realType | dateType | timeType | timestampType - | timestampWithTimeZoneType | binaryType | otherType | varcharType - | varcharIgnorecaseType | charType | blobType | clobType | uuidType - | arrayType | enumType -"," -A data type definition. -"," -INT -" - -"Other Grammar","Date"," -DATE 'yyyy-MM-dd' -"," -A date literal. The limitations are the same as for the Java data type -""java.sql.Date"", but for compatibility with other databases the suggested minimum -and maximum years are 0001 and 9999. -"," -DATE '2004-12-31' -" - -"Other Grammar","Decimal"," -[ + | - ] { { number [ . number ] } | { . number } } -[ E [ + | - ] expNumber [...] ] ] -"," -A decimal number with fixed precision and scale. -Internally, ""java.lang.BigDecimal"" is used. -To ensure the floating point representation is used, use CAST(X AS DOUBLE). -There are some special decimal values: to represent positive infinity, use ""POWER(0, -1)""; -for negative infinity, use ""(-POWER(0, -1))""; for -0.0, use ""(-CAST(0 AS DOUBLE))""; -for ""NaN"" (not a number), use ""SQRT(-1)"". -"," -SELECT -1600.05 -SELECT CAST(0 AS DOUBLE) -SELECT -1.4e-10 -" - -"Other Grammar","Digit"," -0-9 -"," -A digit. -"," -0 -" - -"Other Grammar","Dollar Quoted String"," -$$anythingExceptTwoDollarSigns$$ -"," -A string starts and ends with two dollar signs. Two dollar signs are not allowed -within the text. A whitespace is required before the first set of dollar signs. -No escaping is required within the text. -"," -$$John's car$$ -" - -"Other Grammar","Expression"," -andCondition [ { OR andCondition } [...] ] -"," -Value or condition. -"," -ID=1 OR NAME='Hi' -" - -"Other Grammar","Factor"," -term [ { { * | / | % } term } [...] ] -"," -A value or a numeric factor. -"," -ID * 10 -" - -"Other Grammar","Hex"," -{ { digit | a-f | A-F } { digit | a-f | A-F } } [...] -"," -The hexadecimal representation of a number or of bytes. Two characters are one -byte. -"," -cafe -" - -"Other Grammar","Hex Number"," -[ + | - ] 0x hex -"," -A number written in hexadecimal notation. -"," -0xff -" - -"Other Grammar","Index Column"," -columnName [ ASC | DESC ] [ NULLS { FIRST | LAST } ] -"," -Indexes this column in ascending or descending order. Usually it is not required -to specify the order; however doing so will speed up large queries that order -the column in the same way. -"," -NAME -" - -"Other Grammar","Int"," -[ + | - ] number -"," -The maximum integer number is 2147483647, the minimum is -2147483648. -"," -10 -" - -"Other Grammar","Long"," -[ + | - ] number -"," -Long numbers are between -9223372036854775808 and 9223372036854775807. -"," -100000 -" - -"Other Grammar","Name"," -{ { A-Z|_ } [ { A-Z|_|0-9 } [...] ] } | quotedName -"," -Names are not case sensitive. There is no maximum name length. -"," -TEST -" - -"Other Grammar","Null"," -NULL -"," -NULL is a value without data type and means 'unknown value'. -"," -NULL -" - -"Other Grammar","Number"," -digit [...] -"," -The maximum length of the number depends on the data type used. -"," -100 -" - -"Other Grammar","Numeric"," -decimal | int | long | hexNumber -"," -The data type of a numeric value is always the lowest possible for the given value. -If the number contains a dot this is decimal; otherwise it is int, long, or decimal (depending on the value). -"," -SELECT -1600.05 -SELECT CAST(0 AS DOUBLE) -SELECT -1.4e-10 -" - -"Other Grammar","Operand"," -summand [ { || summand } [...] ] -"," -A value or a concatenation of values. -In the default mode, the result is NULL if either parameter is NULL. -"," -'Hi' || ' Eva' -" - -"Other Grammar","Order"," -{ int | expression } [ ASC | DESC ] [ NULLS { FIRST | LAST } ] -"," -Sorts the result by the given column number, or by an expression. If the -expression is a single parameter, then the value is interpreted as a column -number. Negative column numbers reverse the sort order. -"," -NAME DESC NULLS LAST -" - -"Other Grammar","Quoted Name"," -""anythingExceptDoubleQuote"" -"," -Quoted names are case sensitive, and can contain spaces. There is no maximum -name length. Two double quotes can be used to create a single double quote -inside an identifier. -"," -""FirstName"" -" - -"Other Grammar","Referential Constraint"," -FOREIGN KEY ( columnName [,...] ) -REFERENCES [ refTableName ] [ ( refColumnName [,...] ) ] -[ ON DELETE referentialAction ] [ ON UPDATE referentialAction ] -"," -Defines a referential constraint. -If the table name is not specified, then the same table is referenced. -RESTRICT is the default action. -If the referenced columns are not specified, then the primary key columns are used. -The required indexes are automatically created if required. -Some tables may not be referenced, such as metadata tables. -"," -FOREIGN KEY(ID) REFERENCES TEST(ID) -" - -"Other Grammar","Referential Action"," -CASCADE | RESTRICT | NO ACTION | SET { DEFAULT | NULL } -"," -The action CASCADE will cause conflicting rows in the referencing (child) table to be deleted or updated. -RESTRICT is the default action. -As this database does not support deferred checking, RESTRICT and NO ACTION will both throw an exception if the constraint is violated. -The action SET DEFAULT will set the column in the referencing (child) table to the default value, while SET NULL will set it to NULL. -"," -FOREIGN KEY(ID) REFERENCES TEST(ID) ON UPDATE CASCADE -" - -"Other Grammar","Script Compression Encryption"," -[ COMPRESSION { DEFLATE | LZF | ZIP | GZIP } ] -[ CIPHER cipher PASSWORD string ] -"," -The compression and encryption algorithm to use for script files. -When using encryption, only DEFLATE and LZF are supported. -LZF is faster but uses more space. -"," -COMPRESSION LZF -" - -"Other Grammar","Select Expression"," -* | expression [ [ AS ] columnAlias ] | tableAlias.* -"," -An expression in a SELECT statement. -"," -ID AS VALUE -" - -"Other Grammar","String"," -'anythingExceptSingleQuote' -"," -A string starts and ends with a single quote. Two single quotes can be used to -create a single quote inside a string. -"," -'John''s car' -" - -"Other Grammar","Summand"," -factor [ { { + | - } factor } [...] ] -"," -A value or a numeric sum. - -Please note the text concatenation operator is ""||"". -"," -ID + 20 -" - -"Other Grammar","Table Expression"," -{ [ schemaName. ] tableName | ( select ) | valuesExpression } -[ [ AS ] newTableAlias [ ( columnName [,...] ) ] ] -[ USE INDEX ([ indexName [,...] ]) ] -[ { { LEFT | RIGHT } [ OUTER ] | [ INNER ] | CROSS | NATURAL } - JOIN tableExpression [ ON expression ] ] -"," -Joins a table. The join expression is not supported for cross and natural joins. -A natural join is an inner join, where the condition is automatically on the -columns with the same name. -"," -TEST AS T LEFT JOIN TEST AS T1 ON T.ID = T1.ID -" - -"Other Grammar","Values Expression"," -VALUES { ( expression [,...] ) } [,...] -"," -A list of rows that can be used like a table. -The column list of the resulting table is C1, C2, and so on. -"," -SELECT * FROM (VALUES(1, 'Hello'), (2, 'World')) AS V; -" - -"Other Grammar","Term"," -value - | columnName - | ?[ int ] - | NEXT VALUE FOR sequenceName - | function - | { - | + } term - | ( expression ) - | select - | case - | caseWhen - | tableAlias.columnName - | userDefinedFunctionName -"," -A value. Parameters can be indexed, for example ""?1"" meaning the first parameter. -Each table has a pseudo-column named ""_ROWID_"" that contains the unique row identifier. -"," -'Hello' -" - -"Other Grammar","Time"," -TIME [ WITHOUT TIME ZONE ] 'hh:mm:ss[.nnnnnnnnn]' -"," -A time literal. A value is between 0:00:00 and 23:59:59.999999999 -and has nanosecond resolution. -"," -TIME '23:59:59' -" - -"Other Grammar","Timestamp"," -TIMESTAMP [ WITHOUT TIME ZONE ] 'yyyy-MM-dd hh:mm:ss[.nnnnnnnnn]' -"," -A timestamp literal. The limitations are the same as for the Java data type -""java.sql.Timestamp"", but for compatibility with other databases the suggested -minimum and maximum years are 0001 and 9999. -"," -TIMESTAMP '2005-12-31 23:59:59' -" - -"Other Grammar","Timestamp with time zone"," -TIMESTAMP WITH TIME ZONE 'yyyy-MM-dd hh:mm:ss[.nnnnnnnnn] -[Z | { - | + } timeZoneOffsetString | timeZoneNameString ]' -"," -A timestamp with time zone literal. -If name of time zone is specified it will be converted to time zone offset. -"," -TIMESTAMP WITH TIME ZONE '2005-12-31 23:59:59Z' -TIMESTAMP WITH TIME ZONE '2005-12-31 23:59:59-10:00' -TIMESTAMP WITH TIME ZONE '2005-12-31 23:59:59.123+05' -TIMESTAMP WITH TIME ZONE '2005-12-31 23:59:59.123456789 Europe/London' -" - -"Other Grammar","Date and time"," -date | time | timestamp | timestampWithTimeZone -"," -A literal value of any date-time data type. -"," -TIMESTAMP '1999-01-31 10:00:00' -" - -"Other Grammar","Value"," -string | dollarQuotedString | numeric | dateAndTime | boolean | bytes | array | null -"," -A literal value of any data type, or null. -"," -10 -" - -"Data Types","INT Type"," -INT | INTEGER | MEDIUMINT | INT4 | SIGNED -"," -Possible values: -2147483648 to 2147483647. - -Mapped to ""java.lang.Integer"". -"," -INT -" - -"Data Types","BOOLEAN Type"," -BOOLEAN | BIT | BOOL -"," -Possible values: TRUE and FALSE. - -Mapped to ""java.lang.Boolean"". -"," -BOOLEAN -" - -"Data Types","TINYINT Type"," -TINYINT -"," -Possible values are: -128 to 127. - -Mapped to ""java.lang.Byte"". -"," -TINYINT -" - -"Data Types","SMALLINT Type"," -SMALLINT | INT2 | YEAR -"," -Possible values: -32768 to 32767. - -Mapped to ""java.lang.Short"". -"," -SMALLINT -" - -"Data Types","BIGINT Type"," -BIGINT | INT8 -"," -Possible values: -9223372036854775808 to 9223372036854775807. - -Mapped to ""java.lang.Long"". -"," -BIGINT -" - -"Data Types","IDENTITY Type"," -IDENTITY -"," -Auto-Increment value. Possible values: -9223372036854775808 to -9223372036854775807. Used values are never re-used, even when the transaction is -rolled back. - -Mapped to ""java.lang.Long"". -"," -IDENTITY -" - -"Data Types","DECIMAL Type"," -{ DECIMAL | NUMBER | DEC | NUMERIC } ( precisionInt [ , scaleInt ] ) -"," -Data type with fixed precision and scale. This data type is recommended for -storing currency values. - -Mapped to ""java.math.BigDecimal"". -"," -DECIMAL(20, 2) -" - -"Data Types","DOUBLE Type"," -{ DOUBLE [ PRECISION ] | FLOAT [ ( precisionInt ) ] | FLOAT8 } -"," -A floating point number. Should not be used to represent currency values, because -of rounding problems. -If precision value is specified for FLOAT type name, it should be from 25 to 53. - -Mapped to ""java.lang.Double"". -"," -DOUBLE -" - -"Data Types","REAL Type"," -{ REAL | FLOAT ( precisionInt ) | FLOAT4 } -"," -A single precision floating point number. Should not be used to represent currency -values, because of rounding problems. -Precision value for FLOAT type name should be from 0 to 24. - -Mapped to ""java.lang.Float"". -"," -REAL -" - -"Data Types","TIME Type"," -TIME [ ( precisionInt ) ] [ WITHOUT TIME ZONE ] -"," -The time data type. The format is hh:mm:ss[.nnnnnnnnn]. -If fractional seconds precision is specified it should be from 0 to 9, 0 is default. - -Mapped to ""java.sql.Time"". When converted to a ""java.sql.Date"", the date is set to ""1970-01-01"". -""java.time.LocalTime"" is also supported on Java 8 and later versions. -Resolution of ""java.sql.Time"" is limited to milliseconds, use ""String"" or ""java.time.LocalTime"" if you need nanosecond resolution. -"," -TIME -" - -"Data Types","DATE Type"," -DATE -"," -The date data type. The format is yyyy-MM-dd. - -Mapped to ""java.sql.Date"", with the time set to ""00:00:00"" -(or to the next possible time if midnight doesn't exist for the given date and timezone due to a daylight saving change). -""java.time.LocalDate"" is also supported on Java 8 and later versions. -"," -DATE -" - -"Data Types","TIMESTAMP Type"," -{ TIMESTAMP [ ( precisionInt ) ] [ WITHOUT TIME ZONE ] - | DATETIME | SMALLDATETIME } -"," -The timestamp data type. The format is yyyy-MM-dd hh:mm:ss[.nnnnnnnnn]. -Stored internally as a BCD-encoded date, and nanoseconds since midnight. -If fractional seconds precision is specified it should be from 0 to 9, 6 is default. - -Mapped to ""java.sql.Timestamp"" (""java.util.Date"" may be used too). -""java.time.LocalDateTime"" is also supported on Java 8 and later versions. -"," -TIMESTAMP -" - -"Data Types","TIMESTAMP WITH TIME ZONE Type"," -TIMESTAMP [ ( precisionInt ) ] WITH TIME ZONE -"," -The timestamp with time zone data type. -Stored internally as a BCD-encoded date, nanoseconds since midnight, and time zone offset in minutes. -If fractional seconds precision is specified it should be from 0 to 9, 6 is default. - -Mapped to ""org.h2.api.TimestampWithTimeZone"". -""java.time.OffsetDateTime"" and ""java.time.Instant"" are also supported on Java 8 and later versions. - -Values of this data type are compared by UTC values. It means that ""2010-01-01 10:00:00+01"" is greater than ""2010-01-01 11:00:00+03"". - -Conversion to ""TIMESTAMP"" uses time zone offset to get UTC time and converts it to local time using the system time zone. -Conversion from ""TIMESTAMP"" does the same operations in reverse and sets time zone offset to offset of the system time zone. -"," -TIMESTAMP WITH TIME ZONE -" - -"Data Types","BINARY Type"," -{ BINARY | VARBINARY | LONGVARBINARY | RAW | BYTEA } -[ ( precisionInt ) ] -"," -Represents a byte array. For very long arrays, use BLOB. -The maximum size is 2 GB, but the whole object is kept in -memory when using this data type. The precision is a size constraint; -only the actual data is persisted. For large text data BLOB or CLOB -should be used. - -Mapped to byte[]. -"," -BINARY(1000) -" - -"Data Types","OTHER Type"," -OTHER -"," -This type allows storing serialized Java objects. Internally, a byte array is used. -Serialization and deserialization is done on the client side only. -Deserialization is only done when ""getObject"" is called. -Java operations cannot be executed inside the database engine for security reasons. -Use ""PreparedStatement.setObject"" to store values. - -Mapped to ""java.lang.Object"" (or any subclass). -"," -OTHER -" - -"Data Types","VARCHAR Type"," -{ VARCHAR | LONGVARCHAR | VARCHAR2 | NVARCHAR - | NVARCHAR2 | VARCHAR_CASESENSITIVE} [ ( precisionInt ) ] -"," -A Unicode String. -Use two single quotes ('') to create a quote. - -The maximum precision is ""Integer.MAX_VALUE"". -The precision is a size constraint; only the actual data is persisted. - -The whole text is loaded into memory when using this data type. -For large text data CLOB should be used; see there for details. - -Mapped to ""java.lang.String"". -"," -VARCHAR(255) -" - -"Data Types","VARCHAR_IGNORECASE Type"," -VARCHAR_IGNORECASE [ ( precisionInt ) ] -"," -Same as VARCHAR, but not case sensitive when comparing. -Stored in mixed case. - -The maximum precision is ""Integer.MAX_VALUE"". -The precision is a size constraint; only the actual data is persisted. - -The whole text is loaded into memory when using this data type. -For large text data CLOB should be used; see there for details. - -Mapped to ""java.lang.String"". -"," -VARCHAR_IGNORECASE -" - -"Data Types","CHAR Type"," -{ CHAR | CHARACTER | NCHAR } [ ( precisionInt ) ] -"," -A Unicode String. -This type is supported for compatibility with other databases and older applications. -The difference to VARCHAR is that trailing spaces are ignored and not persisted. - -The maximum precision is ""Integer.MAX_VALUE"". -The precision is a size constraint; only the actual data is persisted. - -The whole text is kept in memory when using this data type. -For large text data CLOB should be used; see there for details. - -Mapped to ""java.lang.String"". -"," -CHAR(10) -" - -"Data Types","BLOB Type"," -{ BLOB | TINYBLOB | MEDIUMBLOB | LONGBLOB | IMAGE | OID } -[ ( precisionInt ) ] -"," -Like BINARY, but intended for very large values such as files or images. Unlike -when using BINARY, large objects are not kept fully in-memory. Use -""PreparedStatement.setBinaryStream"" to store values. See also CLOB and -Advanced / Large Objects. - -Mapped to ""java.sql.Blob"" (""java.io.InputStream"" is also supported). -"," -BLOB -" - -"Data Types","CLOB Type"," -{ CLOB | TINYTEXT | TEXT | MEDIUMTEXT | LONGTEXT | NTEXT | NCLOB } -[ ( precisionInt ) ] -"," -CLOB is like VARCHAR, but intended for very large values. Unlike when using -VARCHAR, large CLOB objects are not kept fully in-memory; instead, they are streamed. -CLOB should be used for documents and texts with arbitrary size such as XML or -HTML documents, text files, or memo fields of unlimited size. Use -""PreparedStatement.setCharacterStream"" to store values. See also Advanced / Large Objects. - -VARCHAR should be used for text with relatively short average size (for example -shorter than 200 characters). Short CLOB values are stored inline, but there is -an overhead compared to VARCHAR. - -Mapped to ""java.sql.Clob"" (""java.io.Reader"" is also supported). -"," -CLOB -" - -"Data Types","UUID Type"," -UUID -"," -Universally unique identifier. This is a 128 bit value. -To store values, use ""PreparedStatement.setBytes"", -""setString"", or ""setObject(uuid)"" (where ""uuid"" is a ""java.util.UUID""). -""ResultSet.getObject"" will return a ""java.util.UUID"". - -Please note that using an index on randomly generated data will -result on poor performance once there are millions of rows in a table. -The reason is that the cache behavior is very bad with randomly distributed data. -This is a problem for any database system. - -For details, see the documentation of ""java.util.UUID"". -"," -UUID -" - -"Data Types","ARRAY Type"," -ARRAY -"," -An array of values. -Mapped to ""java.lang.Object[]"" (arrays of any non-primitive type are also supported). - - -Use a value list (1, 2) or ""PreparedStatement.setObject(.., new Object[] {..})"" to store values, -and ""ResultSet.getObject(..)"" or ""ResultSet.getArray(..)"" to retrieve the values. -"," -ARRAY -" - -"Data Types","ENUM Type"," -{ ENUM (string [, ... ]) } -"," -A type with enumerated values. -Mapped to ""java.lang.Integer"". - -The first provided value is mapped to 0, the -second mapped to 1, and so on. - -Duplicate and empty values are not permitted. -"," - -ENUM('clubs', 'diamonds', 'hearts', 'spades') -" -"Data Types","GEOMETRY Type"," -GEOMETRY -"," -A spatial geometry type, based on the ""org.locationtech.jts"" library. -Normally represented in textual format using the WKT (well known text) format. - -Use a quoted string containing a WKT formatted string or ""PreparedStatement.setObject()"" to store values, -and ""ResultSet.getObject(..)"" or ""ResultSet.getString(..)"" to retrieve the values. -"," -GEOMETRY -" - -"Functions (Aggregate)","AVG"," -AVG ( [ DISTINCT ] { numeric } ) [ FILTER ( WHERE expression ) ] -"," -The average (mean) value. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -The returned value is of the same data type as the parameter. -"," -AVG(X) -" - -"Functions (Aggregate)","BIT_AND"," -BIT_AND(expression) [ FILTER ( WHERE expression ) ] -"," -The bitwise AND of all non-null values. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -BIT_AND(ID) -" - -"Functions (Aggregate)","BIT_OR"," -BIT_OR(expression) [ FILTER ( WHERE expression ) ] -"," -The bitwise OR of all non-null values. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -BIT_OR(ID) -" - -"Functions (Aggregate)","BOOL_AND"," -BOOL_AND(boolean) [ FILTER ( WHERE expression ) ] -"," -Returns true if all expressions are true. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -BOOL_AND(ID>10) -" - -"Functions (Aggregate)","BOOL_OR"," -BOOL_OR(boolean) [ FILTER ( WHERE expression ) ] -"," -Returns true if any expression is true. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -BOOL_OR(NAME LIKE 'W%') -" - -"Functions (Aggregate)","COUNT"," -COUNT( { * | { [ DISTINCT ] expression } } ) [ FILTER ( WHERE expression ) ] -"," -The count of all row, or of the non-null values. -This method returns a long. -If no rows are selected, the result is 0. -Aggregates are only allowed in select statements. -"," -COUNT(*) -" - -"Functions (Aggregate)","GROUP_CONCAT"," -GROUP_CONCAT ( [ DISTINCT ] string -[ ORDER BY { expression [ ASC | DESC ] } [,...] ] -[ SEPARATOR expression ] ) [ FILTER ( WHERE expression ) ] -"," -Concatenates strings with a separator. -The default separator is a ',' (without space). -This method returns a string. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -GROUP_CONCAT(NAME ORDER BY ID SEPARATOR ', ') -" - -"Functions (Aggregate)","ARRAY_AGG"," -ARRAY_AGG ( [ DISTINCT ] string -[ ORDER BY { expression [ ASC | DESC ] } [,...] ] ) -[ FILTER ( WHERE expression ) ] -"," -Aggregate the value into an array. -This method returns an array. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -ARRAY_AGG(NAME ORDER BY ID) -" - -"Functions (Aggregate)","MAX"," -MAX(value) [ FILTER ( WHERE expression ) ] -"," -The highest value. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -The returned value is of the same data type as the parameter. -"," -MAX(NAME) -" - -"Functions (Aggregate)","MIN"," -MIN(value) [ FILTER ( WHERE expression ) ] -"," -The lowest value. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -The returned value is of the same data type as the parameter. -"," -MIN(NAME) -" - -"Functions (Aggregate)","SUM"," -SUM( [ DISTINCT ] { numeric } ) [ FILTER ( WHERE expression ) ] -"," -The sum of all values. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -The data type of the returned value depends on the parameter data type like this: -""BOOLEAN, TINYINT, SMALLINT, INT -> BIGINT, BIGINT -> DECIMAL, REAL -> DOUBLE"" -"," -SUM(X) -" - -"Functions (Aggregate)","SELECTIVITY"," -SELECTIVITY(value) [ FILTER ( WHERE expression ) ] -"," -Estimates the selectivity (0-100) of a value. -The value is defined as (100 * distinctCount / rowCount). -The selectivity of 0 rows is 0 (unknown). -Up to 10000 values are kept in memory. -Aggregates are only allowed in select statements. -"," -SELECT SELECTIVITY(FIRSTNAME), SELECTIVITY(NAME) FROM TEST WHERE ROWNUM()<20000 -" - -"Functions (Aggregate)","STDDEV_POP"," -STDDEV_POP( [ DISTINCT ] numeric ) [ FILTER ( WHERE expression ) ] -"," -The population standard deviation. -This method returns a double. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -STDDEV_POP(X) -" - -"Functions (Aggregate)","STDDEV_SAMP"," -STDDEV_SAMP( [ DISTINCT ] numeric ) [ FILTER ( WHERE expression ) ] -"," -The sample standard deviation. -This method returns a double. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -STDDEV(X) -" - -"Functions (Aggregate)","VAR_POP"," -VAR_POP( [ DISTINCT ] numeric ) [ FILTER ( WHERE expression ) ] -"," -The population variance (square of the population standard deviation). -This method returns a double. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -VAR_POP(X) -" - -"Functions (Aggregate)","VAR_SAMP"," -VAR_SAMP( [ DISTINCT ] numeric ) [ FILTER ( WHERE expression ) ] -"," -The sample variance (square of the sample standard deviation). -This method returns a double. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -VAR_SAMP(X) -" - -"Functions (Aggregate)","MEDIAN"," -MEDIAN( [ DISTINCT ] value ) [ FILTER ( WHERE expression ) ] -"," -The value separating the higher half of a values from the lower half. -Returns the middle value or an interpolated value between two middle values if number of values is even. -Interpolation is only supported for numeric, date, and time data types. -NULL values are ignored in the calculation. -If no rows are selected, the result is NULL. -Aggregates are only allowed in select statements. -"," -MEDIAN(X) -" - -"Functions (Numeric)","ABS"," -ABS ( { numeric } ) -"," -See also Java ""Math.abs"". -Please note that ""Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE"" and ""Math.abs(Long.MIN_VALUE) == Long.MIN_VALUE"". -The returned value is of the same data type as the parameter. -"," -ABS(ID) -" - -"Functions (Numeric)","ACOS"," -ACOS(numeric) -"," -Calculate the arc cosine. -See also Java ""Math.acos"". -This method returns a double. -"," -ACOS(D) -" - -"Functions (Numeric)","ASIN"," -ASIN(numeric) -"," -Calculate the arc sine. -See also Java ""Math.asin"". -This method returns a double. -"," -ASIN(D) -" - -"Functions (Numeric)","ATAN"," -ATAN(numeric) -"," -Calculate the arc tangent. -See also Java ""Math.atan"". -This method returns a double. -"," -ATAN(D) -" - -"Functions (Numeric)","COS"," -COS(numeric) -"," -Calculate the trigonometric cosine. -See also Java ""Math.cos"". -This method returns a double. -"," -COS(ANGLE) -" - -"Functions (Numeric)","COSH"," -COSH(numeric) -"," -Calculate the hyperbolic cosine. -See also Java ""Math.cosh"". -This method returns a double. -"," -COSH(X) -" - -"Functions (Numeric)","COT"," -COT(numeric) -"," -Calculate the trigonometric cotangent (""1/TAN(ANGLE)""). -See also Java ""Math.*"" functions. -This method returns a double. -"," -COT(ANGLE) -" - -"Functions (Numeric)","SIN"," -SIN(numeric) -"," -Calculate the trigonometric sine. -See also Java ""Math.sin"". -This method returns a double. -"," -SIN(ANGLE) -" - -"Functions (Numeric)","SINH"," -SINH(numeric) -"," -Calculate the hyperbolic sine. -See also Java ""Math.sinh"". -This method returns a double. -"," -SINH(ANGLE) -" - -"Functions (Numeric)","TAN"," -TAN(numeric) -"," -Calculate the trigonometric tangent. -See also Java ""Math.tan"". -This method returns a double. -"," -TAN(ANGLE) -" - -"Functions (Numeric)","TANH"," -TANH(numeric) -"," -Calculate the hyperbolic tangent. -See also Java ""Math.tanh"". -This method returns a double. -"," -TANH(X) -" - -"Functions (Numeric)","ATAN2"," -ATAN2(numeric, numeric) -"," -Calculate the angle when converting the rectangular coordinates to polar coordinates. -See also Java ""Math.atan2"". -This method returns a double. -"," -ATAN2(X, Y) -" - -"Functions (Numeric)","BITAND"," -BITAND(long, long) -"," -The bitwise AND operation. -This method returns a long. -See also Java operator &. -"," -BITAND(A, B) -" - -"Functions (Numeric)","BITGET"," -BITGET(long, int) -"," -Returns true if and only if the first parameter has a bit set in the -position specified by the second parameter. -This method returns a boolean. -The second parameter is zero-indexed; the least significant bit has position 0. -"," -BITGET(A, 1) -" - -"Functions (Numeric)","BITOR"," -BITOR(long, long) -"," -The bitwise OR operation. -This method returns a long. -See also Java operator |. -"," -BITOR(A, B) -" - -"Functions (Numeric)","BITXOR"," -BITXOR(long, long) -"," -The bitwise XOR operation. -This method returns a long. -See also Java operator ^. -"," -BITXOR(A, B) -" - -"Functions (Numeric)","MOD"," -MOD(long, long) -"," -The modulo operation. -This method returns a long. -See also Java operator %. -"," -MOD(A, B) -" - -"Functions (Numeric)","CEILING"," -{ CEILING | CEIL } (numeric) -"," -See also Java ""Math.ceil"". -This method returns a double. -"," -CEIL(A) -" - -"Functions (Numeric)","DEGREES"," -DEGREES(numeric) -"," -See also Java ""Math.toDegrees"". -This method returns a double. -"," -DEGREES(A) -" - -"Functions (Numeric)","EXP"," -EXP(numeric) -"," -See also Java ""Math.exp"". -This method returns a double. -"," -EXP(A) -" - -"Functions (Numeric)","FLOOR"," -FLOOR(numeric) -"," -See also Java ""Math.floor"". -This method returns a double. -"," -FLOOR(A) -" - -"Functions (Numeric)","LOG"," -{ LOG | LN } (numeric) -"," -See also Java ""Math.log"". -In the PostgreSQL mode, LOG(x) is base 10. -This method returns a double. -"," -LOG(A) -" - -"Functions (Numeric)","LOG10"," -LOG10(numeric) -"," -See also Java ""Math.log10"". -This method returns a double. -"," -LOG10(A) -" - -"Functions (Numeric)","RADIANS"," -RADIANS(numeric) -"," -See also Java ""Math.toRadians"". -This method returns a double. -"," -RADIANS(A) -" - -"Functions (Numeric)","SQRT"," -SQRT(numeric) -"," -See also Java ""Math.sqrt"". -This method returns a double. -"," -SQRT(A) -" - -"Functions (Numeric)","PI"," -PI() -"," -See also Java ""Math.PI"". -This method returns a double. -"," -PI() -" - -"Functions (Numeric)","POWER"," -POWER(numeric, numeric) -"," -See also Java ""Math.pow"". -This method returns a double. -"," -POWER(A, B) -" - -"Functions (Numeric)","RAND"," -{ RAND | RANDOM } ( [ int ] ) -"," -Calling the function without parameter returns the next a pseudo random number. -Calling it with an parameter seeds the session's random number generator. -This method returns a double between 0 (including) and 1 (excluding). -"," -RAND() -" - -"Functions (Numeric)","RANDOM_UUID"," -{ RANDOM_UUID | UUID } () -"," -Returns a new UUID with 122 pseudo random bits. - -Please note that using an index on randomly generated data will -result on poor performance once there are millions of rows in a table. -The reason is that the cache behavior is very bad with randomly distributed data. -This is a problem for any database system. -"," -RANDOM_UUID() -" - -"Functions (Numeric)","ROUND"," -ROUND(numeric [, digitsInt]) -"," -Rounds to a number of digits, or to the nearest long if the number of digits if not set. -This method returns a numeric (the same type as the input). -"," -ROUND(VALUE, 2) -" - -"Functions (Numeric)","ROUNDMAGIC"," -ROUNDMAGIC(numeric) -"," -This function rounds numbers in a good way, but it is slow. -It has a special handling for numbers around 0. -Only numbers smaller or equal +/-1000000000000 are supported. -The value is converted to a String internally, and then the last last 4 characters are checked. -'000x' becomes '0000' and '999x' becomes '999999', which is rounded automatically. -This method returns a double. -"," -ROUNDMAGIC(VALUE/3*3) -" - -"Functions (Numeric)","SECURE_RAND"," -SECURE_RAND(int) -"," -Generates a number of cryptographically secure random numbers. -This method returns bytes. -"," -CALL SECURE_RAND(16) -" - -"Functions (Numeric)","SIGN"," -SIGN ( { numeric } ) -"," -Returns -1 if the value is smaller 0, 0 if zero, and otherwise 1. -"," -SIGN(VALUE) -" - -"Functions (Numeric)","ENCRYPT"," -ENCRYPT(algorithmString, keyBytes, dataBytes) -"," -Encrypts data using a key. -The supported algorithm is AES. -The block size is 16 bytes. -This method returns bytes. -"," -CALL ENCRYPT('AES', '00', STRINGTOUTF8('Test')) -" - -"Functions (Numeric)","DECRYPT"," -DECRYPT(algorithmString, keyBytes, dataBytes) -"," -Decrypts data using a key. -The supported algorithm is AES. -The block size is 16 bytes. -This method returns bytes. -"," -CALL TRIM(CHAR(0) FROM UTF8TOSTRING( - DECRYPT('AES', '00', '3fabb4de8f1ee2e97d7793bab2db1116'))) -" - -"Functions (Numeric)","HASH"," -HASH(algorithmString, dataBytes, iterationInt) -"," -Calculate the hash value using an algorithm, and repeat this process for a number of iterations. -Currently, the only algorithm supported is SHA256. -This method returns bytes. -"," -CALL HASH('SHA256', STRINGTOUTF8('Password'), 1000) -" - -"Functions (Numeric)","TRUNCATE"," -{ TRUNC | TRUNCATE } ( { {numeric, digitsInt} - | timestamp | timestampWithTimeZone | date | timestampString } ) -"," -Truncates to a number of digits (to the next value closer to 0). -This method returns a double. -When used with a timestamp, truncates a timestamp to a date (day) value. -When used with a date, truncates a date to a date (day) value less time part. -When used with a timestamp as string, truncates a timestamp to a date (day) value. -"," -TRUNCATE(VALUE, 2) -" - -"Functions (Numeric)","COMPRESS"," -COMPRESS(dataBytes [, algorithmString]) -"," -Compresses the data using the specified compression algorithm. -Supported algorithms are: LZF (faster but lower compression; default), and DEFLATE (higher compression). -Compression does not always reduce size. Very small objects and objects with little redundancy may get larger. -This method returns bytes. -"," -COMPRESS(STRINGTOUTF8('Test')) -" - -"Functions (Numeric)","EXPAND"," -EXPAND(bytes) -"," -Expands data that was compressed using the COMPRESS function. -This method returns bytes. -"," -UTF8TOSTRING(EXPAND(COMPRESS(STRINGTOUTF8('Test')))) -" - -"Functions (Numeric)","ZERO"," -ZERO() -"," -Returns the value 0. This function can be used even if numeric literals are disabled. -"," -ZERO() -" - -"Functions (String)","ASCII"," -ASCII(string) -"," -Returns the ASCII value of the first character in the string. -This method returns an int. -"," -ASCII('Hi') -" -"Functions (String)","BIT_LENGTH"," -BIT_LENGTH(string) -"," -Returns the number of bits in a string. -This method returns a long. -For BLOB, CLOB, BYTES and JAVA_OBJECT, the precision is used. Each character needs 16 bits. -"," -BIT_LENGTH(NAME) -" - -"Functions (String)","LENGTH"," -{ LENGTH | CHAR_LENGTH | CHARACTER_LENGTH } ( string ) -"," -Returns the number of characters in a string. -This method returns a long. -For BLOB, CLOB, BYTES and JAVA_OBJECT, the precision is used. -"," -LENGTH(NAME) -" - -"Functions (String)","OCTET_LENGTH"," -OCTET_LENGTH(string) -"," -Returns the number of bytes in a string. -This method returns a long. -For BLOB, CLOB, BYTES and JAVA_OBJECT, the precision is used. -Each character needs 2 bytes. -"," -OCTET_LENGTH(NAME) -" - -"Functions (String)","CHAR"," -{ CHAR | CHR } ( int ) -"," -Returns the character that represents the ASCII value. -This method returns a string. -"," -CHAR(65) -" - -"Functions (String)","CONCAT"," -CONCAT(string, string [,...]) -"," -Combines strings. -Unlike with the operator ""||"", NULL parameters are ignored, -and do not cause the result to become NULL. -This method returns a string. -"," -CONCAT(NAME, '!') -" - -"Functions (String)","CONCAT_WS"," -CONCAT_WS(separatorString, string, string [,...]) -"," -Combines strings with separator. -Unlike with the operator ""||"", NULL parameters are ignored, -and do not cause the result to become NULL. -This method returns a string. -"," -CONCAT_WS(',', NAME, '!') -" - -"Functions (String)","DIFFERENCE"," -DIFFERENCE(string, string) -"," -Returns the difference between the sounds of two strings. -This method returns an int. -"," -DIFFERENCE(T1.NAME, T2.NAME) -" - -"Functions (String)","HEXTORAW"," -HEXTORAW(string) -"," -Converts a hex representation of a string to a string. -4 hex characters per string character are used. -"," -HEXTORAW(DATA) -" - -"Functions (String)","RAWTOHEX"," -RAWTOHEX(string) -"," -Converts a string to the hex representation. -4 hex characters per string character are used. -This method returns a string. -"," -RAWTOHEX(DATA) -" - -"Functions (String)","INSTR"," -INSTR(string, searchString, [, startInt]) -"," -Returns the location of a search string in a string. -If a start position is used, the characters before it are ignored. -If position is negative, the rightmost location is returned. -0 is returned if the search string is not found. -Please note this function is case sensitive, even if the parameters are not. -"," -INSTR(EMAIL,'@') -" - -"Functions (String)","INSERT Function"," -INSERT(originalString, startInt, lengthInt, addString) -"," -Inserts a additional string into the original string at a specified start position. -The length specifies the number of characters that are removed at the start position in the original string. -This method returns a string. -"," -INSERT(NAME, 1, 1, ' ') -" - -"Functions (String)","LOWER"," -{ LOWER | LCASE } ( string ) -"," -Converts a string to lowercase. -"," -LOWER(NAME) -" - -"Functions (String)","UPPER"," -{ UPPER | UCASE } ( string ) -"," -Converts a string to uppercase. -"," -UPPER(NAME) -" - -"Functions (String)","LEFT"," -LEFT(string, int) -"," -Returns the leftmost number of characters. -"," -LEFT(NAME, 3) -" - -"Functions (String)","RIGHT"," -RIGHT(string, int) -"," -Returns the rightmost number of characters. -"," -RIGHT(NAME, 3) -" - -"Functions (String)","LOCATE"," -LOCATE(searchString, string [, startInt]) -"," -Returns the location of a search string in a string. -If a start position is used, the characters before it are ignored. -If position is negative, the rightmost location is returned. -0 is returned if the search string is not found. -"," -LOCATE('.', NAME) -" - -"Functions (String)","POSITION"," -POSITION(searchString, string) -"," -Returns the location of a search string in a string. See also LOCATE. -"," -POSITION('.', NAME) -" - -"Functions (String)","LPAD"," -LPAD(string, int[, paddingString]) -"," -Left pad the string to the specified length. -If the length is shorter than the string, it will be truncated at the end. -If the padding string is not set, spaces will be used. -"," -LPAD(AMOUNT, 10, '*') -" - -"Functions (String)","RPAD"," -RPAD(string, int[, paddingString]) -"," -Right pad the string to the specified length. -If the length is shorter than the string, it will be truncated. -If the padding string is not set, spaces will be used. -"," -RPAD(TEXT, 10, '-') -" - -"Functions (String)","LTRIM"," -LTRIM(string) -"," -Removes all leading spaces from a string. -"," -LTRIM(NAME) -" - -"Functions (String)","RTRIM"," -RTRIM(string) -"," -Removes all trailing spaces from a string. -"," -RTRIM(NAME) -" - -"Functions (String)","TRIM"," -TRIM ( [ { LEADING | TRAILING | BOTH } [ string ] FROM ] string ) -"," -Removes all leading spaces, trailing spaces, or spaces at both ends, from a string. -Other characters can be removed as well. -"," -TRIM(BOTH '_' FROM NAME) -" - -"Functions (String)","REGEXP_REPLACE"," -REGEXP_REPLACE(inputString, regexString, replacementString [, flagsString]) -"," -Replaces each substring that matches a regular expression. -For details, see the Java ""String.replaceAll()"" method. -If any parameter is null (except optional flagsString parameter), the result is null. - -Flags values limited to 'i', 'c', 'n', 'm'. Other symbols causes exception. -Multiple symbols could be uses in one flagsString parameter (like 'im'). -Later flags overrides first ones, for example 'ic' equivalent to case sensitive matching 'c'. - -'i' enables case insensitive matching (Pattern.CASE_INSENSITIVE) - -'c' disables case insensitive matching (Pattern.CASE_INSENSITIVE) - -'n' allows the period to match the newline character (Pattern.DOTALL) - -'m' enables multiline mode (Pattern.MULTILINE) - -"," -REGEXP_REPLACE('Hello World', ' +', ' ') -REGEXP_REPLACE('Hello WWWWorld', 'w+', 'W', 'i') -" - -"Functions (String)","REGEXP_LIKE"," -REGEXP_LIKE(inputString, regexString [, flagsString]) -"," -Matches string to a regular expression. -For details, see the Java ""Matcher.find()"" method. -If any parameter is null (except optional flagsString parameter), the result is null. - -Flags values limited to 'i', 'c', 'n', 'm'. Other symbols causes exception. -Multiple symbols could be uses in one flagsString parameter (like 'im'). -Later flags overrides first ones, for example 'ic' equivalent to case sensitive matching 'c'. - -'i' enables case insensitive matching (Pattern.CASE_INSENSITIVE) - -'c' disables case insensitive matching (Pattern.CASE_INSENSITIVE) - -'n' allows the period to match the newline character (Pattern.DOTALL) - -'m' enables multiline mode (Pattern.MULTILINE) - -"," -REGEXP_LIKE('Hello World', '[A-Z ]*', 'i') -" - - -"Functions (String)","REPEAT"," -REPEAT(string, int) -"," -Returns a string repeated some number of times. -"," -REPEAT(NAME || ' ', 10) -" - -"Functions (String)","REPLACE"," -REPLACE(string, searchString [, replacementString]) -"," -Replaces all occurrences of a search string in a text with another string. -If no replacement is specified, the search string is removed from the original string. -If any parameter is null, the result is null. -"," -REPLACE(NAME, ' ') -" - -"Functions (String)","SOUNDEX"," -SOUNDEX(string) -"," -Returns a four character code representing the sound of a string. -See also http://www.archives.gov/genealogy/census/soundex.html . -This method returns a string. -"," -SOUNDEX(NAME) -" - -"Functions (String)","SPACE"," -SPACE(int) -"," -Returns a string consisting of a number of spaces. -"," -SPACE(80) -" - -"Functions (String)","STRINGDECODE"," -STRINGDECODE(string) -"," -Converts a encoded string using the Java string literal encoding format. -Special characters are \b, \t, \n, \f, \r, \"", \\, \, \u. -This method returns a string. -"," -CALL STRINGENCODE(STRINGDECODE('Lines 1\nLine 2')) -" - -"Functions (String)","STRINGENCODE"," -STRINGENCODE(string) -"," -Encodes special characters in a string using the Java string literal encoding format. -Special characters are \b, \t, \n, \f, \r, \"", \\, \, \u. -This method returns a string. -"," -CALL STRINGENCODE(STRINGDECODE('Lines 1\nLine 2')) -" - -"Functions (String)","STRINGTOUTF8"," -STRINGTOUTF8(string) -"," -Encodes a string to a byte array using the UTF8 encoding format. -This method returns bytes. -"," -CALL UTF8TOSTRING(STRINGTOUTF8('This is a test')) -" - -"Functions (String)","SUBSTRING"," -{ SUBSTRING | SUBSTR } ( string, startInt [, lengthInt ] ) -"," -Returns a substring of a string starting at a position. -If the start index is negative, then the start index is relative to the end of the string. -The length is optional. -Also supported is: ""SUBSTRING(string [FROM start] [FOR length])"". -"," -CALL SUBSTR('[Hello]', 2, 5); -CALL SUBSTR('Hello World', -5); -" - -"Functions (String)","UTF8TOSTRING"," -UTF8TOSTRING(bytes) -"," -Decodes a byte array in the UTF8 format to a string. -"," -CALL UTF8TOSTRING(STRINGTOUTF8('This is a test')) -" - -"Functions (String)","XMLATTR"," -XMLATTR(nameString, valueString) -"," -Creates an XML attribute element of the form ""name=value"". -The value is encoded as XML text. -This method returns a string. -"," -CALL XMLNODE('a', XMLATTR('href', 'http://h2database.com')) -" - -"Functions (String)","XMLNODE"," -XMLNODE(elementString [, attributesString [, contentString [, indentBoolean]]]) -"," -Create an XML node element. -An empty or null attribute string means no attributes are set. -An empty or null content string means the node is empty. -The content is indented by default if it contains a newline. -This method returns a string. -"," -CALL XMLNODE('a', XMLATTR('href', 'http://h2database.com'), 'H2') -" - -"Functions (String)","XMLCOMMENT"," -XMLCOMMENT(commentString) -"," -Creates an XML comment. -Two dashes (""--"") are converted to ""- -"". -This method returns a string. -"," -CALL XMLCOMMENT('Test') -" - -"Functions (String)","XMLCDATA"," -XMLCDATA(valueString) -"," -Creates an XML CDATA element. -If the value contains ""]]>"", an XML text element is created instead. -This method returns a string. -"," -CALL XMLCDATA('data') -" - -"Functions (String)","XMLSTARTDOC"," -XMLSTARTDOC() -"," -Returns the XML declaration. -The result is always """". -"," -CALL XMLSTARTDOC() -" - -"Functions (String)","XMLTEXT"," -XMLTEXT(valueString [, escapeNewlineBoolean]) -"," -Creates an XML text element. -If enabled, newline and linefeed is converted to an XML entity (&#). -This method returns a string. -"," -CALL XMLTEXT('test') -" - -"Functions (String)","TO_CHAR"," -TO_CHAR(value [, formatString[, nlsParamString]]) -"," -Oracle-compatible TO_CHAR function that can format a timestamp, a number, or text. -"," -CALL TO_CHAR(TIMESTAMP '2010-01-01 00:00:00', 'DD MON, YYYY') -" - -"Functions (String)","TRANSLATE"," -TRANSLATE(value, searchString, replacementString) -"," -Oracle-compatible TRANSLATE function that replaces a sequence of characters in a string with another set of characters. -"," -CALL TRANSLATE('Hello world', 'eo', 'EO') -" - -"Functions (Time and Date)","CURRENT_DATE"," -{ CURRENT_DATE [ () ] | CURDATE() | SYSDATE | TODAY } -"," -Returns the current date. -This method always returns the same value within a transaction. -"," -CURRENT_DATE() -" - -"Functions (Time and Date)","CURRENT_TIME"," -{ CURRENT_TIME [ () ] | CURTIME() } -"," -Returns the current time. -This method always returns the same value within a transaction. -"," -CURRENT_TIME() -" - -"Functions (Time and Date)","CURRENT_TIMESTAMP"," -{ CURRENT_TIMESTAMP [ ( [ int ] ) ] | NOW( [ int ] ) } -"," -Returns the current timestamp. -The precision parameter for nanoseconds precision is optional. -This method always returns the same value within a transaction. -"," -CURRENT_TIMESTAMP() -" - -"Functions (Time and Date)","DATEADD"," -{ DATEADD| TIMESTAMPADD } (datetimeField, addIntLong, dateAndTime) -"," -Adds units to a date-time value. The datetimeField indicates the unit. -Use negative values to subtract units. -addIntLong may be a long value when manipulating milliseconds, -microseconds, or nanoseconds otherwise its range is restricted to int. -This method returns a value with the same type as specified value if unit is compatible with this value. -If specified field is a HOUR, MINUTE, SECOND, MILLISECOND, etc and value is a DATE value DATEADD returns combined TIMESTAMP. -Fields DAY, MONTH, YEAR, WEEK, etc are not allowed for TIME values. -Fields TIMEZONE_HOUR and TIMEZONE_MINUTE are only allowed for TIMESTAMP WITH TIME ZONE values. -"," -DATEADD('MONTH', 1, DATE '2001-01-31') -" - -"Functions (Time and Date)","DATEDIFF"," -{ DATEDIFF | TIMESTAMPDIFF } (datetimeField, aDateAndTime, bDateAndTime) -"," -Returns the the number of crossed unit boundaries between two date/time values. -This method returns a long. -The datetimeField indicates the unit. -Only TIMEZONE_HOUR and TIMEZONE_MINUTE fields use the time zone offset component. -With all other fields if date/time values have time zone offset component it is ignored. -"," -DATEDIFF('YEAR', T1.CREATED, T2.CREATED) -" - -"Functions (Time and Date)","DAYNAME"," -DAYNAME(dateAndTime) -"," -Returns the name of the day (in English). -"," -DAYNAME(CREATED) -" - -"Functions (Time and Date)","DAY_OF_MONTH"," -DAY_OF_MONTH(dateAndTime) -"," -Returns the day of the month (1-31). -"," -DAY_OF_MONTH(CREATED) -" - -"Functions (Time and Date)","DAY_OF_WEEK"," -DAY_OF_WEEK(dateAndTime) -"," -Returns the day of the week (1 means Sunday). -"," -DAY_OF_WEEK(CREATED) -" - -"Functions (Time and Date)","ISO_DAY_OF_WEEK"," -ISO_DAY_OF_WEEK(dateAndTime) -"," -Returns the ISO day of the week (1 means Monday). -"," -ISO_DAY_OF_WEEK(CREATED) -" - -"Functions (Time and Date)","DAY_OF_YEAR"," -DAY_OF_YEAR(dateAndTime) -"," -Returns the day of the year (1-366). -"," -DAY_OF_YEAR(CREATED) -" - -"Functions (Time and Date)","EXTRACT"," -EXTRACT ( datetimeField FROM dateAndTime ) -"," -Returns a value of the specific time unit from a date/time value. -This method returns a numeric value with EPOCH field and -an int for all other fields. -"," -EXTRACT(SECOND FROM CURRENT_TIMESTAMP) -" - -"Functions (Time and Date)","FORMATDATETIME"," -FORMATDATETIME ( dateAndTime, formatString -[ , localeString [ , timeZoneString ] ] ) -"," -Formats a date, time or timestamp as a string. -The most important format characters are: -y year, M month, d day, H hour, m minute, s second. -For details of the format, see ""java.text.SimpleDateFormat"". -timeZoneString may be specified if dateAndTime is a DATE, TIME or TIMESTAMP. -timeZoneString is ignored if dateAndTime is TIMESTAMP WITH TIME ZONE. -This method returns a string. -"," -CALL FORMATDATETIME(TIMESTAMP '2001-02-03 04:05:06', - 'EEE, d MMM yyyy HH:mm:ss z', 'en', 'GMT') -" - -"Functions (Time and Date)","HOUR"," -HOUR(dateAndTime) -"," -Returns the hour (0-23) from a date/time value. -"," -HOUR(CREATED) -" - -"Functions (Time and Date)","MINUTE"," -MINUTE(dateAndTime) -"," -Returns the minute (0-59) from a date/time value. -"," -MINUTE(CREATED) -" - -"Functions (Time and Date)","MONTH"," -MONTH(dateAndTime) -"," -Returns the month (1-12) from a date/time value. -"," -MONTH(CREATED) -" - -"Functions (Time and Date)","MONTHNAME"," -MONTHNAME(dateAndTime) -"," -Returns the name of the month (in English). -"," -MONTHNAME(CREATED) -" - -"Functions (Time and Date)","PARSEDATETIME"," -PARSEDATETIME(string, formatString -[, localeString [, timeZoneString]]) -"," -Parses a string and returns a timestamp. -The most important format characters are: -y year, M month, d day, H hour, m minute, s second. -For details of the format, see ""java.text.SimpleDateFormat"". -"," -CALL PARSEDATETIME('Sat, 3 Feb 2001 03:05:06 GMT', - 'EEE, d MMM yyyy HH:mm:ss z', 'en', 'GMT') -" - -"Functions (Time and Date)","QUARTER"," -QUARTER(dateAndTime) -"," -Returns the quarter (1-4) from a date/time value. -"," -QUARTER(CREATED) -" - -"Functions (Time and Date)","SECOND"," -SECOND(dateAndTime) -"," -Returns the second (0-59) from a date/time value. -"," -SECOND(CREATED) -" - -"Functions (Time and Date)","WEEK"," -WEEK(dateAndTime) -"," -Returns the week (1-53) from a date/time value. -This method uses the current system locale. -"," -WEEK(CREATED) -" - -"Functions (Time and Date)","ISO_WEEK"," -ISO_WEEK(dateAndTime) -"," -Returns the ISO week (1-53) from a date/time value. -This function uses the ISO definition when -first week of year should have at least four days -and week is started with Monday. -"," -ISO_WEEK(CREATED) -" - -"Functions (Time and Date)","YEAR"," -YEAR(dateAndTime) -"," -Returns the year from a date/time value. -"," -YEAR(CREATED) -" - -"Functions (Time and Date)","ISO_YEAR"," -ISO_YEAR(dateAndTime) -"," -Returns the ISO week year from a date/time value. -"," -ISO_YEAR(CREATED) -" - -"Functions (System)","ARRAY_GET"," -ARRAY_GET(arrayExpression, indexExpression) -"," -Returns one element of an array. -This method returns a string. -"," -CALL ARRAY_GET(('Hello', 'World'), 2) -" - -"Functions (System)","ARRAY_LENGTH"," -ARRAY_LENGTH(arrayExpression) -"," -Returns the length of an array. -"," -CALL ARRAY_LENGTH(('Hello', 'World')) -" - -"Functions (System)","ARRAY_CONTAINS"," -ARRAY_CONTAINS(arrayExpression, value) -"," -Returns a boolean true if the array contains the value. -"," -CALL ARRAY_CONTAINS(('Hello', 'World'), 'Hello') -" - -"Functions (System)","AUTOCOMMIT"," -AUTOCOMMIT() -"," -Returns true if auto commit is switched on for this session. -"," -AUTOCOMMIT() -" - -"Functions (System)","CANCEL_SESSION"," -CANCEL_SESSION(sessionInt) -"," -Cancels the currently executing statement of another session. -The method only works if the multithreaded kernel is enabled (see SET MULTI_THREADED). -Returns true if the statement was canceled, false if the session is closed or no statement is currently executing. - -Admin rights are required to execute this command. -"," -CANCEL_SESSION(3) -" - -"Functions (System)","CASEWHEN Function"," -CASEWHEN(boolean, aValue, bValue) -"," -Returns 'a' if the boolean expression is true, otherwise 'b'. -Returns the same data type as the parameter. -"," -CASEWHEN(ID=1, 'A', 'B') -" - -"Functions (System)","CAST"," -CAST(value AS dataType) -"," -Converts a value to another data type. The following conversion rules are used: -When converting a number to a boolean, 0 is false and every other value is true. -When converting a boolean to a number, false is 0 and true is 1. -When converting a number to a number of another type, the value is checked for overflow. -When converting a number to binary, the number of bytes matches the precision. -When converting a string to binary, it is hex encoded (every byte two characters); -a hex string can be converted to a number by first converting it to binary. -If a direct conversion is not possible, the value is first converted to a string. -"," -CAST(NAME AS INT); -CAST(65535 AS BINARY); -CAST(CAST('FFFF' AS BINARY) AS INT); -" - -"Functions (System)","COALESCE"," -{ COALESCE | NVL } (aValue, bValue [,...]) -"," -Returns the first value that is not null. -"," -COALESCE(A, B, C) -" - -"Functions (System)","CONVERT"," -CONVERT(value, dataType) -"," -Converts a value to another data type. -"," -CONVERT(NAME, INT) -" - -"Functions (System)","CURRVAL"," -CURRVAL( [ schemaName, ] sequenceString ) -"," -Returns the current (last) value of the sequence, independent of the session. -If the sequence was just created, the method returns (start - interval). -If the schema name is not set, the current schema is used. -If the schema name is not set, the sequence name is converted to uppercase (for compatibility). -This method returns a long. -"," -CURRVAL('TEST_SEQ') -" - -"Functions (System)","CSVREAD"," -CSVREAD(fileNameString [, columnsString [, csvOptions ] ] ) -"," -Returns the result set of reading the CSV (comma separated values) file. -For each parameter, NULL means the default value should be used. - -If the column names are specified (a list of column names separated with the -fieldSeparator), those are used, otherwise (or if they are set to NULL) the first line of -the file is interpreted as the column names. -In that case, column names that contain no special characters (only letters, '_', -and digits; similar to the rule for Java identifiers) are considered case insensitive. -Other column names are case sensitive, that means you need to use quoted identifiers -(see below). - -The default charset is the default value for this system, and the default field separator -is a comma. Missing unquoted values as well as data that matches nullString is -parsed as NULL. All columns of type VARCHAR. - -The BOM (the byte-order-mark) character 0xfeff at the beginning of the file is ignored. - -This function can be used like a table: ""SELECT * FROM CSVREAD(...)"". - -Instead of a file, an URL may be used, for example -""jar:file:///c:/temp/example.zip!/org/example/nested.csv"". -To read a stream from the classpath, use the prefix ""classpath:"". -To read from HTTP, use the prefix ""http:"" (as in a browser). - -For performance reason, CSVREAD should not be used inside a join. -Instead, import the data first (possibly into a temporary table) and then use the table. - -Admin rights are required to execute this command. -"," -CALL CSVREAD('test.csv'); --- Read a file containing the columns ID, NAME with -CALL CSVREAD('test2.csv', 'ID|NAME', 'charset=UTF-8 fieldSeparator=|'); -SELECT * FROM CSVREAD('data/test.csv', null, 'rowSeparator=;'); --- Read a tab-separated file -SELECT * FROM CSVREAD('data/test.tsv', null, 'rowSeparator=' || CHAR(9)); -SELECT ""Last Name"" FROM CSVREAD('address.csv'); -SELECT ""Last Name"" FROM CSVREAD('classpath:/org/acme/data/address.csv'); -" - -"Functions (System)","CSVWRITE"," -CSVWRITE ( fileNameString, queryString [, csvOptions [, lineSepString] ] ) -"," -Writes a CSV (comma separated values). The file is overwritten if it exists. -If only a file name is specified, it will be written to the current working directory. -For each parameter, NULL means the default value should be used. -The default charset is the default value for this system, and the default field separator is a comma. - -The values are converted to text using the default string representation; -if another conversion is required you need to change the select statement accordingly. -The parameter nullString is used when writing NULL (by default nothing is written -when NULL appears). The default line separator is the default value for this -system (system property ""line.separator""). - -The returned value is the number or rows written. -Admin rights are required to execute this command. -"," -CALL CSVWRITE('data/test.csv', 'SELECT * FROM TEST'); -CALL CSVWRITE('data/test2.csv', 'SELECT * FROM TEST', 'charset=UTF-8 fieldSeparator=|'); --- Write a tab-separated file -CALL CSVWRITE('data/test.tsv', 'SELECT * FROM TEST', 'charset=UTF-8 fieldSeparator=' || CHAR(9)); -" - -"Functions (System)","DATABASE"," -DATABASE() -"," -Returns the name of the database. -"," -CALL DATABASE(); -" - -"Functions (System)","DATABASE_PATH"," -DATABASE_PATH() -"," -Returns the directory of the database files and the database name, if it is file based. -Returns NULL otherwise. -"," -CALL DATABASE_PATH(); -" - -"Functions (System)","DECODE"," -DECODE(value, whenValue, thenValue [,...]) -"," -Returns the first matching value. NULL is considered to match NULL. -If no match was found, then NULL or the last parameter (if the parameter count is even) is returned. -This function is provided for Oracle compatibility (see there for details). -"," -CALL DECODE(RAND()>0.5, 0, 'Red', 1, 'Black'); -" - -"Functions (System)","DISK_SPACE_USED"," -DISK_SPACE_USED(tableNameString) -"," -Returns the approximate amount of space used by the table specified. -Does not currently take into account indexes or LOB's. -This function may be expensive since it has to load every page in the table. -"," -CALL DISK_SPACE_USED('my_table'); -" - -"Functions (System)","SIGNAL"," -SIGNAL(sqlStateString, messageString) -"," -Throw an SQLException with the passed SQLState and reason. -"," -CALL SIGNAL('23505', 'Duplicate user ID: ' || user_id); -" - -"Functions (System)","FILE_READ"," -FILE_READ(fileNameString [,encodingString]) -"," -Returns the contents of a file. If only one parameter is supplied, the data are -returned as a BLOB. If two parameters are used, the data is returned as a CLOB -(text). The second parameter is the character set to use, NULL meaning the -default character set for this system. - -File names and URLs are supported. -To read a stream from the classpath, use the prefix ""classpath:"". - -Admin rights are required to execute this command. -"," -SELECT LENGTH(FILE_READ('~/.h2.server.properties')) LEN; -SELECT FILE_READ('http://localhost:8182/stylesheet.css', NULL) CSS; -" - -"Functions (System)","FILE_WRITE"," -FILE_WRITE(blobValue, fileNameString) -"," -Write the supplied parameter into a file. Return the number of bytes written. - -Write access to folder, and admin rights are required to execute this command. -"," -SELECT FILE_WRITE('Hello world', '/tmp/hello.txt')) LEN; -" - -"Functions (System)","GREATEST"," -GREATEST(aValue, bValue [,...]) -"," -Returns the largest value that is not NULL, or NULL if all values are NULL. -"," -CALL GREATEST(1, 2, 3); -" - -"Functions (System)","IDENTITY"," -IDENTITY() -"," -Returns the last inserted identity value for this session. -This value changes whenever a new sequence number was generated, -even within a trigger or Java function. See also SCOPE_IDENTITY. -This method returns a long. -"," -CALL IDENTITY(); -" - -"Functions (System)","IFNULL"," -IFNULL(aValue, bValue) -"," -Returns the value of 'a' if it is not null, otherwise 'b'. -"," -CALL IFNULL(NULL, ''); -" - -"Functions (System)","LEAST"," -LEAST(aValue, bValue [,...]) -"," -Returns the smallest value that is not NULL, or NULL if all values are NULL. -"," -CALL LEAST(1, 2, 3); -" - -"Functions (System)","LOCK_MODE"," -LOCK_MODE() -"," -Returns the current lock mode. See SET LOCK_MODE. -This method returns an int. -"," -CALL LOCK_MODE(); -" - -"Functions (System)","LOCK_TIMEOUT"," -LOCK_TIMEOUT() -"," -Returns the lock timeout of the current session (in milliseconds). -"," -LOCK_TIMEOUT() -" - -"Functions (System)","LINK_SCHEMA"," -LINK_SCHEMA(targetSchemaString, driverString, urlString, -userString, passwordString, sourceSchemaString) -"," -Creates table links for all tables in a schema. -If tables with the same name already exist, they are dropped first. -The target schema is created automatically if it does not yet exist. -The driver name may be empty if the driver is already loaded. -The list of tables linked is returned in the form of a result set. -Admin rights are required to execute this command. -"," -CALL LINK_SCHEMA('TEST2', '', 'jdbc:h2:test2', 'sa', 'sa', 'PUBLIC'); -" - -"Functions (System)","MEMORY_FREE"," -MEMORY_FREE() -"," -Returns the free memory in KB (where 1024 bytes is a KB). -This method returns an int. -The garbage is run before returning the value. -Admin rights are required to execute this command. -"," -MEMORY_FREE() -" - -"Functions (System)","MEMORY_USED"," -MEMORY_USED() -"," -Returns the used memory in KB (where 1024 bytes is a KB). -This method returns an int. -The garbage is run before returning the value. -Admin rights are required to execute this command. -"," -MEMORY_USED() -" - -"Functions (System)","NEXTVAL"," -NEXTVAL ( [ schemaName, ] sequenceString ) -"," -Returns the next value of the sequence. -Used values are never re-used, even when the transaction is rolled back. -If the schema name is not set, the current schema is used, and the sequence name is converted to uppercase (for compatibility). -This method returns a long. -"," -NEXTVAL('TEST_SEQ') -" - -"Functions (System)","NULLIF"," -NULLIF(aValue, bValue) -"," -Returns NULL if 'a' is equals to 'b', otherwise 'a'. -"," -NULLIF(A, B) -" - -"Functions (System)","NVL2"," -NVL2(testValue, aValue, bValue) -"," -If the test value is null, then 'b' is returned. Otherwise, 'a' is returned. -The data type of the returned value is the data type of 'a' if this is a text type. -"," -NVL2(X, 'not null', 'null') -" - -"Functions (System)","READONLY"," -READONLY() -"," -Returns true if the database is read-only. -"," -READONLY() -" - -"Functions (System)","ROWNUM"," -{ ROWNUM() } | { ROW_NUMBER() OVER() } -"," -Returns the number of the current row. -This method returns a long. -It is supported for SELECT statements, as well as for DELETE and UPDATE. -The first row has the row number 1, and is calculated before ordering and grouping the result set, -but after evaluating index conditions (even when the index conditions are specified in an outer query). -To get the row number after ordering and grouping, use a subquery. -"," -SELECT ROWNUM(), * FROM TEST; -SELECT ROWNUM(), * FROM (SELECT * FROM TEST ORDER BY NAME); -SELECT ID FROM (SELECT T.*, ROWNUM AS R FROM TEST T) WHERE R BETWEEN 2 AND 3; -" - -"Functions (System)","SCHEMA"," -SCHEMA() -"," -Returns the name of the default schema for this session. -"," -CALL SCHEMA() -" - -"Functions (System)","SCOPE_IDENTITY"," -SCOPE_IDENTITY() -"," -Returns the last inserted identity value for this session for the current scope -(the current statement). -Changes within triggers and Java functions are ignored. See also IDENTITY(). -This method returns a long. -"," -CALL SCOPE_IDENTITY(); -" - -"Functions (System)","SESSION_ID"," -SESSION_ID() -"," -Returns the unique session id number for the current database connection. -This id stays the same while the connection is open. -This method returns an int. -The database engine may re-use a session id after the connection is closed. -"," -CALL SESSION_ID() -" - -"Functions (System)","SET"," -SET(@variableName, value) -"," -Updates a variable with the given value. -The new value is returned. -When used in a query, the value is updated in the order the rows are read. -When used in a subquery, not all rows might be read depending on the query plan. -This can be used to implement running totals / cumulative sums. -"," -SELECT X, SET(@I, IFNULL(@I, 0)+X) RUNNING_TOTAL FROM SYSTEM_RANGE(1, 10) -" - -"Functions (System)","TABLE"," -{ TABLE | TABLE_DISTINCT } ( { name dataType = expression } [,...] ) -"," -Returns the result set. TABLE_DISTINCT removes duplicate rows. -"," -SELECT * FROM TABLE(ID INT=(1, 2), NAME VARCHAR=('Hello', 'World')) -" - -"Functions (System)","TRANSACTION_ID"," -TRANSACTION_ID() -"," -Returns the current transaction id for this session. -This method returns NULL if there is no uncommitted change, or if the the database is not persisted. -Otherwise a value of the following form is returned: -""logFileId-position-sessionId"". -This method returns a string. -The value is unique across database restarts (values are not re-used). -"," -CALL TRANSACTION_ID() -" - -"Functions (System)","TRUNCATE_VALUE"," -TRUNCATE_VALUE(value, precisionInt, forceBoolean) -"," -Truncate a value to the required precision. -The precision of the returned value may be a bit larger than requested, -because fixed precision values are not truncated (unlike the numeric TRUNCATE method). -Unlike CAST, the truncating a decimal value may lose precision if the force flag is set to true. -The method returns a value with the same data type as the first parameter. -"," -CALL TRUNCATE_VALUE(X, 10, TRUE); -" - -"Functions (System)","USER"," -{ USER | CURRENT_USER } () -"," -Returns the name of the current user of this session. -"," -CURRENT_USER() -" - -"Functions (System)","H2VERSION"," -H2VERSION() -"," -Returns the H2 version as a String. -"," -H2VERSION() -" - -"System Tables","Information Schema"," -INFORMATION_SCHEMA -"," -To get the list of system tables, execute the statement SELECT * FROM -INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'INFORMATION_SCHEMA' -"," - -" -"System Tables","Range Table"," -SYSTEM_RANGE(start, end) -"," -Contains all values from start to end (this is a dynamic table). -"," -SYSTEM_RANGE(0, 100) -" - diff --git a/h2/src/docsrc/help/information_schema.csv b/h2/src/docsrc/help/information_schema.csv new file mode 100644 index 0000000000..8008bb1e46 --- /dev/null +++ b/h2/src/docsrc/help/information_schema.csv @@ -0,0 +1,1022 @@ +# Copyright 2004-2022 H2 Group. Multiple-Licensed under the MPL 2.0, +# and the EPL 1.0 (https://h2database.com/html/license.html). +# Initial Developer: H2 Group + +"TABLE_NAME","COLUMN_NAME","DESCRIPTION" + +# Tables and views + +"CHECK_CONSTRAINTS",," +Contains CHECK clauses of check and domain constraints. +" + +"COLLATIONS",," +Contains available collations. +" + +"COLUMNS",," +Contains information about columns of tables. +" + +"COLUMN_PRIVILEGES",," +Contains information about privileges of columns. +H2 doesn't have per-column privileges, so this view actually contains privileges of their tables. +" + +"CONSTANTS",," +Contains information about constants. +" + +"CONSTRAINT_COLUMN_USAGE",," +Contains information about columns used in constraints. +" + +"DOMAINS",," +Contains information about domains. +" + +"DOMAIN_CONSTRAINTS",," +Contains basic information about domain constraints. +See also INFORMATION_SCHEMA.CHECK_CONSTRAINTS. +" + +"ELEMENT_TYPES",," +Contains information about types of array elements. +" + +"ENUM_VALUES",," +Contains information about enum values. +" + +"FIELDS",," +Contains information about fields of row values. +" + +"INDEXES",," +Contains information about indexes. +" + +"INDEX_COLUMNS",," +Contains information about columns used in indexes. +" + +"INFORMATION_SCHEMA_CATALOG_NAME",," +Contains a single row with the name of catalog (database name). +" + +"IN_DOUBT",," +Contains information about prepared transactions. +" + +"KEY_COLUMN_USAGE",," +Contains information about columns used by primary key, unique, or referential constraint. +" + +"LOCKS",," +Contains information about tables locked by sessions. +" + +"PARAMETERS",," +Contains information about parameters of routines. +" + +"QUERY_STATISTICS",," +Contains statistics of queries when query statistics gathering is enabled. +" + +"REFERENTIAL_CONSTRAINTS",," +Contains additional information about referential constraints. +" + +"RIGHTS",," +Contains information about granted rights and roles. +" + +"ROLES",," +Contains information about roles. +" + +"ROUTINES",," +Contains information about user-defined routines, including aggregate functions. +" + +"SCHEMATA",," +Contains information about schemas. +" + +"SEQUENCES",," +Contains information about sequences. +" + +"SESSIONS",," +Contains information about sessions. +Only users with ADMIN privileges can see all sessions, other users can see only own session. +" + +"SESSION_STATE",," +Contains the state of the current session. +" + +"SETTINGS",," +Contains values of various settings. +" + +"SYNONYMS",," +Contains information about table synonyms. +" + +"TABLES",," +Contains information about tables. +See also INFORMATION_SCHEMA.COLUMNS. +" + +"TABLE_CONSTRAINTS",," +Contains basic information about table constraints (check, primary key, unique, and referential). +" + +"TABLE_PRIVILEGES",," +Contains information about privileges of tables. +See INFORMATION_SCHEMA.CHECK_CONSTRAINTS, INFORMATION_SCHEMA.KEY_COLUMN_USAGE, +and INFORMATION_SCHEMA.REFERENTIAL_CONSTRAINTS for additional information. +" + +"TRIGGERS",," +Contains information about triggers. +" + +"USERS",," +Contains information about users. +Only users with ADMIN privileges can see all users, other users can see only themselves. +" + +"VIEWS",," +Contains additional information about views. +See INFORMATION_SCHEMA.TABLES for basic information. +" + +# Common columns with data type information + +,"DATA_TYPE"," +The SQL data type name. +" + +,"CHARACTER_MAXIMUM_LENGTH"," +The maximum length in characters for character string data types. +For binary string data types contains the same value as CHARACTER_OCTET_LENGTH. +" + +,"CHARACTER_OCTET_LENGTH"," +The maximum length in bytes for binary string data types. +For character string data types contains the same value as CHARACTER_MAXIMUM_LENGTH. +" + +,"NUMERIC_PRECISION"," +The precision for numeric data types. +" + +,"NUMERIC_PRECISION_RADIX"," +The radix of precision (2 or 10) for numeric data types. +" + +,"NUMERIC_SCALE"," +The scale for numeric data types. +" + +,"DATETIME_PRECISION"," +The fractional seconds precision for datetime data types. +" + +,"INTERVAL_TYPE"," +The data type of interval qualifier for interval data types. +" + +,"INTERVAL_PRECISION"," +The leading field precision for interval data types. +" + +,"CHARACTER_SET_CATALOG"," +The catalog (database name) for character string data types. +" + +,"CHARACTER_SET_SCHEMA"," +The name of public schema for character string data types. +" + +,"CHARACTER_SET_NAME"," +The 'Unicode' for character string data types. +" + +,"COLLATION_CATALOG"," +The catalog (database name) for character string data types. +" + +,"COLLATION_SCHEMA"," +The name of public schema for character string data types. +" + +,"COLLATION_NAME"," +The name of collation for character string data types. +" + +,"MAXIMUM_CARDINALITY"," +The maximum cardinality for array data types. +" + +,"DTD_IDENTIFIER"," +The data type identifier to read additional information from INFORMATION_SCHEMA.ELEMENT_TYPES for array data types, +INFORMATION_SCHEMA.ENUM_VALUES for ENUM data type, and INFORMATION_SCHEMA.FIELDS for row value data types. +" + +,"DECLARED_DATA_TYPE"," +The declared SQL data type name for numeric data types. +" + +,"DECLARED_NUMERIC_PRECISION"," +The declared precision, if any, for numeric data types. +" + +,"DECLARED_NUMERIC_SCALE"," +The declared scale, if any, for numeric data types. +" + +,"GEOMETRY_TYPE"," +The geometry type constraint, if any, for geometry data types. +" + +,"GEOMETRY_SRID"," +The geometry SRID (Spatial Reference Identifier) constraint, if any, for geometry data types. +" + +# Other common fields + +,"CONSTRAINT_CATALOG"," +The catalog (database name). +" + +,"CONSTRAINT_SCHEMA"," +The schema of the constraint. +" + +,"CONSTRAINT_NAME"," +The name of the constraint. +" + +,"DOMAIN_CATALOG"," +The catalog (database name). +" + +,"DOMAIN_SCHEMA"," +The schema of domain. +" + +,"DOMAIN_NAME"," +The name of domain. +" + +,"INDEX_CATALOG"," +The catalog (database name). +" + +,"INDEX_SCHEMA"," +The schema of the index. +" + +,"INDEX_NAME"," +The name of the index. +" + +,"OBJECT_CATALOG"," +The catalog (database name). +" + +,"OBJECT_SCHEMA"," +The schema of the object. +" + +,"OBJECT_NAME"," +The name of the object. +" + +,"OBJECT_TYPE"," +The TYPE of the object ('CONSTANT', 'DOMAIN', 'TABLE', or 'ROUTINE'). +" + +,"SPECIFIC_CATALOG"," +The catalog (database name). +" + +,"SPECIFIC_SCHEMA"," +The schema of the overloaded version of routine. +" + +,"SPECIFIC_NAME"," +The name of the overloaded version of routine. +" + +,"TABLE_CATALOG"," +The catalog (database name). +" + +,"TABLE_SCHEMA"," +The schema of the table. +" + +,"TABLE_NAME"," +The name of the table. +" + +,"COLUMN_NAME"," +The name of the column. +" + +,"ORDINAL_POSITION"," +The ordinal position (1-based). +" + +,"GRANTOR"," +NULL. +" + +,"GRANTEE"," +The name of grantee. +" + +,"PRIVILEGE_TYPE"," +'SELECT', 'INSERT', 'UPDATE', or 'DELETE'. +" + +,"IS_GRANTABLE"," +Whether grantee may grant rights to this object to others ('YES' or 'NO'). +" + +,"REMARKS"," +Optional remarks. +" + +,"SESSION_ID"," +The identifier of the session. +" + +# Individual fields + +"CHECK_CONSTRAINTS","CHECK_CLAUSE"," +The SQL of CHECK clause. +" + +"COLLATIONS","PAD_ATTRIBUTE"," +'NO PAD'. +" + +"COLLATIONS","LANGUAGE_TAG"," +The language tag. +" + +"COLUMNS","COLUMN_DEFAULT"," +The SQL of DEFAULT expression, if any. +" + +"COLUMNS","IS_NULLABLE"," +Whether column may contain NULL value ('YES' or 'NO'). +" + +"COLUMNS","DOMAIN_CATALOG"," +The catalog for columns with domain. +" + +"COLUMNS","DOMAIN_SCHEMA"," +The schema of domain for columns with domain. +" + +"COLUMNS","DOMAIN_NAME"," +The name of domain for columns with domain. +" + +"COLUMNS","IS_IDENTITY"," +Whether column is an identity column ('YES' or 'NO'). +" + +"COLUMNS","IDENTITY_GENERATION"," +Identity generation ('ALWAYS' or 'BY DEFAULT') for identity columns. +" + +"COLUMNS","IDENTITY_START"," +The initial start value for identity columns. +" + +"COLUMNS","IDENTITY_INCREMENT"," +The increment value for identity columns. +" + +"COLUMNS","IDENTITY_MAXIMUM"," +The maximum value for identity columns. +" + +"COLUMNS","IDENTITY_MINIMUM"," +The minimum value for identity columns. +" + +"COLUMNS","IDENTITY_CYCLE"," +Whether identity values are cycled ('YES' or 'NO') for identity columns. +" + +"COLUMNS","IS_GENERATED"," +Whether column is an generated column ('ALWAYS' or 'NEVER') +" + +"COLUMNS","GENERATION_EXPRESSION"," +The SQL of GENERATED ALWAYS AS expression for generated columns. +" + +"COLUMNS","IDENTITY_BASE"," +The current base value for identity columns. +" + +"COLUMNS","IDENTITY_CACHE"," +The cache size for identity columns. +" + +"COLUMNS","COLUMN_ON_UPDATE"," +The SQL of ON UPDATE expression, if any. +" + +"COLUMNS","IS_VISIBLE"," +Whether column is visible (included into SELECT *). +" + +"COLUMNS","DEFAULT_ON_NULL"," +Whether value of DEFAULT expression is used when NULL value is inserted. +" + +"COLUMNS","SELECTIVITY"," +The selectivity of a column (0-100), used to choose the best index. +" + +"CONSTANTS","CONSTANT_CATALOG"," +The catalog (database name). +" + +"CONSTANTS","CONSTANT_SCHEMA"," +The schema of the constant. +" + +"CONSTANTS","CONSTANT_NAME"," +The name of the constant. +" + +"CONSTANTS","VALUE_DEFINITION"," +The SQL of value. +" + +"DOMAINS","DOMAIN_DEFAULT"," +The SQL of DEFAULT expression, if any. +" + +"DOMAINS","DOMAIN_ON_UPDATE"," +The SQL of ON UPDATE expression, if any. +" + +"DOMAINS","PARENT_DOMAIN_CATALOG"," +The catalog (database name) for domains with parent domain. +" + +"DOMAINS","PARENT_DOMAIN_SCHEMA"," +The schema of parent domain for domains with parent domain. +" + +"DOMAINS","PARENT_DOMAIN_NAME"," +The name of parent domain for domains with parent domain. +" + +"DOMAIN_CONSTRAINTS","IS_DEFERRABLE"," +'NO'. +" + +"DOMAIN_CONSTRAINTS","INITIALLY_DEFERRED"," +'NO'. +" + +"ELEMENT_TYPES","COLLECTION_TYPE_IDENTIFIER"," +The DTD_IDENTIFIER value of the object. +" + +"ENUM_VALUES","ENUM_IDENTIFIER"," +The DTD_IDENTIFIER value of the object. +" + +"ENUM_VALUES","VALUE_NAME"," +The name of enum value. +" + +"ENUM_VALUES","VALUE_ORDINAL"," +The ordinal of enum value. +" + +"FIELDS","ROW_IDENTIFIER"," +The DTD_IDENTIFIER value of the object. +" + +"FIELDS","FIELD_NAME"," +The name of the field of the row value. +" + +"INDEXES","INDEX_TYPE_NAME"," +The type of the index ('PRIMARY KEY', 'UNIQUE INDEX', 'SPATIAL INDEX', etc.) +" + +"INDEXES","IS_GENERATED"," +Whether index is generated by a constraint and belongs to it. +" + +"INDEXES","INDEX_CLASS"," +The Java class name of index implementation. +" + +"INDEX_COLUMNS","ORDERING_SPECIFICATION"," +'ASC' or 'DESC'. +" + +"INDEX_COLUMNS","NULL_ORDERING"," +'FIRST', 'LAST', or NULL. +" + +"INDEX_COLUMNS","IS_UNIQUE"," +Whether this column is a part of unique column list of a unique index (TRUE or FALSE). +" + +"INFORMATION_SCHEMA_CATALOG_NAME","CATALOG_NAME"," +The catalog (database name). +" + +"IN_DOUBT","TRANSACTION_NAME"," +The name of prepared transaction. +" + +"IN_DOUBT","TRANSACTION_STATE"," +The state of prepared transaction ('IN_DOUBT', 'COMMIT', or 'ROLLBACK'). +" + +"KEY_COLUMN_USAGE","POSITION_IN_UNIQUE_CONSTRAINT"," +The ordinal position in the referenced unique constraint (1-based). +" + +"LOCKS","LOCK_TYPE"," +'READ' or 'WRITE'. +" + +"PARAMETERS","PARAMETER_MODE"," +'IN'. +" + +"PARAMETERS","IS_RESULT"," +'NO'. +" + +"PARAMETERS","AS_LOCATOR"," +'YES' for LOBs, 'NO' for others. +" + +"PARAMETERS","PARAMETER_NAME"," +The name of the parameter. +" + +"PARAMETERS","PARAMETER_DEFAULT"," +NULL. +" + +"QUERY_STATISTICS","SQL_STATEMENT"," +The SQL statement. +" + +"QUERY_STATISTICS","EXECUTION_COUNT"," +The execution count. +" + +"QUERY_STATISTICS","MIN_EXECUTION_TIME"," +The minimum execution time in milliseconds. +" + +"QUERY_STATISTICS","MAX_EXECUTION_TIME"," +The maximum execution time in milliseconds. +" + +"QUERY_STATISTICS","CUMULATIVE_EXECUTION_TIME"," +The total execution time in milliseconds. +" + +"QUERY_STATISTICS","AVERAGE_EXECUTION_TIME"," +The average execution time in milliseconds. +" + +"QUERY_STATISTICS","STD_DEV_EXECUTION_TIME"," +The standard deviation of execution time in milliseconds. +" + +"QUERY_STATISTICS","MIN_ROW_COUNT"," +The minimum number of rows. +" + +"QUERY_STATISTICS","MAX_ROW_COUNT"," +The maximum number of rows. +" + +"QUERY_STATISTICS","CUMULATIVE_ROW_COUNT"," +The total number of rows. +" + +"QUERY_STATISTICS","AVERAGE_ROW_COUNT"," +The average number of rows. +" + +"QUERY_STATISTICS","STD_DEV_ROW_COUNT"," +The standard deviation of number of rows. +" + +"REFERENTIAL_CONSTRAINTS","UNIQUE_CONSTRAINT_CATALOG"," +The catalog (database name). +" + +"REFERENTIAL_CONSTRAINTS","UNIQUE_CONSTRAINT_SCHEMA"," +The schema of referenced unique constraint. +" + +"REFERENTIAL_CONSTRAINTS","UNIQUE_CONSTRAINT_NAME"," +The name of referenced unique constraint. +" + +"REFERENTIAL_CONSTRAINTS","MATCH_OPTION"," +'NONE'. +" + +"REFERENTIAL_CONSTRAINTS","UPDATE_RULE"," +The rule for UPDATE in referenced table ('RESTRICT', 'CASCADE', 'SET DEFAULT', or 'SET NULL'). +" + +"REFERENTIAL_CONSTRAINTS","DELETE_RULE"," +The rule for DELETE in referenced table ('RESTRICT', 'CASCADE', 'SET DEFAULT', or 'SET NULL'). +" + +"RIGHTS","GRANTEETYPE"," +'USER' if grantee is a user, 'ROLE' if grantee is a role. +" + +"RIGHTS","GRANTEDROLE"," +The name of the granted role for role grants. +" + +"RIGHTS","RIGHTS"," +The set of rights ('SELECT', 'DELETE', 'INSERT', 'UPDATE', or 'ALTER ANY SCHEMA' separated with ', ') for table grants. +" + +"ROLES","ROLE_NAME"," +The name of the role. +" + +"ROUTINES","ROUTINE_CATALOG"," +The catalog (database name). +" + +"ROUTINES","ROUTINE_SCHEMA"," +The schema of the routine. +" + +"ROUTINES","ROUTINE_NAME"," +The name of the routine. +" + +"ROUTINES","ROUTINE_TYPE"," +'PROCEDURE', 'FUNCTION', or 'AGGREGATE'. +" + +"ROUTINES","ROUTINE_BODY"," +'EXTERNAL'. +" + +"ROUTINES","ROUTINE_DEFINITION"," +Source code or NULL if not applicable or user doesn't have ADMIN privileges. +" + +"ROUTINES","EXTERNAL_NAME"," +The name of the class or method. +" + +"ROUTINES","EXTERNAL_LANGUAGE"," +'JAVA'. +" + +"ROUTINES","PARAMETER_STYLE"," +'GENERAL'. +" + +"ROUTINES","IS_DETERMINISTIC"," +Whether routine is deterministic ('YES' or 'NO'). +" + +"SCHEMATA","CATALOG_NAME"," +The catalog (database name). +" + +"SCHEMATA","SCHEMA_NAME"," +The schema name. +" + +"SCHEMATA","SCHEMA_OWNER"," +The name of schema owner. +" + +"SCHEMATA","DEFAULT_CHARACTER_SET_CATALOG"," +The catalog (database name). +" + +"SCHEMATA","DEFAULT_CHARACTER_SET_SCHEMA"," +The name of public schema. +" + +"SCHEMATA","DEFAULT_CHARACTER_SET_NAME"," +'Unicode'. +" + +"SCHEMATA","SQL_PATH"," +NULL. +" + +"SCHEMATA","DEFAULT_COLLATION_NAME"," +The name of database collation. +" + +"SEQUENCES","SEQUENCE_CATALOG"," +The catalog (database name). +" + +"SEQUENCES","SEQUENCE_SCHEMA"," +The schema of the sequence. +" + +"SEQUENCES","SEQUENCE_NAME"," +The name of the sequence. +" + +"SEQUENCES","START_VALUE"," +The initial start value. +" + +"SEQUENCES","MINIMUM_VALUE"," +The maximum value. +" + +"SEQUENCES","MAXIMUM_VALUE"," +The minimum value. +" + +"SEQUENCES","INCREMENT"," +The increment value. +" + +"SEQUENCES","CYCLE_OPTION"," +Whether values are cycled ('YES' or 'NO'). +" + +"SEQUENCES","BASE_VALUE"," +The current base value. +" + +"SEQUENCES","CACHE"," +The cache size. +" + +"SESSIONS","USER_NAME"," +The name of the user. +" + +"SESSIONS","SERVER"," +The name of the server used by remote connection. +" + +"SESSIONS","CLIENT_ADDR"," +The client address and port used by remote connection. +" + +"SESSIONS","CLIENT_INFO"," +Additional client information provided by remote connection. +" + +"SESSIONS","SESSION_START"," +When this session was started. +" + +"SESSIONS","ISOLATION_LEVEL"," +The isolation level of the session ('READ UNCOMMITTED', 'READ COMMITTED', 'REPEATABLE READ', 'SNAPSHOT', +or 'SERIALIZABLE'). +" + +"SESSIONS","EXECUTING_STATEMENT"," +The currently executing statement, if any. +" + +"SESSIONS","EXECUTING_STATEMENT_START"," +When the current command was started, if any. +" + +"SESSIONS","CONTAINS_UNCOMMITTED"," +Whether the session contains any uncommitted changes. +" + +"SESSIONS","SESSION_STATE"," +The state of the session ('RUNNING', 'SLEEP', etc.) +" + +"SESSIONS","BLOCKER_ID"," +The identifier or blocking session, if any. +" + +"SESSIONS","SLEEP_SINCE"," +When the last command was finished if session is sleeping. +" + +"SESSION_STATE","STATE_KEY"," +The key. +" + +"SESSION_STATE","STATE_COMMAND"," +The SQL command that can be used to restore the state. +" + +"SETTINGS","SETTING_NAME"," +The name of the setting. +" + +"SETTINGS","SETTING_VALUE"," +The value of the setting. +" + +"SYNONYMS","SYNONYM_CATALOG"," +The catalog (database name). +" + +"SYNONYMS","SYNONYM_SCHEMA"," +The schema of the synonym. +" + +"SYNONYMS","SYNONYM_NAME"," +The name of the synonym. +" + +"SYNONYMS","SYNONYM_FOR"," +The name of the referenced table. +" + +"SYNONYMS","SYNONYM_FOR_SCHEMA"," +The name of the referenced schema. +" + +"SYNONYMS","TYPE_NAME"," +'SYNONYM'. +" + +"SYNONYMS","STATUS"," +'VALID'. +" + +"TABLES","TABLE_TYPE"," +'BASE TABLE', 'VIEW', 'GLOBAL TEMPORARY', or 'LOCAL TEMPORARY'. +" + +"TABLES","IS_INSERTABLE_INTO"," +Whether the table is insertable ('YES' or 'NO'). +" + +"TABLES","COMMIT_ACTION"," +'DELETE', 'DROP', or 'PRESERVE' for temporary tables. +" + +"TABLES","STORAGE_TYPE"," +'CACHED' for regular persisted tables, 'MEMORY' for in-memory tables or persisted tables with in-memory indexes, +'GLOBAL TEMPORARY' or 'LOCAL TEMPORARY' for temporary tables, 'EXTERNAL' for tables with external table engines, +or 'TABLE LINK' for linked tables. +" + +"TABLES","LAST_MODIFICATION"," +The sequence number of the last modification, if applicable. +" + +"TABLES","TABLE_CLASS"," +The Java class name of implementation. +" + +"TABLES","ROW_COUNT_ESTIMATE"," +The approximate number of rows if known or some default value if unknown. +For regular tables contains the total number of rows including the uncommitted rows. +" + +"TABLE_CONSTRAINTS","CONSTRAINT_TYPE"," +'CHECK', 'PRIMARY KEY', 'UNIQUE', or 'REFERENTIAL'. +" + +"TABLE_CONSTRAINTS","IS_DEFERRABLE"," +'NO'. +" + +"TABLE_CONSTRAINTS","INITIALLY_DEFERRED"," +'NO'. +" + +"TABLE_CONSTRAINTS","ENFORCED"," +'YES' for non-referential constants. +'YES' for referential constants when checks for referential integrity are enabled for the both referenced and +referencing tables and 'NO' when they are disabled. +" + +"TABLE_PRIVILEGES","WITH_HIERARCHY"," +'NO'. +" + +"TRIGGERS","TRIGGER_CATALOG"," +The catalog (database name). +" + +"TRIGGERS","TRIGGER_SCHEMA"," +The schema of the trigger. +" + +"TRIGGERS","TRIGGER_NAME"," +The name of the trigger. +" + +"TRIGGERS","EVENT_MANIPULATION"," +'INSERT', 'UPDATE', 'DELETE', or 'SELECT'. +" + +"TRIGGERS","EVENT_OBJECT_CATALOG"," +The catalog (database name). +" + +"TRIGGERS","EVENT_OBJECT_SCHEMA"," +The schema of the table. +" + +"TRIGGERS","EVENT_OBJECT_TABLE"," +The name of the table. +" + +"TRIGGERS","ACTION_ORIENTATION"," +'ROW' or 'STATEMENT'. +" + +"TRIGGERS","ACTION_TIMING"," +'BEFORE', 'AFTER', or 'INSTEAD OF'. +" + +"TRIGGERS","IS_ROLLBACK"," +Whether this trigger is executed on rollback. +" + +"TRIGGERS","JAVA_CLASS"," +The Java class name. +" + +"TRIGGERS","QUEUE_SIZE"," +The size of the queue (is not actually used). +" + +"TRIGGERS","NO_WAIT"," +Whether trigger is defined with NO WAIT clause (is not actually used). +" + +"USERS","USER_NAME"," +The name of the user. +" + +"USERS","IS_ADMIN"," +Whether user has ADMIN privileges. +" + +"VIEWS","VIEW_DEFINITION"," +The query SQL, if applicable. +" + +"VIEWS","CHECK_OPTION"," +'NONE'. +" + +"VIEWS","IS_UPDATABLE"," +'NO'. +" + +"VIEWS","INSERTABLE_INTO"," +'NO'. +" + +"VIEWS","IS_TRIGGER_UPDATABLE"," +Whether the view has INSTEAD OF trigger for UPDATE ('YES' or 'NO'). +" + +"VIEWS","IS_TRIGGER_DELETABLE"," +Whether the view has INSTEAD OF trigger for DELETE ('YES' or 'NO'). +" + +"VIEWS","IS_TRIGGER_INSERTABLE_INTO"," +Whether the view has INSTEAD OF trigger for INSERT ('YES' or 'NO'). +" + +"VIEWS","STATUS"," +'VALID' or 'INVALID'. +" diff --git a/h2/src/docsrc/html/advanced.html b/h2/src/docsrc/html/advanced.html index 2c6ab0a887..68e865b1ff 100644 --- a/h2/src/docsrc/html/advanced.html +++ b/h2/src/docsrc/html/advanced.html @@ -1,7 +1,7 @@ @@ -41,14 +41,14 @@

Advanced

Two Phase Commit
Compatibility
+ + Keywords / Reserved Words
Standards Compliance
Run as Windows Service
ODBC Driver
- - Using H2 in Microsoft .NET
ACID
@@ -81,12 +81,8 @@

Advanced

Pluggable File System

Split File System
- - Database Upgrade
Java Objects Serialization
- - Custom Data Types Handler API
Limits and Limitations
@@ -96,7 +92,10 @@

Result Sets

Statements that Return a Result Set

-The following statements return a result set: SELECT, EXPLAIN, CALL, SCRIPT, SHOW, HELP. +The following statements return a result set: SELECT, TABLE, VALUES, +EXPLAIN, CALL, SCRIPT, SHOW, HELP. +EXECUTE may return either a result set or an update count. +Result of a WITH statement depends on inner command. All other statements return an update count.

@@ -106,8 +105,8 @@

Limiting the Number of Rows

Server side cursors are not supported currently. If only the first few rows are interesting for the application, then the result set size should be limited to improve the performance. -This can be done using LIMIT in a query -(example: SELECT * FROM TEST LIMIT 100), +This can be done using FETCH in a query +(example: SELECT * FROM TEST FETCH FIRST 100 ROWS ONLY), or by using Statement.setMaxRows(max).

@@ -139,7 +138,7 @@

When to use CLOB/BLOB

By default, this database stores large LOB (CLOB and BLOB) objects separate from the main table data. Small LOB objects are stored in-place, the threshold can be set using -MAX_LENGTH_INPLACE_LOB, +MAX_LENGTH_INPLACE_LOB, but there is still an overhead to use CLOB/BLOB. Because of this, BLOB and CLOB should never be used for columns with a maximum size below about 200 bytes. The best threshold depends on the use case; reading in-place objects is faster @@ -147,18 +146,6 @@

When to use CLOB/BLOB

that don't involve this column.

-

Large Object Compression

-

-The following feature is only available for the PageStore storage engine. -For the MVStore engine (the default for H2 version 1.4.x), -append ;COMPRESS=TRUE to the database URL instead. -CLOB and BLOB values can be compressed by using -SET COMPRESS_LOB. -The LZF algorithm is faster but needs more disk space. By default compression is disabled, which usually speeds up write -operations. If you store many large compressible values such as XML, HTML, text, and uncompressed binary files, -then compressing can save a lot of disk space (sometimes more than 50%), and read operations may even be faster. -

-

Linked Tables

This database supports linked tables, which means tables that don't exist in the current database but @@ -186,7 +173,7 @@

Linked Tables

is shared. To disable this, set the system property h2.shareLinkedConnections=false.

-The statement CREATE LINKED TABLE +The statement CREATE LINKED TABLE supports an optional schema name parameter.

@@ -221,72 +208,72 @@

Transaction Isolation

Please note that most data definition language (DDL) statements, such as "create table", commit the current transaction. -See the Grammar for details. +See the Commands for details.

Transaction isolation is provided for all data manipulation language (DML) statements.

-Please note MVCC is enabled in version 1.4.x by default, when using the MVStore. -In this case, table level locking is not used. -Instead, rows are locked for update, and read committed is used in all cases -(changing the isolation level has no effect). -

-

-This database supports the following transaction isolation levels: +H2 supports read uncommitted, read committed, repeatable read, snapshot, +and serializable (partially, see below) isolation levels:

    -
  • Read Committed
    +
  • Read uncommitted
    + Dirty reads, non-repeatable reads, and phantom reads are possible. + To enable, execute the SQL statement + SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL READ UNCOMMITTED +
  • +
  • Read committed
    This is the default level. - Read locks are released immediately after executing the statement, but write locks are kept until the transaction commits. - Higher concurrency is possible when using this level.
    - To enable, execute the SQL statement SET LOCK_MODE 3
    - or append ;LOCK_MODE=3 to the database URL: jdbc:h2:~/test;LOCK_MODE=3 -
  • -Serializable
    - Both read locks and write locks are kept until the transaction commits. - To enable, execute the SQL statement SET LOCK_MODE 1
    - or append ;LOCK_MODE=1 to the database URL: jdbc:h2:~/test;LOCK_MODE=1 -
  • Read Uncommitted
    - This level means that transaction isolation is disabled.
    - To enable, execute the SQL statement SET LOCK_MODE 0
    - or append ;LOCK_MODE=0 to the database URL: jdbc:h2:~/test;LOCK_MODE=0 + Dirty reads aren't possible; non-repeatable reads and phantom reads are possible. + To enable, execute the SQL statement + SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL READ COMMITTED +
  • +
  • Repeatable read
    + Dirty reads and non-repeatable reads aren't possible, phantom reads are possible. + To enable, execute the SQL statement + SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL REPEATABLE READ +
  • +
  • Snapshot
    + Dirty reads, non-repeatable reads, and phantom reads aren't possible. + This isolation level is very expensive in databases with many tables. + To enable, execute the SQL statement + SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL SNAPSHOT +
  • +
  • Serializable
    + Dirty reads, non-repeatable reads, and phantom reads aren't possible. + Note that this isolation level in H2 currently doesn't ensure equivalence of concurrent and serializable execution + of transactions that perform write operations. + This isolation level is very expensive in databases with many tables. + To enable, execute the SQL statement + SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL SERIALIZABLE
-

-When using the isolation level 'serializable', dirty reads, non-repeatable reads, and phantom reads are prohibited. -

    -
  • Dirty Reads
    +
  • Dirty reads
    Means a connection can read uncommitted changes made by another connection.
    - Possible with: read uncommitted -
  • Non-Repeatable Reads
    + Possible with: read uncommitted. +
  • Non-repeatable reads
    A connection reads a row, another connection changes a row and commits, and the first connection re-reads the same row and gets the new result.
    - Possible with: read uncommitted, read committed -
  • Phantom Reads
    + Possible with: read uncommitted, read committed. +
  • Phantom reads
    A connection reads a set of rows using a condition, another connection inserts a row that falls in this condition and commits, then the first connection re-reads using the same condition and gets the new row.
    - Possible with: read uncommitted, read committed + Possible with: read uncommitted, read committed, repeatable read.
-

Table Level Locking

+

Multi-Version Concurrency Control (MVCC)

-The database allows multiple concurrent connections to the same database. -To make sure all connections only see consistent data, table level locking is used by default. -This mechanism does not allow high concurrency, but is very fast. -Shared locks and exclusive locks are supported. -Before reading from a table, the database tries to add a shared lock to the table -(this is only possible if there is no exclusive lock on the object by another connection). -If the shared lock is added successfully, the table can be read. It is allowed that -other connections also have a shared lock on the same object. If a connection wants -to write to a table (update or delete a row), an exclusive lock is required. To get the -exclusive lock, other connection must not have any locks on the object. After the -connection commits, all locks are released. -This database keeps all locks in memory. -When a lock is released, and multiple connections are waiting for it, one of them is picked at random. +Insert and update operations only issue a shared lock on the table. +An exclusive lock is still used when adding or removing columns or when dropping the table. +Connections only 'see' committed data, and own changes. That means, if connection A updates +a row but doesn't commit this change yet, connection B will see the old value. +Only when the change is committed, the new value is visible by other connections +(read committed). If multiple connections concurrently try to lock or update the same row, the +database waits until it can apply the change, but at most until the lock timeout expires.

Lock Timeout

@@ -299,45 +286,6 @@

Lock Timeout

for each connection.

-

Multi-Version Concurrency Control (MVCC)

-

-The MVCC feature allows higher concurrency than using (table level or row level) locks. -When using MVCC in this database, delete, insert and update operations will only issue a -shared lock on the table. An exclusive lock is still used when adding or removing columns, -when dropping the table, and when using SELECT ... FOR UPDATE. -Connections only 'see' committed data, and own changes. That means, if connection A updates -a row but doesn't commit this change yet, connection B will see the old value. -Only when the change is committed, the new value is visible by other connections -(read committed). If multiple connections concurrently try to update the same row, the -database waits until it can apply the change, but at most until the lock timeout expires. -

-

-To use the MVCC feature, append ;MVCC=TRUE to the database URL: -

-
-jdbc:h2:~/test;MVCC=TRUE
-
-

-The setting must be specified in the first connection (the one that opens the database). -It is not possible to enable or disable this setting while the database is already open. -

-

-If MVCC is enabled, changing the lock mode (LOCK_MODE) has no effect. -

-

-The MVCC mode is enabled by default in version 1.4.x, -with the default MVStore storage engine. -MVCC is disabled by default when using the PageStore storage engine -(which is the default in version 1.3.x). -The following applies when using the PageStore storage engine: -The MVCC feature is not fully tested yet. -The limitations of the MVCC mode are: -with the PageStore storage engine, it can not be used at the same time as -MULTI_THREADED=TRUE; -the complete undo log (the list of uncommitted changes) must fit in memory when using multi-version concurrency. -The setting MAX_MEMORY_UNDO has no effect. -

-

Clustering / High Availability

This database supports a simple clustering / high availability mechanism. The architecture is: @@ -413,7 +361,7 @@

Detect Which Cluster Instances are Running

To find out which cluster nodes are currently running, execute the following SQL statement:

-SELECT VALUE FROM INFORMATION_SCHEMA.SETTINGS WHERE NAME='CLUSTER'
+SELECT SETTING_VALUE FROM INFORMATION_SCHEMA.SETTINGS WHERE SETTING_NAME = 'CLUSTER'
 

If the result is '' (two single quotes), then the cluster mode is disabled. Otherwise, the list of @@ -445,7 +393,7 @@

Clustering Algorithm and Limitations

Those functions should not be used directly in modifying statements (for example INSERT, UPDATE, MERGE). However, they can be used in read-only statements and the result can then be used for modifying statements. -Using auto-increment and identity columns is currently not supported. +Identity columns aren't supported. Instead, sequence values need to be manually requested and then used to insert data (using two statements).

@@ -496,21 +444,258 @@

Transaction Commit when Autocommit is On

Other database engines may commit the transaction in this case when the result set is closed.

-

Keywords / Reserved Words

+

Keywords / Reserved Words

There is a list of keywords that can't be used as identifiers (table names, column names and so on), -unless they are quoted (surrounded with double quotes). The list is currently: -

- -ALL, CHECK, CONSTRAINT, CROSS, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, DISTINCT, EXCEPT, -EXISTS, FALSE, FETCH, FOR, FOREIGN, FROM, FULL, GROUP, HAVING, INNER, INTERSECT, IS, JOIN, -LIKE, LIMIT, MINUS, NATURAL, NOT, NULL, OFFSET, ON, ORDER, PRIMARY, ROWNUM, SELECT, SYSDATE, -SYSTIME, SYSTIMESTAMP, TODAY, TRUE, UNION, UNIQUE, WHERE, WITH - -

-Certain words of this list are keywords because they are functions that can be used without '()' for compatibility, -for example CURRENT_TIMESTAMP. +unless they are quoted (surrounded with double quotes). +The following tokens are keywords in H2: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
KeywordH2SQL Standard
2016201120082003199992
ALL+++++++
AND+++++++
ANY+++++++
ARRAY++++++
AS+++++++
ASYMMETRIC+++++NR
AUTHORIZATION+++++++
BETWEEN+++++NR+
BOTHCS++++++
CASE+++++++
CAST+++++++
CHECK+++++++
CONSTRAINT+++++++
CROSS+++++++
CURRENT_CATALOG++++
CURRENT_DATE+++++++
CURRENT_PATH++++++
CURRENT_ROLE++++++
CURRENT_SCHEMA++++
CURRENT_TIME+++++++
CURRENT_TIMESTAMP+++++++
CURRENT_USER+++++++
DAY+++++++
DEFAULT+++++++
DISTINCT+++++++
ELSE+++++++
END+++++++
EXCEPT+++++++
EXISTS+++++NR+
FALSE+++++++
FETCH+++++++
FILTERCS++++
FOR+++++++
FOREIGN+++++++
FROM+++++++
FULL+++++++
GROUP+++++++
GROUPSCS++
HAVING+++++++
HOUR+++++++
IF+
ILIKECS
IN+++++++
INNER+++++++
INTERSECT+++++++
INTERVAL+++++++
IS+++++++
JOIN+++++++
KEY+NRNRNRNR++
LEADINGCS++++++
LEFT+++++++
LIKE+++++++
LIMITMS+
LOCALTIME++++++
LOCALTIMESTAMP++++++
MINUSMS
MINUTE+++++++
MONTH+++++++
NATURAL+++++++
NOT+++++++
NULL+++++++
OFFSET++++
ON+++++++
OR+++++++
ORDER+++++++
OVERCS++++
PARTITIONCS++++
PRIMARY+++++++
QUALIFY+
RANGECS++++
REGEXPCS
RIGHT+++++++
ROW++++++
ROWNUM+
ROWSCS++++++
SECOND+++++++
SELECT+++++++
SESSION_USER++++++
SET+++++++
SOME+++++++
SYMMETRIC+++++NR
SYSTEM_USER+++++++
TABLE+++++++
TO+++++++
TOPMS
CS
TRAILINGCS++++++
TRUE+++++++
UESCAPE+++++
UNION+++++++
UNIQUE+++++++
UNKNOWN+++++++
USER+++++++
USING+++++++
VALUE+++++++
VALUES+++++++
WHEN+++++++
WHERE+++++++
WINDOW+++++
WITH+++++++
YEAR+++++++
_ROWID_+
+

+Mode-sensitive keywords (MS) are keywords only in some compatibility modes.

+
  • LIMIT is a keywords only in Regular, Legacy, DB2, HSQLDB, MariaDB, MySQL, and PostgreSQL compatibility modes. +It is an identifier in Strict, Derby, MSSQLServer, and Oracle compatibility modes. +
  • MINUS is a keyword only in Regular, Legacy, DB2, HSQLDB, and Oracle compatibility modes. +It is an identifier in Strict, Derby, MSSQLServer, MariaDB, MySQL, and PostgreSQL compatibility modes. +
  • TOP is a context-sensitive keyword (can be either keyword or identifier) +only in Regular, Legacy, HSQLDB, and MSSQLServer compatibility modes. +It is an identifier unconditionally in Strict, Derby, DB2, MariaDB, MySQL, Oracle, and PostgreSQL compatibility modes. +
+

+Context-sensitive keywords (CS) can be used as identifiers in some places, +but cannot be used as identifiers in others. +Normal keywords (+) are always treated as keywords. +

+

+Most keywords in H2 are also reserved (+) or non-reserved (NR) words in the SQL Standard. +Newer versions of H2 may have more keywords than older ones. +Reserved words from the SQL Standard are potential candidates for keywords in future versions. +

+ +

There is a compatibility setting +SET NON_KEYWORDS +that can be used as a temporary workaround for applications that use keywords as unquoted identifiers.

Standards Compliance

@@ -718,55 +903,6 @@

Using Microsoft Access

Tools - Options - Edit/Find - ODBC fields.

-

Using H2 in Microsoft .NET

-

-The database can be used from Microsoft .NET even without using Java, by using IKVM.NET. -You can access a H2 database on .NET using the JDBC API, or using the ADO.NET interface. -

- -

Using the ADO.NET API on .NET

-

-An implementation of the ADO.NET interface is available in the open source project -H2Sharp. -

- -

Using the JDBC API on .NET

-
  • Install the .NET Framework from Microsoft. - Mono has not yet been tested. -
  • Install IKVM.NET. -
  • Copy the h2*.jar file to ikvm/bin -
  • Run the H2 Console using: - ikvm -jar h2*.jar -
  • Convert the H2 Console to an .exe file using: - ikvmc -target:winexe h2*.jar. - You may ignore the warnings. -
  • Create a .dll file using (change the version accordingly): - ikvmc.exe -target:library -version:1.0.69.0 h2*.jar -
-

-If you want your C# application use H2, you need to add the h2.dll and the -IKVM.OpenJDK.ClassLibrary.dll to your C# solution. Here some sample code: -

-
-using System;
-using java.sql;
-
-class Test
-{
-    static public void Main()
-    {
-        org.h2.Driver.load();
-        Connection conn = DriverManager.getConnection("jdbc:h2:~/test", "sa", "sa");
-        Statement stat = conn.createStatement();
-        ResultSet rs = stat.executeQuery("SELECT 'Hello World'");
-        while (rs.next())
-        {
-            Console.WriteLine(rs.getString(1));
-        }
-    }
-}
-
-

ACID

In the database world, ACID stands for: @@ -794,7 +930,8 @@

Isolation

For H2, as with most other database systems, the default isolation level is 'read committed'. This provides better performance, but also means that transactions are not completely isolated. -H2 supports the transaction isolation levels 'serializable', 'read committed', and 'read uncommitted'. +H2 supports the transaction isolation levels 'read uncommitted', 'read committed', 'repeatable read', +and 'serializable'.

Durability

@@ -904,7 +1041,8 @@

Using the Recover Tool

For each database in the current directory, a text file will be created. This file contains raw insert statements (for the data) and data definition (DDL) statements to recreate the schema of the database. This file can be executed using the RunScript tool or a -RUNSCRIPT FROM SQL statement. The script includes at least one +RUNSCRIPT SQL statement. +The script includes at least one CREATE USER statement. If you run the script against a database that was created with the same user, or if there are conflicting users, running the script will fail. Consider running the script against a database that was created with a user name that is not in the script. @@ -1223,7 +1361,7 @@

Protection against Remote Access

If you enable remote access using -tcpAllowOthers or -pgAllowOthers, -please also consider using the options -baseDir, -ifExists, +please also consider using the options -baseDir, so that remote users can not create new databases or access existing databases with weak passwords. When using the option -baseDir, only databases within that directory may be accessed. @@ -1232,9 +1370,10 @@

Protection against Remote Access

If you enable remote access using -webAllowOthers, please ensure the web server can only be accessed from trusted networks. -The options -baseDir, -ifExists don't protect -access to the tools section, prevent remote shutdown of the web server, -changes to the preferences, the saved connection settings, +If this option is specified, -webExternalNames should be also specified with +comma-separated list of external names or addresses of this server. +The options -baseDir don't protect +access to the saved connection settings, or access to other databases accessible from the system.

@@ -1432,52 +1571,45 @@

Universally Unique Identifiers (UUID)

Spatial Features

-H2 supports the geometry data type and spatial indexes if -the JTS Topology Suite -is in the classpath. -To run the H2 Console tool with the JTS tool, you need to download the -JTS-CORE 1.15.0 jar file -and place it in the h2 bin directory. Then edit the h2.sh file as follows: -

-
-#!/bin/sh
-dir=$(dirname "$0")
-java -cp "$dir/h2.jar:jts-core-1.15.0.jar:$H2DRIVERS:$CLASSPATH" org.h2.tools.Console "$@"
-
-

+H2 supports the geometry data type and spatial indexes. Here is an example SQL script to create a table with a spatial column and index:

-CREATE TABLE GEO_TABLE(GID SERIAL, THE_GEOM GEOMETRY);
+CREATE TABLE GEO_TABLE(
+    GID BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    THE_GEOM GEOMETRY);
 INSERT INTO GEO_TABLE(THE_GEOM) VALUES
     ('POINT(500 505)'),
     ('LINESTRING(550 551, 525 512, 565 566)'),
     ('POLYGON ((550 521, 580 540, 570 564, 512 566, 550 521))');
-CREATE SPATIAL INDEX GEO_TABLE_SPATIAL_INDEX ON GEO_TABLE(THE_GEOM);
+CREATE SPATIAL INDEX GEO_TABLE_SPATIAL_INDEX
+    ON GEO_TABLE(THE_GEOM);
 

To query the table using geometry envelope intersection, -use the operation &&, as in PostGIS: +use the operation &&, as in PostGIS:

 SELECT * FROM GEO_TABLE
-WHERE THE_GEOM && 'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))';
+    WHERE THE_GEOM &&
+    'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))';
 

You can verify that the spatial index is used using the "explain plan" feature:

 EXPLAIN SELECT * FROM GEO_TABLE
-WHERE THE_GEOM && 'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))';
+    WHERE THE_GEOM &&
+    'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))';
 -- Result
 SELECT
-    GEO_TABLE.GID,
-    GEO_TABLE.THE_GEOM
-FROM PUBLIC.GEO_TABLE
-    /* PUBLIC.GEO_TABLE_SPATIAL_INDEX:
-    THE_GEOM && 'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))' */
-WHERE INTERSECTS(THE_GEOM,
-    'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))')
+    "PUBLIC"."GEO_TABLE"."GID",
+    "PUBLIC"."GEO_TABLE"."THE_GEOM"
+FROM "PUBLIC"."GEO_TABLE"
+    /* PUBLIC.GEO_TABLE_SPATIAL_INDEX: THE_GEOM &&
+    GEOMETRY 'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))' */
+WHERE "THE_GEOM" &&
+    GEOMETRY 'POLYGON ((490 490, 536 490, 536 515, 490 515, 490 490))'
 

For persistent databases, the spatial index is stored on disk; @@ -1514,7 +1646,7 @@

Recursive Queries

WITH LINK(ID, NAME, LEVEL) AS ( SELECT ID, NAME, 0 FROM FOLDER WHERE PARENT IS NULL UNION ALL - SELECT FOLDER.ID, IFNULL(LINK.NAME || '/', '') || FOLDER.NAME, LEVEL + 1 + SELECT FOLDER.ID, COALESCE(LINK.NAME || '/', '') || FOLDER.NAME, LEVEL + 1 FROM LINK INNER JOIN FOLDER ON LINK.ID = FOLDER.PARENT ) SELECT NAME FROM LINK WHERE NAME IS NOT NULL ORDER BY ID; @@ -1563,7 +1695,7 @@

Settings Read from System Properties

For a complete list of settings, see -SysProperties. +SysProperties.

Setting the Server Bind Address

@@ -1579,15 +1711,16 @@

Pluggable File System

This database supports a pluggable file system API. The file system implementation is selected using a file name prefix. -Internally, the interfaces are very similar to the Java 7 NIO2 API, but do not (yet) use or require Java 7. +Internally, the interfaces are very similar to the Java 7 NIO2 API. The following file systems are included:

-
  • zip: read-only zip-file based file system. Format: zip:/zipFileName!/fileName. +
    • file: the default file system that uses FileChannel. +
    • zip: read-only zip-file based file system. Format: zip:~/zipFileName!/fileName.
    • split: file system that splits files in 1 GB files (stackable with other file systems). -
    • nio: file system that uses FileChannel instead of RandomAccessFile (faster in some operating systems).
    • nioMapped: file system that uses memory mapped files (faster in some operating systems). Please note that there currently is a file size limitation of 2 GB when using this file system. - To work around this limitation, combine it with the split file system: split:nioMapped:test. + To work around this limitation, combine it with the split file system: split:nioMapped:~/test. +
    • async: experimental file system that uses AsynchronousFileChannel instead of FileChannel (faster in some operating systems).
    • memFS: in-memory file system (slower than mem; experimental; mainly used for testing the database engine itself).
    • memLZF: compressing in-memory file system (slower than memFS but uses less memory; experimental; mainly used for testing the database engine itself).
    • nioMemFS: stores data outside of the VM's heap - useful for large memory DBs without incurring GC costs. @@ -1601,8 +1734,8 @@

      Pluggable File System

      The default value is 1%.

    -As an example, to use the the nio file system, use the following database URL: -jdbc:h2:nio:~/test. +As an example, to use the async: file system +use the following database URL: jdbc:h2:async:~/test.

    To register a new file system, extend the classes org.h2.store.fs.FilePath, FileBase, @@ -1630,43 +1763,10 @@

    Split File System

    However this can be changed if required, by specifying the block size in the file name. The file name format is: split:<x>:<fileName> where the file size per block is 2^x. For 1 MiB block sizes, use x = 20 (because 2^20 is 1 MiB). -The following file name means the logical file is split into 1 MiB blocks: split:20:test.h2.db. +The following file name means the logical file is split into 1 MiB blocks: split:20:~/test.h2.db. An example database URL for this case is jdbc:h2:split:20:~/test.

    -

    Database Upgrade

    -

    -In version 1.2, H2 introduced a new file store implementation which is incompatible to the one used in versions < 1.2. -To automatically convert databases to the new file store, it is necessary to include an additional jar file. -The file can be found at http://h2database.com/h2mig_pagestore_addon.jar . -If this file is in the classpath, every connect to an older database will result in a conversion process. -

    -

    -The conversion itself is done internally via 'script to' and 'runscript from'. After the conversion process, the files will be -renamed from -

      -
    • dbName.data.db to dbName.data.db.backup -
    • dbName.index.db to dbName.index.db.backup -
    -by default. Also, the temporary script will be written to the database directory instead of a temporary directory. -Both defaults can be customized via -
      -
    • org.h2.upgrade.DbUpgrade.setDeleteOldDb(boolean) -
    • org.h2.upgrade.DbUpgrade.setScriptInTmpDir(boolean) -
    -prior opening a database connection. -

    -

    -Since version 1.2.140 it is possible to let the old h2 classes (v 1.2.128) connect to the database. -The automatic upgrade .jar file must be present, and the URL must start with jdbc:h2v1_1: -(the JDBC driver class is org.h2.upgrade.v1_1.Driver). -If the database should automatically connect using the old version if a database with the old format exists -(without upgrade), and use the new version otherwise, then append ;NO_UPGRADE=TRUE -to the database URL. -Please note the old driver did not process the system property "h2.baseDir" correctly, -so that using this setting is not supported when upgrading. -

    -

    Java Objects Serialization

    Java objects serialization is enabled by default for columns of type OTHER, using standard Java serialization/deserialization semantics. @@ -1676,7 +1776,8 @@

    Java Objects Serialization

    Serialization and deserialization of java objects is customizable both at system level and at database level providing a -JavaObjectSerializer implementation: +JavaObjectSerializer implementation: +

    • At system level set the system property h2.javaObjectSerializer with the @@ -1692,31 +1793,6 @@

      Java Objects Serialization

    -

    - -

    Custom Data Types Handler API

    -

    -It is possible to extend the type system of the database by providing your own implementation -of minimal required API basically consisting of type identification and conversion routines. -

    -

    -In order to enable this feature, set the system property h2.customDataTypesHandler (default: null) to the fully qualified name of the class providing -CustomDataTypesHandler interface implementation.
    -The instance of that class will be created by H2 and used to: -

      -
    • resolve the names and identifiers of extrinsic data types. -
    • -
    • convert values of extrinsic data types to and from values of built-in types. -
    • -
    • provide order of the data types. -
    • -
    -

    -

    This is a system-level setting, i.e. affects all the databases.

    - -

    Note: Please keep in mind that this feature may not possibly provide the same ABI stability level as other features as it exposes many of the H2 internals. You may be required to update your code occasionally due to internal changes in H2 if you are going to use this feature. -

    -

    Limits and Limitations

    @@ -1733,28 +1809,29 @@

    Limits and Limitations

    An example database URL is: jdbc:h2:split:~/test.
  • The maximum number of rows per table is 2^64.
  • The maximum number of open transactions is 65535. +
  • The maximum number of columns in a table or expressions in a SELECT statement is 16384. +The actual possible number can be smaller if their definitions are too long. +
  • The maximum length of an identifier (table name, column name, and so on) is 256 characters. +
  • The maximum length of CHARACTER, CHARACTER VARYING and VARCHAR_IGNORECASE values and columns +is 1048576 characters. +
  • The maximum length of BINARY, BINARY VARYING, JAVA_OBJECT, GEOMETRY, and JSON values and columns +is 1048576 bytes. +
  • The maximum precision of NUMERIC and DECFLOAT values and columns is 100000. +
  • The maximum length of an ENUM value is 1048576 characters, the maximum number of ENUM values is 65536. +
  • The maximum cardinality of an ARRAY value or column is 65536. +
  • The maximum degree of a ROW value or column is 16384. +
  • The maximum index of parameter is 100000.
  • Main memory requirements: The larger the database, the more main memory is required. - With the current storage mechanism (the page store), - the minimum main memory required is around 1 MB for each 8 GB database file size.
  • Limit on the complexity of SQL statements. -Statements of the following form will result in a stack overflow exception: -
    -SELECT * FROM DUAL WHERE X = 1
    -OR X = 2 OR X = 2 OR X = 2 OR X = 2 OR X = 2
    --- repeat previous line 500 times --
    -
    +Very complex expressions may result in a stack overflow exception.
  • There is no limit for the following entities, except the memory and storage capacity: - maximum identifier length (table name, column name, and so on); - maximum number of tables, columns, indexes, triggers, and other database objects; - maximum statement length, number of parameters per statement, tables per statement, expressions - in order by, group by, having, and so on; + maximum number of tables, indexes, triggers, and other database objects; + maximum statement length, tables per statement; maximum rows per query; - maximum columns per table, columns per index, indexes per table, lob columns per table, and so on; - maximum row length, index row length, select row length; - maximum length of a varchar column, decimal column, literal in a statement. + maximum indexes per table, lob columns per table, and so on; + maximum row length, index row length, select row length.
  • Querying from the metadata tables is slow if there are many tables (thousands). -
  • For limitations on data types, see the documentation of the respective Java data type - or the data type documentation of this database. +
  • For other limitations on data types, see the data type documentation of this database.
diff --git a/h2/src/docsrc/html/architecture.html b/h2/src/docsrc/html/architecture.html index 7d4f3a9cb7..af4ccdca18 100644 --- a/h2/src/docsrc/html/architecture.html +++ b/h2/src/docsrc/html/architecture.html @@ -1,7 +1,7 @@ @@ -50,6 +50,7 @@

Introduction

Top-down Overview

Working from the top down, the layers look like this: +

  • JDBC driver.
  • Connection/session management.
  • SQL Parser. @@ -59,7 +60,6 @@

    Top-down Overview

  • B-tree engine and page-based storage allocation.
  • Filesystem abstraction.
-

JDBC Driver

@@ -69,6 +69,7 @@

JDBC Driver

Connection/session management

The primary classes of interest are: +

@@ -79,7 +80,6 @@

Connection/session management

PackageDescription
org.h2.engine.Databasethe root/global class
org.h2.engine.SessionRemote remote session
-

Parser

@@ -95,14 +95,15 @@

Command execution and planning

Unlike other databases, we do not have an intermediate step where we generate some kind of IR (intermediate representation) of the query. The parser class directly generates a command execution object. Then we run some optimisation steps over the command to possibly generate a more efficient command. - +

+

The primary packages of interest are: +

PackageDescription
org.h2.command.ddlCommands that modify schema data structures
org.h2.command.dmlCommands that modify data
-

Table/Index/Constraints

@@ -110,18 +111,18 @@

Table/Index/Constraints

The primary packages of interest are: +

PackageDescription
org.h2.tableImplementations of different kinds of tables
org.h2.indexImplementations of different kinds of indices
-

Undo log, redo log, and transactions layer

We have a transaction log, which is shared among all sessions. See also https://en.wikipedia.org/wiki/Transaction_log -http://h2database.com/html/grammar.html#set_log +https://h2database.com/html/grammar.html#set_log

We also have an undo log, which is per session, to undo an operation (an update that fails for example) diff --git a/h2/src/docsrc/html/build.html b/h2/src/docsrc/html/build.html index f67226ca0b..87a588d72b 100644 --- a/h2/src/docsrc/html/build.html +++ b/h2/src/docsrc/html/build.html @@ -1,7 +1,7 @@ @@ -25,8 +25,6 @@

Build

Environment
Building the Software
- - Build Targets
Using Maven 2
@@ -49,29 +47,27 @@

Portability

Environment

-To run this database, a Java Runtime Environment (JRE) version 7 or higher is required. +To run this database, a Java Runtime Environment (JRE) version 8 or higher is required.

To create the database executables, the following software stack was used. To use this database, it is not required to install this software however.

Building the Software

-You need to install a JDK, for example the Oracle JDK version 7 or 8. +You need to install a JDK, for example the Oracle JDK version 8. Ensure that Java binary directory is included in the PATH environment variable, and that the environment variable JAVA_HOME points to your Java installation. On the command line, go to the directory h2 and execute the following command: @@ -95,40 +91,9 @@

Building the Software

./build.sh - -

Switching the Source Code

-

-The source code uses Java 7 features. -To switch the source code to the installed version of Java, run: -

-
-build switchSource
-
- -

Build Targets

-

-The build system can generate smaller jar files as well. The following targets are currently supported: -

-
  • jarClient - creates the file h2client.jar. This only contains the JDBC client. -
  • jarSmall - creates the file h2small.jar. - This only contains the embedded database. Debug information is disabled. -
  • jarJaqu - creates the file h2jaqu.jar. - This only contains the JaQu (Java Query) implementation. All other jar files do not include JaQu. -
  • javadocImpl creates the Javadocs of the implementation. -
-

-To create the file h2client.jar, go to the directory h2 and execute the following command: -

-
-build jarClient
-
-

Using Apache Lucene

-Apache Lucene 3.6.2 is used for testing. -Newer versions may work, however they are not tested. +Apache Lucene 8.5.2 is used for testing.

Using Maven 2

@@ -146,7 +111,7 @@

Using a Central Repository

New versions of this database are first uploaded to http://hsql.sourceforge.net/m2-repo/ and then automatically -synchronized with the main Maven repository; +synchronized with the main Maven repository; however after a new release it may take a few hours before they are available there.

Maven Plugin to Start and Stop the TCP Server

@@ -187,7 +152,7 @@

Using Eclipse

To create an Eclipse project for H2, use the following steps:

-