H2Database聚合函数

聚合函数(Aggregate Functions

AVG
  BOOL_AND
  BOOL_OR
  COUNT
  GROUP_CONCAT
 
 

MAX
  MIN
  SUM
  SELECTIVITY
  STDDEV_POP
 
 

STDDEV_SAMP
  VAR_POP
  VAR_SAMP

数值函数(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

字符串函数(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

日期和时间函数(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

系统函数(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


AVGAVG ( [ DISTINCT ] { int | long | decimal | double } )

平均值。如果没有查询到行,结果集为NULL。聚合方法只能在SELECT语句中使用,返回的值的数据类型与输入参数(字段)类型一致。

例子如下:

AVG(X)

BOOL_ANDBOOL_AND(boolean)

如果表达式为真返回TRUE,如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

BOOL_AND(ID>10)

BOOL_ORBOOL_OR(boolean)

如果表达式为真返回TRUE,如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

BOOL_OR(NAME LIKE 'W%')

COUNTCOUNT( { * | { [ 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 ', ')

MAXMAX(value)

取最大值。 如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。

例子如下:

MAX(NAME)

MINMIN(value)

取最小值。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。

例子如下:

MIN(NAME)

SUMSUM( [ DISTINCT ] { int | long | decimal | double } )

所有值求和。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。 返回的值的数据类型与输入参数(字段)类型一致。

例子如下:

SUM(X)

SELECTIVITYSELECTIVITY(value)

估算性能优化选择(0-100)。这个值被定义为(100 * distinctCount / rowCount)。设置为了0的优化选择为0(未知) 。10000 以内的值都被保存在内存中。聚合函数只能在SELECT语句中使用。

例子如下:

SELECT SELECTIVITY(FIRSTNAME), SELECTIVITY(NAME) FROM TEST WHERE ROWNUM()<20000

STDDEV_POPSTDDEV_POP( [ DISTINCT ] double )

总体标准差。此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

STDDEV_POP(X)

STDDEV_SAMPSTDDEV_SAMP( [ DISTINCT ] double )

样本标准差。此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

STDDEV(X)

VAR_POPVAR_POP( [ DISTINCT ] double )

总体方差(总体标准方差)。 此方法返回一个双精度实数。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

VAR_POP(X)

VAR_SAMPVAR_SAMP( [ DISTINCT ] double )

样本方差(样本标准方差)。如果没有查询到行,结果集为NULL,聚合函数只能在SELECT语句中使用。

例子如下:

VAR_SAMP(X)

ABSABS ( { 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)

ACOSACOS(double)

参见JAVA的Math.acos方法。这个方法返回一个双精度实数。

例子如下:

ACOS(D)

ASINASIN(double)

参见JAVA的Math.asin方法。这个方法返回一个双精度实数。

例子如下:

ASIN(D)

ATANATAN(double)

参见JAVA的Math.atan方法。这个方法返回个双精度实数。

例子如下:

ATAN(D)

COSCOS(double)

参见JAVA的Math.cos方法。这个方法返回个双精度实数。

例子如下:

COS(ANGLE)

COTCOT(double)

参见JAVA的方法Math.cot。这个方法返回个双精度实数。

例子如下:

COT(ANGLE)

SINSIN(double)

参见JAVA方法Math.sin。这个方法返回个双精度实数。

例子如下:

SIN(ANGLE)

TANTAN(double)

参见JAVA方法Math.tan。这个方法返回个双精度实数。

例子如下:

TAN(ANGLE)

ATAN2ATAN2(double, double)

参见JAVA方法Math.atan2。这个方法返回个双精度实数。

例子如下:

ATAN2(X, Y)

BITANDBITAND(long, long)

位的与运算。这个方法返回一个长整数,参见JAVA操作 &。

例子如下:

BITAND(A, B)

BITORBITOR(long, long)

位的或运算。这个方法返回一个长整数,参见JAVA操作 |。

例子如下:

BITOR(A, B)

BITXORBITXOR(long, long)

位的异或运算。这个方法返回一个长整数,参见JAVA操作 ^。

例子如下:

BITXOR(A, B)

MODMOD(long, long)

取余数操作,这个方法返回一个长整数,参见JAVA操作 %。

例子如下:

MOD(A, B)

CEILINGCEILING(double)

参见JAVA方法 Math.ceil。 这个方法返回个双精度实数。

例子如下:

LOG(A)

DEGREESDEGREES(double)

参见JAVA方法Math.toDegrees。这个方法返回个双精度实数。

例子如下:

DEGREES(A)

EXPEXP(double)

参见JAVA方法 Math.exp。这个方法返回个双精度实数。

例子如下:

EXP(A)

FLOORFLOOR(double)

参见JAVA方法 Math.floor。这个方法返回个双精度实数。

例子如下:

FLOOR(A)

LOGLOG(double)

参见JAVA方法 Math.log。这个方法返回个双精度实数。

例子如下:

LOG(A)

LOG10LOG10(double)

参见JAVA方法 Math.log10 (在Java 5中)。这个方法返回个双精度实数。

例子如下:

LOG10(A)

RADIANSRADIANS(double)

参见JAVA方法 Math.toRadians。这个方法返回个双精度实数。

例子如下:

RADIANS(A)

SQRTSQRT(double)

参见JAVA方法 Math.sqrt。这个方法返回个双精度实数。

例子如下:

SQRT(A)

PIPI()

参见JAVA值 Math.PI。这个方法返回个双精度实数。

例子如下:

PI()

POWERPOWER(double, double)

参见JAVA方法 Math.pow。这个方法返回个双精度实数。

例子如下:

POWER(A, B)

RANDRAND( [ int ] )

调用无参的方法返回下一个未指定的随机数。调用带这个SESSION的种子参数的随机数生成器。这个方法返回一个双精度实数。

例子如下:

RAND()

RANDOM_UUIDRANDOM_UUID()

返回一个新的122位未指定随机数的UUID。

例子如下:

RANDOM_UUID()

ROUNDROUND(double, digitsInt)

四舍五入一个数值,方法返回一个双精度的实数。

例子如下:

ROUND(VALUE, 2)

ROUNDMAGICROUNDMAGIC(double)

更好的四舍五入方法,但是要慢,它在处理约0时有特殊的方法。仅小于等于+/-1000000000000 的数被支持。数值将被在内部转换为一个字符串,然后最后的四个字符被检查,'000x'变成'0000','999x'变成 '999999',四舍五入是自动完成的,方法返回一个双精度的实数。

例子如下:

ROUNDMAGIC(VALUE/3*3)

SECURE_RANDSECURE_RAND(int)

生产加密安全的随机数,方法返回字节串。

例子如下:

CALL SECURE_RAND(16)

SIGNSIGN ( { int | long | decimal | double } )

如果值小于0返回-1,如果值为0返回0,其他返回1。

例子如下:

SIGN(VALUE)

ENCRYPTENCRYPT(algorithmString, keyBytes, dataBytes)

使用密钥加密数据。支持算法 XTEA 和 AES。每块的大小为16字节,这个方法返回字节串。

例子如下:

CALL ENCRYPT('AES', '00', STRINGTOUTF8('Test'))

DECRYPT

DECRYPT(algorithmString, keyBytes, dataBytes)

使用密码解密。支持算法 XTEA 和 AES。每块的大小为16字节,这个方法返回字节串。

例子如下:

CALL TRIM(CHAR(0) FROM UTF8TOSTRING(
    DECRYPT('AES', '00', '3fabb4de8f1ee2e97d7793bab2db1116')))

HASHHASH(algorithmString, dataBytes, iterationInt)

使用一个算法计算一个HASH值,通过一定次数的使用算法迭代计算来获得HASH值。目前仅有 SHA256被支持。这个方法返回字节串。

例子如下:

CALL HASH('SHA256', STRINGTOUTF8('Password'), 1000)

TRUNCATETRUNCATE(double, digitsInt)

截断数值(多余的位数直接截断为0)。这个方法返回一个双精度的实数。

例子如下:

TRUNCATE(VALUE, 2)

COMPRESSCOMPRESS(dataBytes [, algorithmString])

使用指定的压缩算法压缩数据。目前支持的算法有: LZF (更快但是压缩率更低,缺省的压缩算法), DEFLATE (更高的压缩率)。压缩并不总能减少尺寸,非常小的对象和竟凑对象可能会变得更大。这个方法返回字节串。

例子如下:

COMPRESS(STRINGTOUTF8('Test'))

EXPANDEXPAND(bytes)

解压被COMPRESS 方法压缩的数据。这个方法返回字节串。

例子如下:

UTF8TOSTRING(EXPAND(COMPRESS(STRINGTOUTF8('Test'))))

ZEROZERO()

返回值0,这个方法能被用,即使在数字文本被禁用的情况下。

例子如下:

ZERO()

ASCIIASCII(string)

返回字符串第一个字符的ASCII值。这个方法返回一个整数。

例子如下:

ASCII('Hi')

BIT_LENGTHBIT_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_LENGTHOCTET_LENGTH(string)

返回串中的字节数。这个方法返回一个长整数。像BLOB, CLOB, BYTES 和 JAVA_OBJECT, 都可以使用这个方法。每个字符需要2个字节。

例子如下:

OCTET_LENGTH(NAME)

CHAR{ CHAR | CHR } ( int )

转换ASCII值为字符。这个方法返回一个字符串。

例子如下:

CHAR(65)

CONCATCONCAT(string, string [,...])

合并字符串。这个方法返回一个字符串。

例子如下:

CONCAT(NAME, '!')

DIFFERENCEDIFFERENCE(string, string)

返回两个字符串的读音差别。这个方法返回一个整数。

例子如下:

DIFFERENCE(T1.NAME, T2.NAME)

HEXTORAWHEXTORAW(string)

转换16进制字符串为普通字符串,4个16进制字符转换一个字符。

例子如下:

HEXTORAW(DATA)

RAWTOHEXRAWTOHEX(string)

转换普通字符串为16进制字符串。一个字符转换为4个16进制字符。这个方法返回一个字符串。

例子如下:

RAWTOHEX(DATA)

INSTRINSTR(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) 

LEFTLEFT(string, int)

返回左边的子字符串。

例子如下:

LEFT(NAME, 3)

RIGHTRIGHT(string, int)

返回右边的子字符串。

例子如下:

RIGHT(NAME, 3)

LOCATELOCATE(searchString, string [, startInt])

返回子串在字符串中的位置。如果一个开始位置被指定,这个位置之前的字符将被忽略,如果指定的开始位置为负数,从右数到开始位置的字符将被忽略。如果子串在字符串中未找到,返回0。

例子如下:

LOCATE('.', NAME)

POSITIONPOSITION(searchString, string)

返回子串在字符串中的位置。参考 LOCATE。

例子如下:

POSITION('.', NAME)

LPADLPAD(string, int[, paddingString])

左填充指定长度的字符串。如果指定的长度比字符串的实际长度要短,将把字符串从尾部进行截断。如果填充字符串未指定,空格将被填充。

例子如下:

LPAD(AMOUNT, 10, '*')

RPADRPAD(string, int[, paddingString])

右填充指定长度的字符串。如果指定的长度比字符串的实际长度短,将把字符串截断。如果填充字符串未指定,空格将被填充。

例子如下:

RPAD(TEXT, 10, '-')

LTRIMLTRIM(string)

从字符串中移走所有的前导空格。

例子如下:

LTRIM(NAME)

RTRIMRTRIM(string)

从字符串中移走所有的尾部空格。

例子如下:

RTRIM(NAME)

TRIMTRIM ( [ { LEADING | TRAILING | BOTH } [ string ] FROM ] string )

移走字符串前导和尾部两端的全部空格。其他字符也可以通过指定被移走。

例子如下:

TRIM(BOTH '_' FROM NAME)

REGEXP_REPLACEREGEXP_REPLACE(inputString, regexString, replacementString)

使用正则表达式进行字符串替换。关于更多细节,请参看JAVA方法 String.replaceAll()。

例子如下:

REGEXP_REPLACE('Hello    World', ' +', ' ')

REPEATREPEAT(string, int)

返回字符串中循环的次数。

例子如下:

REPEAT(NAME || ' ', 10)

REPLACEREPLACE(string, searchString [, replacementString])

使用另一个字符串替换文本中所有的搜索到的串。如果没有替换字符串被指定,搜索到的字符串将从原串中删除。

例子如下:

REPLACE(NAME, ' ')

SOUNDEXSOUNDEX(string)

返回代表字符串读音的四个字符代码。参见 http://www.archives.gov/genealogy/census/soundex.html 。这个方法返回一个字符串。

例子如下:

SOUNDEX(NAME)

SPACESPACE(int

返回组成字符串的空格数。

例子如下:

SPACE(80)

STRINGDECODESTRINGDECODE(string)

使用JAVA文本格式符解码字符串。特定的字符包括 \b, \t, \n, \f, \r, \", \\, \<octal>, \u<unicode>。这个方法返回一个字符串。

例子如下:

CALL STRINGENCODE(STRINGDECODE('Lines 1\nLine 2'))

STRINGENCODESTRINGENCODE(string)

使用JAVA文本格式符编码字符串。特定的字符包括 \b, \t, \n, \f, \r, \", \\, \<octal>, \u<unicode>。这个方法返回一个字符串。

例子如下:

CALL STRINGENCODE(STRINGDECODE('Lines 1\nLine 2'))

STRINGTOUTF8STRINGTOUTF8(string)

转换字符串为UTF8编码格式的字节数组。这个方法返回字节串。

例子如下:

CALL UTF8TOSTRING(STRINGTOUTF8('This is a test'))

SUBSTRING{ SUBSTRING | SUBSTR } ( string, startInt [, lengthInt ] )

提取指定起始位置的子串。长度是可选的,也支持:SUBSTRING(string FROM start [FOR length]).

例子如下:

SUBSTR(NAME, 1)

UTF8TOSTRINGUTF8TOSTRING(bytes)

将UTF8格式的字节数组解码为字符串。

例子如下:

CALL UTF8TOSTRING(STRINGTOUTF8('This is a test'))

XMLATTRXMLATTR(nameString, valueString)

创建XML属性元素,形式为 name="value"。value被编码为XML文本。这个方法返回字符串。

例子如下:

CALL XMLNODE('a', XMLATTR('href', 'http://h2database.com'))

XMLNODEXMLNODE(elementString [, attributesString [, contentString]])

创建一个XML节点元素,这个方法返回一个字符串。

例子如下:

CALL XMLNODE('a', XMLATTR('href', 'http://h2database.com'), 'H2')

XMLCOMMENTXMLCOMMENT(commentString)

创建一个XML注释。两个破折号(--)被转换为 - -。这个方法返回字符串。

例子如下:

CALL XMLCOMMENT('Test')

XMLCDATAXMLCDATA(valueString)

创建一个XML的CDATA 元素。如果值内容包含 ']]>',一个XML文本元素将被替代创建。这个方法返回一个字符串。

例子如下:

CALL XMLCDATA('data')

XMLSTARTDOCXMLSTARTDOC()

字符串 '<?xml version="1.0"?>' 将被返回。

例子如下:

CALL XMLSTARTDOC()

XMLTEXTXMLTEXT(valueString)

创建一个XML文本元素,这个方法返回字符串。

例子如下:

CALL XMLTEXT('test')

ARRAY_GETARRAY_GET(arrayExpression, indexExpression)

返回一个数组元素,这个方法返回一个字符串。

例子如下:

CALL ARRAY_GET(('Hello', 'World'), 2)

ARRAY_LENGTHARRAY_GET(arrayExpression)

返回一个数组的长度。

例子如下:

CALL ARRAY_LENGTH(('Hello', 'World'))

AUTOCOMMITAUTOCOMMIT()

如果在这个SESSION上自动提交被打开,将返回TRUE。

例子如下:

AUTOCOMMIT()

CANCEL_SESSIONCANCEL_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')

CASTCAST(value AS dataType)

转换一个值为另外一种数据类型。当转换文本为数字时,默认的JAVA转换规则被使用(前缀为 0x 或 # 表示16进制数,前缀为0表示8进制数)。

例子如下:

CAST(NAME AS INT)

COALESCECOALESCE(aValue, bValue [,...])

返回第一个非空值。

例子如下:

COALESCE(A, B, C)

CONVERTCONVERT(value, dataType)

转换一个值为另外一种数据类型。

例子如下:

CONVERT(NAME, INT)

CURRVALCURRVAL( [ schemaName, ] sequenceString )

返回序列的当前(最后)值,不依赖SESSION。如果序列刚创建,方法返回(start - interval)。如果SCHEMA名没有指定,当前SCHEMA被指定。如果SCHEMA名没有被指定,序列名将被转换为大写(为了兼容性)。这个方法返回长整数。

例子如下:

CURRVAL('TEST_SEQ')

CSVREADCSVREAD(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');

CSVWRITECSVWRITE ( 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', '|');

DATABASEDATABASE()

返回数据库名

例子如下:

CALL DATABASE();

DATABASE_PATHDATABASE_PATH()

返回数据库文件路径和数据库名,如果不是基于文件的数据库,返回NULL。

例子如下:

CALL DATABASE_PATH();

FILE_READFILE_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;

GREATESTGREATEST(aValue, bValue [,...])

返回最大的非空值,如果所有的值为NULL,将返回NULL。

例子如下:

CALL GREATEST(1, 2, 3);

IDENTITYIDENTITY()

返回当前SESSION最后写入的标识符。当一个新的序列号产生时,这个值都将改变,即使是在触发器或是JAVA方法中,详细参见 SCOPE_IDENTITY()。这个方法返回一个长整数。

例子如下:

CALL IDENTITY();

IFNULLIFNULL(aValue, bValue)

如果值为非空返回aValue,否则返回bValue。

例子如下:

CALL IFNULL(NULL, '');

LEASTLEAST(aValue, bValue [,...])

返回非空的最小值,如果所有的值都是NULL,将返回NULL。

例子如下:

CALL LEAST(1, 2, 3);

LOCK_MODELOCK_MODE()

返回当前所模式。参见SET LOCK_MODE。这个方法返回一个整数。

例子如下:

CALL LOCK_MODE();

LOCK_TIMEOUTLOCK_TIMEOUT()

返回当前SESSION的锁超时时间(毫秒数)。

例子如下:

LOCK_TIMEOUT()

LINK_SCHEMALINK_SCHEMA(targetSchemaString, driverString, urlString,
userString, passwordString, sourceSchemaString)

在一个SCHEMA创建所有表的表链接。如果同名的表已经存在,将先删除它们。目标SCHEMA在不存在的情况下将被自动创建。驱动如果已经加载了驱动名可以为空。链接表列表作为结果集被返回。执行这个语句需要管理员权限。

例子如下:

CALL LINK_SCHEMA('TEST2', '', 'jdbc:h2:test2', 'sa', 'sa', 'PUBLIC');

MEMORY_FREEMEMORY_FREE()

返回空闲内存,单位为 KB (1024 字节为一 KB)。这个方法返回一个整数。在返回这个值前,垃圾收集器将被执行。这行这个语句需要管理员权限。

例子如下:

MEMORY_FREE()

MEMORY_USEDMEMORY_USED()

返回已用的内存,单位为 KB (1024 字节为一 KB)。这个方法返回一个整数。在返回这个值前,垃圾收集器将被执行。这行这个语句需要管理员权限。

例子如下:

MEMORY_USED()

NEXTVALNEXTVAL ( [ schemaName, ] sequenceString )

返回序列的下一个值。已经被使用过的值永远也不会再用,即使事务被回滚。如果SCHEMA没有被设置,当前SCHEMA被使用,序列名将被转换为大写(为了兼容性)。这个方法返回一个长整数。

例子如下:

NEXTVAL('TEST_SEQ')

NULLIFNULLIF(aValue, bValue)

如果aValue等于bValue返回NULL,否则返回aValue。

例子如下:

NULLIF(A, B)

READONLYREADONLY()

如果数据库是只读的,返回TRUE。

例子如下:

READONLY()

ROWNUMROWNUM()

返回当前行数,这个方法返回一个整数。这个方法支持SELECT语句、DELETE语句和UPDATE语句。第一行为行号1,行号在结果集分组和排序前被计算。要获得排序和分组之后的行号,需要使用子查询。

例子如下:

SELECT ROWNUM(), * FROM TEST;
SELECT ROWNUM(), * FROM (SELECT * FROM TEST ORDER BY NAME);

SCHEMASCHEMA()

返回这个SESSION的缺省SCHEMA名。

例子如下:

CALL SCHEMA()

SCOPE_IDENTITYSCOPE_IDENTITY()

返回当前SESSION当前作用范围的最后插入的标识符值,在触发器和JAVA方法中的改变将被忽略。参见 IDENTITY()。这个方法返回一个长整数。

例子如下:

CALL SCOPE_IDENTITY();

SESSION_IDSESSION_ID()

返回当前数据库连接的唯一SESSION标识号。这个标识号在连接打开期间一直存在。这个方法返回一个整数。数据库引擎可以重复使用已经关闭的连接的SESSION标识号。

例子如下:

CALL SESSION_ID()

SETSET(@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_IDTRANSACTION_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()

DATEADDDATEADD(unitString, addInt, timestamp)

增加一个单元到时间戳中,使用字符串表示这个单元,使用负数来裁剪单元。同样的单元在 EXTRACT 方法中被支持。这个方法返回一个时间戳。

例子如下:

DATEADD('MONTH', 1, DATE '2001-01-31')

DATEDIFFDATEDIFF(unitString, aTimestamp, bTimestamp)

返回两个时间戳的差值。这个方法返回一个长整数。字符串表示这个单元。同样的单元在 EXTRACT 方法中被支持。

例子如下:

DATEDIFF('YEAR', T1.CREATED, T2.CREATED)

DAYNAMEDAYNAME(date)

返回日期的名称(英语)。

例子如下:

DAYNAME(CREATED)

DAY_OF_MONTHDAY_OF_MONTH(date)

返回月份的第几天 (1-31)。

例子如下:

DAY_OF_MONTH(CREATED)

DAY_OF_WEEKDAY_OF_WEEK(date)

返回星期的第几天 (1 表示星期一).

例子如下:

DAY_OF_WEEK(CREATED)

DAY_OF_YEARDAY_OF_YEAR(date)

返回一年中的第几天 (1-366).

例子如下:

DAY_OF_YEAR(CREATED)

EXTRACTEXTRACT ( { 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)

FORMATDATETIMEFORMATDATETIME ( 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')

HOURHOUR(timestamp)

返回时间戳中的小时数(0-23)。

例子如下:

HOUR(CREATED)

MINUTEMINUTE(timestamp)

返回时间戳中的分钟数(0-59)。

例子如下:

MINUTE(CREATED)

MONTHMONTH(timestamp)

返回时间戳中的月份数(1-12)。

例子如下:

MONTH(CREATED)

MONTHNAMEMONTHNAME(date)

返回指定月的月名(英文)。

例子如下:

MONTHNAME(CREATED)

PARSEDATETIMEPARSEDATETIME(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')

QUARTERQUARTER(timestamp)

返回时间戳的季度数 (1-4) 。

例子如下:

QUARTER(CREATED)

SECONDSECOND(timestamp)

返回时间戳的秒数(0-59)。

例子如下:

SECOND(CREATED)

WEEKWEEK(timestamp)

返回时间戳的星期数(1-53) 。这个方法使用当前系统所在地的时区。

例子如下:

WEEK(CREATED)

YEARYEAR(timestamp)

返回时间戳的年份

例子如下:

YEAR(CREATED)

 

posted on 2015-09-06 13:10  clearriver  阅读(2365)  评论(0编辑  收藏  举报

导航