每个数据库为了使用者的查询简便性以及使用效率,都有专门提供一些函数给使用者进行使用,H2也同样如此,虽然没有oracle那么多强大的函数,但是一般需求的使用还是能够满足,下面就简单介绍下都有哪些函数
一、函数的分类以及名称
1、聚合函数(Aggregate Functions)
AVG
BOOL_AND
BOOL_OR
COUNT
GROUP_CONCAT
MAX
MIN
SUM
SELECTIVITY
STDDEV_POP
STDDEV_SAMP
VAR_POP
VAR_SAMP
2、数值函数(Numeric Functions)
ABS
ACOS
ASIN
ATAN
COS
COT
SIN
TAN
ATAN2
BITAND
BITOR
BITXOR
MOD
CEILING
DEGREES
EXP
FLOOR
LOG
LOG10
RADIANS
SQRT
PI
POWER
RAND
RANDOM_UUID
ROUND
ROUNDMAGIC
SECURE_RAND
SIGN
ENCRYPT
DECRYPT
HASH
TRUNCATE
COMPRESS
EXPAND
ZERO
3、字符串函数(String Functions)
ASCII
BIT_LENGTH
LENGTH
OCTET_LENGTH
CHAR
CONCAT
DIFFERENCE
HEXTORAW
RAWTOHEX
INSTR
INSERT Function
LOWER
UPPER
LEFT
RIGHT
LOCATE
POSITION
LPAD
RPAD
LTRIM
RTRIM
TRIM
REGEXP_REPLACE
REPEAT
REPLACE
SOUNDEX
SPACE
STRINGDECODE
STRINGENCODE
STRINGTOUTF8
SUBSTRING
UTF8TOSTRING
XMLATTR
XMLNODE
XMLCOMMENT
XMLCDATA
XMLSTARTDOC
XMLTEXT
4、日期和时间函数(Time and Date Functions)
CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
DATEADD
DATEDIFF
DAYNAME
DAY_OF_MONTH
DAY_OF_WEEK
DAY_OF_YEAR
EXTRACT
FORMATDATETIME
HOUR
MINUTE
MONTH
MONTHNAME
PARSEDATETIME
QUARTER
SECOND
WEEK
YEAR
5、系统函数(System Functions)
ARRAY_GET
ARRAY_LENGTH
AUTOCOMMIT
CANCEL_SESSION
CASEWHEN Function
CAST
COALESCE
CONVERT
CURRVAL
CSVREAD
CSVWRITE
DATABASE
DATABASE_PATH
FILE_READ
GREATEST
IDENTITY
IFNULL
LEAST
LOCK_MODE
LOCK_TIMEOUT
LINK_SCHEMA
MEMORY_FREE
MEMORY_USED
NEXTVAL
NULLIF
READONLY
ROWNUM
SCHEMA
SCOPE_IDENTITY
SESSION_ID
SET
TABLE
TRANSACTION_ID
USER
二、函数的使用以及说明
AVG ( [ DISTINCT ] { int | long | decimal | double } )
平均值。如果没有查询到行,结果集为NULL。聚合方法只能在SELECT语句中使用,返回的值的数据类型与输入参数(字段)类型一致。
例子如下:AVG(X)
BOOL_AND(boolean)
如果表达式为真返回TRUE,如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:BOOL_AND(ID>10)
BOOL_OR(boolean)
如果表达式为真返回TRUE,如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:BOOL_OR(NAME LIKE ‘W%‘)
COUNT( { * | { [ DISTINCT ] expression } } )
统计所有的行数,或者非空值。方法返回一个长整数,如果没有查询到行,返回结果为0。聚合函数只能在SELECT语句中使用。
例子如下:COUNT(*)
GROUP_CONCAT
GROUP_CONCAT ( [ DISTINCT ] string
[ ORDER BY { expression [ ASC | DESC ] } [,...] ]
[ SEPARATOR expression ] )
以分割字符串进行连接。默认的分隔符是一个‘,‘(不带空格),此方法返回一个字符串,如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:GROUP_CONCAT(NAME ORDER BY ID SEPARATOR ‘, ‘)
MAX(value)
取最大值。 如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。
例子如下:MAX(NAME)
MIN(value)
取最小值。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。
例子如下:MIN(NAME)
SUM( [ DISTINCT ] { int | long | decimal | double } )
所有值求和。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。
例子如下:SUM(X)
SELECTIVITY(value)
估算性能优化选择(0-100)。这个值被定义为(100 * distinctCount / rowCount)。设置为了0的优化选择为0(未知) 。10000 以内的值都被保存在内存中。聚合函数只能在SELECT语句中使用。
例子如下:SELECT SELECTIVITY(FIRSTNAME), SELECTIVITY(NAME) FROM TEST WHERE ROWNUM()<20000
STDDEV_POP( [ DISTINCT ] double )
总体标准差。此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:STDDEV_POP(X)
STDDEV_SAMP( [ DISTINCT ] double )
样本标准差。此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:STDDEV(X)
VAR_POPVAR_POP( [ DISTINCT ] double )
总体方差(总体标准方差)。 此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:VAR_POP(X)
VAR_SAMP( [ DISTINCT ] double )
样本方差(样本标准方差)。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。
例子如下:VAR_SAMP(X)
ABS ( { int | long | decimal | double } )
参见JAVA的 Math.abs方法。需要注意的是 Math.abs(Integer.MIN_VALUE) == Integer.MIN_VALUE 和 Math.abs(Long.MIN_VALUE) == Long.MIN_VALUE。返回值的类型和输入参数的类型相同。
例子如下:ABS(ID)
ACOS(double)
参见JAVA的Math.acos方法。这个方法返回一个双精度实数。
例子如下:ACOS(D)
ASIN(double)
参见JAVA的Math.asin方法。这个方法返回一个双精度实数。
例子如下:ASIN(D)
ATAN(double)
参见JAVA的Math.atan方法。这个方法返回个双精度实数。
例子如下:ATAN(D)
COS(double)
参见JAVA的Math.cos方法。这个方法返回个双精度实数。
例子如下:COS(ANGLE)
COT(double)
参见JAVA的方法Math.cot。这个方法返回个双精度实数。
例子如下:COT(ANGLE)
SIN(double)
参见JAVA方法Math.sin。这个方法返回个双精度实数。
例子如下:SIN(ANGLE)
TAN(double)
参见JAVA方法Math.tan。这个方法返回个双精度实数。
例子如下:TAN(ANGLE)
ATAN2(double, double)
参见JAVA方法Math.atan2。这个方法返回个双精度实数。
例子如下:ATAN2(X, Y)
BITAND(long, long)
位的与运算。这个方法返回一个长整数,参见JAVA操作 &。
例子如下:BITAND(A, B)
BITOR(long, long)
位的或运算。这个方法返回一个长整数,参见JAVA操作 |。
例子如下:BITOR(A, B)
BITXOR(long, long)
位的异或运算。这个方法返回一个长整数,参见JAVA操作 ^。
例子如下:BITXOR(A, B)
MOD(long, long)
取余数操作,这个方法返回一个长整数,参见JAVA操作 %。
例子如下:MOD(A, B)
CEILING(double)
参见JAVA方法 Math.ceil。 这个方法返回个双精度实数。
例子如下:LOG(A)
DEGREES(double)
参见JAVA方法Math.toDegrees。这个方法返回个双精度实数。
例子如下:DEGREES(A)
EXPEXP(double)
参见JAVA方法 Math.exp。这个方法返回个双精度实数。
例子如下:EXP(A)
FLOOR(double)
参见JAVA方法 Math.floor。这个方法返回个双精度实数。
例子如下:FLOOR(A)
LOG(double)
参见JAVA方法 Math.log。这个方法返回个双精度实数。
例子如下:LOG(A)
LOG10(double)
参见JAVA方法 Math.log10 (在Java 5中)。这个方法返回个双精度实数。
例子如下:LOG10(A)
RADIANS(double)
参见JAVA方法 Math.toRadians。这个方法返回个双精度实数。
例子如下:RADIANS(A)
SQRT(double)
参见JAVA方法 Math.sqrt。这个方法返回个双精度实数。
例子如下:SQRT(A)
PIPI()
参见JAVA值 Math.PI。这个方法返回个双精度实数。
例子如下:PI()
POWER(double, double)
参见JAVA方法 Math.pow。这个方法返回个双精度实数。
例子如下:POWER(A, B)
RAND( [ int ] )
调用无参的方法返回下一个未指定的随机数。调用带这个SESSION的种子参数的随机数生成器。这个方法返回一个双精度实数。
例子如下:RAND()
RANDOM_UUID
返回一个新的122位未指定随机数的UUID。
例子如下:RANDOM_UUID()
ROUND(double, digitsInt)
四舍五入一个数值,方法返回一个双精度的实数。
例子如下:ROUND(VALUE, 2)
ROUNDMAGIC(double)
更好的四舍五入方法,但是要慢,它在处理约0时有特殊的方法。仅小于等于+/-1000000000000 的数被支持。数值将被在内部转换为一个字符串,然后最后的四个字符被检查,‘000x‘变成‘0000‘,‘999x‘变成 ‘999999‘,四舍五入是自动完成的,方法返回一个双精度的实数。
例子如下:ROUNDMAGIC(VALUE/3*3)
SECURE_RAND(int)
生产加密安全的随机数,方法返回字节串。
例子如下:CALL SECURE_RAND(16)
SIGN ( { int | long | decimal | double } )
如果值小于0返回-1,如果值为0返回0,其他返回1。
例子如下:SIGN(VALUE)
ENCRYPT(algorithmString, keyBytes, dataBytes)
使用密钥加密数据。支持算法 XTEA 和 AES。每块的大小为16字节,这个方法返回字节串。
例子如下:CALL ENCRYPT(‘AES‘, ‘00‘, STRINGTOUTF8(‘Test‘))
DECRYPT(algorithmString, keyBytes, dataBytes)
使用密码解密。支持算法 XTEA 和 AES。每块的大小为16字节,这个方法返回字节串。
例子如下:CALL TRIM(CHAR(0) FROM UTF8TOSTRING(DECRYPT(‘AES‘, ‘00‘, ‘3fabb4de8f1ee2e97d7793bab2db1116‘)))
HASH(algorithmString, dataBytes, iterationInt)
使用一个算法计算一个HASH值,通过一定次数的使用算法迭代计算来获得HASH值。目前仅有 SHA256被支持。这个方法返回字节串。
例子如下:CALL HASH(‘SHA256‘, STRINGTOUTF8(‘Password‘), 1000)
TRUNCATE(double, digitsInt)
截断数值(多余的位数直接截断为0)。这个方法返回一个双精度的实数。
例子如下:TRUNCATE(VALUE, 2)
COMPRESS(dataBytes [, algorithmString])
使用指定的压缩算法压缩数据。目前支持的算法有: LZF (更快但是压缩率更低,缺省的压缩算法), DEFLATE (更高的压缩率)。压缩并不总能减少尺寸,非常小的对象和竟凑对象可能会变得更大。这个方法返回字节串。
例子如下:COMPRESS(STRINGTOUTF8(‘Test‘))
EXPAND(bytes)
解压被COMPRESS 方法压缩的数据。这个方法返回字节串。
例子如下:UTF8TOSTRING(EXPAND(COMPRESS(STRINGTOUTF8(‘Test‘))))
ZERO()
返回值0,这个方法能被用,即使在数字文本被禁用的情况下。
例子如下:ZERO()
ASCII(string)
返回字符串第一个字符的ASCII值。这个方法返回一个整数。
例子如下:ASCII(‘Hi‘)
BIT_LENGTH(string)
返回串的位长度。这个方法返回一个长整数。像BLOB, CLOB, BYTES 和 JAVA_OBJECT, 都可以使用这个方法。每个字符需要16个BIT位。
例子如下:BIT_LENGTH(NAME)
LENGTH{ LENGTH | CHAR_LENGTH | CHARACTER_LENGTH } ( string )
返回串中的字符数量。这个方法返回一个长整数。像 BLOB, CLOB, BYTES 和 JAVA_OBJECT, 都可以使用这个方法。
例子如下:LENGTH(NAME)
OCTET_LENGTH(string)
返回串中的字节数。这个方法返回一个长整数。像BLOB, CLOB, BYTES 和 JAVA_OBJECT, 都可以使用这个方法。每个字符需要2个字节。
例子如下:OCTET_LENGTH(NAME)
CHAR{ CHAR | CHR } ( int )
转换ASCII值为字符。这个方法返回一个字符串。
例子如下:CHAR(65)
CONCAT(string, string [,...])
合并字符串。这个方法返回一个字符串。
例子如下:CONCAT(NAME, ‘!‘)
DIFFERENCE(string, string)
返回两个字符串的读音差别。这个方法返回一个整数。
例子如下:DIFFERENCE(T1.NAME, T2.NAME)
HEXTORAW(string)
转换16进制字符串为普通字符串,4个16进制字符转换一个字符。
例子如下:HEXTORAW(DATA)
RAWTOHEX(string)
转换普通字符串为16进制字符串。一个字符转换为4个16进制字符。这个方法返回一个字符串。
例子如下:RAWTOHEX(DATA)
INSTR(string, searchString, [, startInt])
查找子串在字符串中的位置。如果一个开始位置被指定,这个位置之前的字符将被忽略,如果指定的开始位置为负数,从右数到开始位置的字符将被忽略。如果子串在字符串中未找到,返回0。
例子如下:INSTR(EMAIL,‘@‘)
INSERT FunctionINSERT(originalString, startInt, lengthInt, addString)
插入一个附加的字符串到指定串的指定位置。lengthInt指定在原串中从startInt指定的位置删除的字符数。这个方法返回一个字符串。
例子如下:INSERT(NAME, 1, 1, ‘ ‘)
LOWER{ LOWER | LCASE } ( string )
转换一个字符串为小写。
例子如下:LOWER(NAME)
UPPER{ UPPER | UCASE } ( string )
转换一个字符串为大写。
例子如下:UPPER(NAME)
LEFT(string, int)
返回左边的子字符串。
例子如下:LEFT(NAME, 3)
RIGHT(string, int)
返回右边的子字符串。
例子如下:RIGHT(NAME, 3)
LOCATE(searchString, string [, startInt])
返回子串在字符串中的位置。如果一个开始位置被指定,这个位置之前的字符将被忽略,如果指定的开始位置为负数,从右数到开始位置的字符将被忽略。如果子串在字符串中未找到,返回0。
例子如下:LOCATE(‘.‘, NAME)
POSITION(searchString, string)
返回子串在字符串中的位置。参考 LOCATE。
例子如下:POSITION(‘.‘, NAME)
LPAD(string, int[, paddingString])
左填充指定长度的字符串。如果指定的长度比字符串的实际长度要短,将把字符串从尾部进行截断。如果填充字符串未指定,空格将被填充。
例子如下:LPAD(AMOUNT, 10, ‘*‘)
RPAD(string, int[, paddingString])
右填充指定长度的字符串。如果指定的长度比字符串的实际长度短,将把字符串截断。如果填充字符串未指定,空格将被填充。
例子如下:RPAD(TEXT, 10, ‘-‘)
LTRIM(string)
从字符串中移走所有的前导空格。
例子如下:LTRIM(NAME)
RTRIM(string)
从字符串中移走所有的尾部空格。
例子如下:RTRIM(NAME)
TRIM ( [ { LEADING | TRAILING | BOTH } [ string ] FROM ] string )
移走字符串前导和尾部两端的全部空格。其他字符也可以通过指定被移走。
例子如下:TRIM(BOTH ‘_‘ FROM NAME)
REGEXP_REPLACE(inputString, regexString, replacementString)
使用正则表达式进行字符串替换。关于更多细节,请参看JAVA方法 String.replaceAll()。
例子如下:REGEXP_REPLACE(‘Hello World‘, ‘ +‘, ‘ ‘)
REPEAT(string, int)
返回字符串中循环的次数。
例子如下:REPEAT(NAME || ‘ ‘, 10)
REPLACE(string, searchString [, replacementString])
使用另一个字符串替换文本中所有的搜索到的串。如果没有替换字符串被指定,搜索到的字符串将从原串中删除。
例子如下:REPLACE(NAME, ‘ ‘)
SOUNDEX(string)
返回代表字符串读音的四个字符代码。参见 http://www.archives.gov/genealogy/census/soundex.html 。这个方法返回一个字符串。
例子如下:SOUNDEX(NAME)
SPACE(int)
返回组成字符串的空格数。
例子如下:SPACE(80)
STRINGDECODE(string)
使用JAVA文本格式符解码字符串。特定的字符包括 \b, \t, \n, \f, \r, \", \\, \, \u。这个方法返回一个字符串。
例子如下:CALL STRINGENCODE(STRINGDECODE(‘Lines 1\nLine 2‘))
STRINGENCODE(string)
使用JAVA文本格式符编码字符串。特定的字符包括 \b, \t, \n, \f, \r, \", \\, \, \u。这个方法返回一个字符串。
例子如下:CALL STRINGENCODE(STRINGDECODE(‘Lines 1\nLine 2‘))
STRINGTOUTF8(string)
转换字符串为UTF8编码格式的字节数组。这个方法返回字节串。
例子如下:CALL UTF8TOSTRING(STRINGTOUTF8(‘This is a test‘))
SUBSTRING{ SUBSTRING | SUBSTR } ( string, startInt [, lengthInt ] )
提取指定起始位置的子串。长度是可选的,也支持:SUBSTRING(string FROM start [FOR length]).
例子如下:SUBSTR(NAME, 1)
UTF8TOSTRING(bytes)
将UTF8格式的字节数组解码为字符串。
例子如下:CALL UTF8TOSTRING(STRINGTOUTF8(‘This is a test‘))
XMLATTR(nameString, valueString)
创建XML属性元素,形式为 name="value"。value被编码为XML文本。这个方法返回字符串。
例子如下:CALL XMLNODE(‘a‘, XMLATTR(‘href‘, ‘http://h2database.com‘))
XMLNODE(elementString [, attributesString [, contentString]])
创建一个XML节点元素,这个方法返回一个字符串。
例子如下:CALL XMLNODE(‘a‘, XMLATTR(‘href‘, ‘http://h2database.com‘), ‘H2‘)
XMLCOMMENT(commentString)
创建一个XML注释。两个破折号(--)被转换为 - -。这个方法返回字符串。
例子如下:CALL XMLCOMMENT(‘Test‘)
XMLCDATA(valueString)
创建一个XML的CDATA 元素。如果值内容包含 ‘]]>‘,一个XML文本元素将被替代创建。这个方法返回一个字符串。
例子如下:CALL XMLCDATA(‘data‘)
XMLSTARTDOC()
字符串 ‘‘ 将被返回。
例子如下:CALL XMLSTARTDOC()
XMLTEXT(valueString)
创建一个XML文本元素,这个方法返回字符串。
例子如下:CALL XMLTEXT(‘test‘)
ARRAY_GET(arrayExpression, indexExpression)
返回一个数组元素,这个方法返回一个字符串。
例子如下:CALL ARRAY_GET((‘Hello‘, ‘World‘), 2)
ARRAY_LENGTH(arrayExpression)
返回一个数组的长度。
例子如下:CALL ARRAY_LENGTH((‘Hello‘, ‘World‘))
AUTOCOMMIT()
如果在这个SESSION上自动提交被打开,将返回TRUE。
例子如下:AUTOCOMMIT()
CANCEL_SESSION(sessionInt)
取消另外的SESSION正在执行的语句。这个方法仅工作在多线程内核被启动的情况下 (多线程查看 SET MULTI_THREADED)。如果语句被取消返回TRUE,如果SESSION已经关闭或是没有语句正在执行,返回FALSE。
执行这个语句需要管理员权限。
例子如下:CANCEL_SESSION(3)
CASEWHEN FunctionCASEWHEN(boolean, aValue, bValue)
如果boolean表达式为真返回aValue,否则返回bValue。返回与输入参数类型相同的数据类型。
例子如下:CASEWHEN(ID=1, ‘A‘, ‘B‘)
CAST(value AS dataType)
转换一个值为另外一种数据类型。当转换文本为数字时,默认的JAVA转换规则被使用(前缀为 0x 或 # 表示16进制数,前缀为0表示8进制数)。
例子如下:CAST(NAME AS INT)
COALESCE(aValue, bValue [,...])
返回第一个非空值。
例子如下:COALESCE(A, B, C)
CONVERT(value, dataType)
转换一个值为另外一种数据类型。
例子如下:CONVERT(NAME, INT)
CURRVAL( [ schemaName, ] sequenceString )
返回序列的当前(最后)值,不依赖SESSION。如果序列刚创建,方法返回(start - interval)。如果SCHEMA名没有指定,当前SCHEMA被指定。如果SCHEMA名没有被指定,序列名将被转换为大写(为了兼容性)。这个方法返回长整数。
例子如下:CURRVAL(‘TEST_SEQ‘)
CSVREAD(fileNameString [, columnsString [, csvOptions ] ] )
返回读CSV(逗号分隔字段)文件的结果集。对于每个参数,NULL表示缺省值被提供。
如果字段名列表被指定(使用字段分隔符分割的字段列表),将使用这些字段名,如果没有被指定(或者它们被设置为NULL),文件的第一行被解释为字段列名,在这种情况下,列名不包含特殊字符(仅包含字母、 ‘_‘、数字;类似于JAVA标识符的规则),并且是区分大小写的。另外,列名都是区分大小写的,这表示你需要使用引用标识符(见下面的说明)。
缺省的字符集为系统的缺省值,缺省的字段分隔符是逗号。没有加引号的值匹配空串时被解析为NULL,左右的列类型都是 VARCHAR。
这个方法能被像表一样被使用: SELECT * FROM CSVREAD(...)。也可以使用URL来替代文件使用,如 jar:file:///c:/temp/example.zip!/org/example/nested.zip.
执行这个语句需要管理员权限。
例子如下:
CALL CSVREAD(‘test.csv‘);
-- 如一个包含字段 ID, NAME 的文件
-- 文件的字符集为 UTF-8 ,管道符 (|) 作为字段分隔符
CALL CSVREAD(‘test2.csv‘, ‘ID|NAME‘, ‘UTF-8‘, ‘|‘);
--读一个分号分隔的文件
SELECT * FROM CSVREAD(‘data/test.csv‘, NULL, NULL, ‘;‘);
SELECT "Last Name" FROM CSVREAD(‘address.csv‘);
CSVWRITE( fileNameString, queryString [, csvOptions [, lineSepString] ] )
写一个CSV(逗号分隔)文件爱你。如果文件存在就覆盖。对每个参数,使用NULL表示使用缺省值。缺省字符集为系统缺省值,缺省字段分隔符为逗号。
值将使用缺省的字符串表示法转换为文本。如果需要其他转换方式需要改变选择语句。当参数为NULL时将写入空串(缺省情况下,当NULL出现时什么都不写)。缺省的行分隔符为系统的缺省值(参见系统属性‘line.separator‘ )。
返回写的行数。执行这个语句需要管理员权限。
例子如下:
CALL CSVWRITE(‘test.csv‘, ‘SELECT * FROM TEST‘);
-- 写文件使用 UTF-8 编码,管道符(|)为字段分隔符
CALL CSVWRITE(‘test2.csv‘, ‘SELECT * FROM TEST‘, ‘UTF-8‘, ‘|‘);
DATABASE()
返回数据库名
例子如下:CALL DATABASE();
DATABASE_PATH()
返回数据库文件路径和数据库名,如果不是基于文件的数据库,返回NULL。
例子如下:CALL DATABASE_PATH();
FILE_READ(fileNameString [,encodingString])
返回文件内容,如果仅一个参数被提供,数据被作为 BLOB返回。如果两个参数被提供,数据被作为 CLOB 文本返回。 第二个参数作为字符集使用,NULL表示使用系统缺省的字符集。文件名和URL被支持。执行这个语句需要管理员权限。
例子如下:
SELECT LENGTH(FILE_READ(‘~/.h2.server.properties‘)) LEN;
SELECT FILE_READ(‘http://localhost:8182/stylesheet.css‘, NULL) CSS;
GREATEST(aValue, bValue [,...])
返回最大的非空值,如果所有的值为NULL,将返回NULL。
例子如下:CALL GREATEST(1, 2, 3);
IDENTITY()
返回当前SESSION最后写入的标识符。当一个新的序列号产生时,这个值都将改变,即使是在触发器或是JAVA方法中,详细参见 SCOPE_IDENTITY()。这个方法返回一个长整数。
例子如下:CALL IDENTITY();
IFNULL(aValue, bValue)
如果值为非空返回aValue,否则返回bValue。
例子如下:CALL IFNULL(NULL, ‘‘);
LEAST(aValue, bValue [,...])
返回非空的最小值,如果所有的值都是NULL,将返回NULL。
例子如下:CALL LEAST(1, 2, 3);
LOCK_MODE()
返回当前所模式。参见SET LOCK_MODE。这个方法返回一个整数。
例子如下:CALL LOCK_MODE();
LOCK_TIMEOUT()
返回当前SESSION的锁超时时间(毫秒数)。
例子如下:LOCK_TIMEOUT()
LINK_SCHEMA(targetSchemaString, driverString, urlString,
userString, passwordString, sourceSchemaString)
在一个SCHEMA创建所有表的表链接。如果同名的表已经存在,将先删除它们。目标SCHEMA在不存在的情况下将被自动创建。驱动如果已经加载了驱动名可以为空。链接表列表作为结果集被返回。执行这个语句需要管理员权限。
例子如下:CALL LINK_SCHEMA(‘TEST2‘, ‘‘, ‘jdbc:h2:test2‘, ‘sa‘, ‘sa‘, ‘PUBLIC‘);
MEMORY_FREE()
返回空闲内存,单位为 KB (1024 字节为一 KB)。这个方法返回一个整数。在返回这个值前,垃圾收集器将被执行。这行这个语句需要管理员权限。
例子如下:MEMORY_FREE()
MEMORY_USED()
返回已用的内存,单位为 KB (1024 字节为一 KB)。这个方法返回一个整数。在返回这个值前,垃圾收集器将被执行。这行这个语句需要管理员权限。
例子如下:MEMORY_USED()
NEXTVAL( [ schemaName, ] sequenceString )
返回序列的下一个值。已经被使用过的值永远也不会再用,即使事务被回滚。如果SCHEMA没有被设置,当前SCHEMA被使用,序列名将被转换为大写(为了兼容性)。这个方法返回一个长整数。
例子如下:NEXTVAL(‘TEST_SEQ‘)
NULLIF(aValue, bValue)
如果aValue等于bValue返回NULL,否则返回aValue。
例子如下:NULLIF(A, B)
READONLY()
如果数据库是只读的,返回TRUE。
例子如下:READONLY()
ROWNUM()
返回当前行数,这个方法返回一个整数。这个方法支持SELECT语句、DELETE语句和UPDATE语句。第一行为行号1,行号在结果集分组和排序前被计算。要获得排序和分组之后的行号,需要使用子查询。
例子如下:
SELECT ROWNUM(), * FROM TEST;
SELECT ROWNUM(), * FROM (SELECT * FROM TEST ORDER BY NAME);
SCHEMA()
返回这个SESSION的缺省SCHEMA名。
例子如下:CALL SCHEMA()
SCOPE_IDENTITY()
返回当前SESSION当前作用范围的最后插入的标识符值,在触发器和JAVA方法中的改变将被忽略。参见 IDENTITY()。这个方法返回一个长整数。
例子如下:CALL SCOPE_IDENTITY();
SESSION_ID()
返回当前数据库连接的唯一SESSION标识号。这个标识号在连接打开期间一直存在。这个方法返回一个整数。数据库引擎可以重复使用已经关闭的连接的SESSION标识号。
例子如下:CALL SESSION_ID()
SET(@variableName, value)
更新指定变量的值。新值将被返回。当使用在查询中时,值将被按读的顺序进行更新。
例子如下:SELECT X, SET(@I, IFNULL(@I, 0)+X) RUNNING_TOTAL FROM SYSTEM_RANGE(1, 10)
TABLE{ TABLE | TABLE_DISTINCT } ( { name dataType = expression } [,...] )
返回结果集。 TABLE_DISTINCT 删除重复的行。
例子如下:SELECT * FROM TABLE(ID INT=(1, 2), NAME VARCHAR=(‘Hello‘, ‘World‘))
TRANSACTION_ID()
返回当前SESSION的当前事务ID。如果没有未提交的改变,或是数据不是持久化的,这个方法返回NULL,否则下面形式的值被返回: logFileId-position-sessionId。这个方法返回一个字符串。这个值在数据库重启后也是唯一的值(值不会被重新使用)。
例子如下:CALL TRANSACTION_ID()
USER{ USER | CURRENT_USER } ()
返回当前SESSION的当前用户的用户名。
例子如下:CURRENT_USER()
CURRENT_DATE{ CURRENT_DATE [ () ] | CURDATE() | SYSDATE | TODAY }
返回当前日期。
例子如下:CURRENT_DATE()
CURRENT_TIME{ CURRENT_TIME [ () ] | CURTIME() }
返回当前时间。
例子如下:CURRENT_TIME()
CURRENT_TIMESTAMP{ CURRENT_TIMESTAMP [ ( [ int ] ) ] | NOW( [ int ] ) }
返回当前时间戳,纳秒精度参数是可选的。
例子如下:CURRENT_TIMESTAMP()
DATEADD(unitString, addInt, timestamp)
增加一个单元到时间戳中,使用字符串表示这个单元,使用负数来裁剪单元。同样的单元在 EXTRACT 方法中被支持。这个方法返回一个时间戳。
例子如下:DATEADD(MONTH, 1, DATE ‘2001-01-31‘)
DATEDIFF(unitString, aTimestamp, bTimestamp)
返回两个时间戳的差值。这个方法返回一个长整数。字符串表示这个单元。同样的单元在 EXTRACT 方法中被支持。
例子如下:DATEDIFF(YEAR, T1.CREATED, T2.CREATED)
DAYNAME(date)
返回日期的名称(英语)。
例子如下:DAYNAME(CREATED)
DAY_OF_MONTH(date)
返回月份的第几天 (1-31)。
例子如下:DAY_OF_MONTH(CREATED)
DAY_OF_WEEK(date)
返回星期的第几天 (1 表示星期一).
例子如下:DAY_OF_WEEK(CREATED)
DAY_OF_YEAR(date)
返回一年中的第几天 (1-366).
例子如下:DAY_OF_YEAR(CREATED)
EXTRACT( { YEAR | YY | MONTH | MM | DAY | DD | DAY_OF_YEAR
| DOY | HOUR | HH | MINUTE | MI | SECOND | SS | MILLISECOND | MS }
FROM timestamp )
返回时间戳里指定的值。这个方法返回一个整数。
例子如下:EXTRACT(SECOND FROM CURRENT_TIMESTAMP)
FORMATDATETIME ( timestamp, formatString , localeString , timeZoneString)
格式化日期、时间或时间戳为字符串。最重要的格式符为: y 年, M 月, d 日, H 小时, m 分钟, s 秒。详细的格式说明参见 java.text.SimpleDateFormat。这个方法返回一个字符串。
例子如下:CALL FORMATDATETIME(TIMESTAMP ‘2001-02-03 04:05:06‘, ‘EEE, d MMM yyyy HH:mm:ss z‘, ‘en‘, ‘GMT‘)
HOUR(timestamp)
返回时间戳中的小时数(0-23)。
例子如下:HOUR(CREATED)
MINUTE(timestamp)
返回时间戳中的分钟数(0-59)。
例子如下:MINUTE(CREATED)
MONTH(timestamp)
返回时间戳中的月份数(1-12)。
例子如下:MONTH(CREATED)
MONTHNAME(date)
返回指定月的月名(英文)。
例子如下:MONTHNAME(CREATED)
PARSEDATETIME(string, formatString, localeString , timeZoneString)
解析字符串返回时间戳。最重要的格式符有: y 年, M 月, d 日, H 小时, m 分钟, s 秒。关于格式更多信息,请参考java.text.SimpleDateFormat.
例子如下:CALL PARSEDATETIME(‘Sat, 3 Feb 2001 03:05:06 GMT‘, ‘EEE, d MMM yyyy HH:mm:ss z‘, ‘en‘, ‘GMT‘)
QUARTER(timestamp)
返回时间戳的季度数 (1-4) 。
例子如下:QUARTER(CREATED)
SECOND(timestamp)
返回时间戳的秒数(0-59)。
例子如下:SECOND(CREATED)
WEEK(timestamp)
返回时间戳的星期数(1-53) 。这个方法使用当前系统所在地的时区。
例子如下:WEEK(CREATED)
YEAR(timestamp)
返回时间戳的年份
例子如下:YEAR(CREATED)