第三十七章 SQL函数 CURRENT_TIMESTAMP

日期/时间函数，返回当前本地日期和时间。

大纲

CURRENT_TIMESTAMP
CURRENT_TIMESTAMP(precision)

参数

• precision - 一个正整数，它将时间精度指定为小数秒的位数。 默认值是0(没有小数秒); 这个默认值是可配置的。

CURRENT_TIMESTAMP返回TIMESTAMP数据类型。

描述

CURRENT_TIMESTAMP要么不接受参数，要么接受精度参数。 不允许使用空参数括号。

CURRENT_TIMESTAMP返回当前时区的本地日期和时间; 它会根据当地的时间变化进行调整，例如日光节约时间。

CURRENT_TIMESTAMP可以返回%timestamp数据类型格式(yyyy-mm-dd hh:mm:ss.ffff)或%PosixTime数据类型格式(编码的64位带符号整数)的时间戳。 以下规则决定返回哪种时间戳格式:

1. 如果将当前时间戳提供给数据类型为%PosixTime的字段，则当前时间戳值将以PosixTime数据类型格式返回。 例如，WHERE PosixField=CURRENT_TIMESTAMP or INSERT INTO MyTable (PosixField) VALUES (CURRENT_TIMESTAMP).

第三十六章 SQL函数 CURRENT_TIME

返回当前本地时间的日期/时间函数。

大纲

CURRENT_TIME
CURRENT_TIME(precision)

参数

• precision - 一个正整数，它将时间精度指定为小数位数。默认值为0(无小数秒)；此默认值是可配置的。

CURRENT_TIME返回时间数据类型。

描述

CURRENT_TIME要么不带参数，要么带精度参数。不允许使用空参数括号。

CURRENT_TIME返回此时区的当前本地时间。它会根据当地时间变化(如夏令时)进行调整。

逻辑模式下的CURRENT_TIME以$HOROLOG格式返回当前本地时间；例如，37065。显示模式下的当前时间以区域设置的默认格式返回当前本地时间；例如，10:18:27。

要更改默认时间格式，请使用带有time_format和time_PRECISION选项的SET OPTION命令。可以配置分数秒的精度，如下所述。

要仅返回当前时间，请使用CURRENT_TIME或CURTIME。这些函数以时间数据类型返回它们的值。CURRENT_TIMESTAMP、GETDATE和NOW函数也可用于将当前日期和时间作为TIMESTAMP数据类型返回。

请注意，除GETUTCDATE之外，所有 SQL时间和日期函数都特定于本地时区设置。

第三十五章 SQL函数 CURRENT_DATE

日期/时间函数，返回当前本地日期。

大纲

CURRENT_DATE

描述

CURRENT_DATE不带任何参数。它将当前本地日期作为数据类型DATE返回。不允许使用参数括号。CURRENT_DATE返回此时区的当前本地日期；它根据本地时间变量(如夏令时)进行调整。

在逻辑模式下CURRENT_DATE以$HOROLOG格式返回当前本地日期; 例如,64701。 显示模式下的CURRENT_DATE以区域设置的默认格式返回当前本地日期。 例如，在美国的区域设置为02/22/2018，在欧洲的区域设置为22/02/2018，在俄罗斯的区域设置为22.02.2018。

要指定不同的日期格式，请使用TO_DATE函数。要更改默认日期格式，请将SET OPTION命令与DATE_FORMAT、Year_OPTION或DATE_SEFACTOR选项配合使用。

要仅返回当前日期，请使用CURRENT_DATE或CURDATE。这些函数以DATE数据类型返回它们的值。CURRENT_TIMESTAMP、GETDATE和NOW函数也可用于将当前日期和时间作为TIMESTAMP数据类型返回。

请注意，除GETUTCDATE之外，所有 SQL时间和日期函数都特定于本地时区设置。

第三十四章 SQL函数 CURDATE

返回当前本地日期的标量日期/时间函数。

大纲

{fn CURDATE()}
{fn CURDATE}

描述

CURDATE不接受任何参数。它将当前本地日期作为数据类型DATE返回。请注意，参数括号是可选的。CURDATE返回此时区的当前本地日期；它根据本地时间变量(如夏令时)进行调整。

逻辑模式下的CURDATE以$HOROLOG格式返回当前本地日期; 例如,64701。 显示模式下的CURDATE以区域设置的默认格式返回当前本地日期。 例如，在美国的区域设置为02/22/2018，在欧洲的区域设置为22/02/2018，在俄罗斯的区域设置为22.02.2018。

要指定不同的日期格式，请使用TO_DATE函数。 要更改默认的日期格式，使用SET OPTION命令和DATE_FORMAT、YEAR_OPTION或DATE_SEPARATOR选项。

要只返回当前日期，请使用CURDATE或CURRENT_DATE。 这些函数返回DATE数据类型的值。 CURRENT_TIMESTAMP、GETDATE和NOW函数也可以作为TIMESTAMP数据类型返回当前日期和时间。

请注意，除了GETUTCDATE之外，所有 SQL时间和日期函数都特定于当地时区设置。

第三十三章 SQL函数 COT

标量数值函数，返回角度的余切值(以弧度为单位)。

大纲

{fn COT(numeric-expression)}

参数

• numeric-expression - 数值表达式。 这是一个用弧度表示的角。

COT返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, COT返回DOUBLE; 否则，返回NUMERIC。

描述

COT接受任何非零数，并以浮点数的形式返回它的余切值。 如果传入NULL值，COT将返回NULL。 数值0(0)会导致运行时错误，生成SQLCODE -400(发生致命错误)。 COT将非数字字符串视为数值0。

COT返回一个精度为36、刻度为18的值。

COT只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

下面的例子展示了COT的效果:

SELECT {fn COT(0.52)} AS Cotangent 

1.746536264145397165

SELECT {fn COT(124.1332)} AS Cotangent 

-0.040311998371146672

第三十二章 SQL函数 COS

标量数值函数，返回一个角的余弦值(以弧度为单位)。

大纲

{fn COS(numeric-expression)}

参数

• numeric-expression - 数值表达式。 这是一个用弧度表示的角。

COS返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, COS返回DOUBLE; 否则，返回NUMERIC。

描述

COS接受任何数值，并以浮点数的形式返回COS。 返回值的范围是-1到1(含1)。 如果传入NULL值，COS将返回NULL。 COS将非数字字符串视为数值0。

COS返回一个精度为19、刻度为18的值。

COS只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

这些例子说明了COS对两个正弦函数的影响。

SELECT {fn COS(0.52)} AS Cosine

0.8678191796776499

SELECT {fn COS(-.31)} AS Cosine 

SELECT {fn COS(-.31)} AS Cosine 

第三十一章 SQL函数 CONVERT

将给定表达式转换为指定数据类型的函数。

CONVERT(datatype,expression[,format-code])

{fn CONVERT(expression,datatype)}

参数

• expression - 要转换的表达式。
• datatype - 要将表达式转换为的数据类型。
• format - 可选-指定日期和时间格式的整数代码，用于在日期/时间/时间戳数据类型和字符数据类型之间进行转换。 此参数仅用于通用标量语法形式。

描述

这里描述了CONVERT函数的两种不同实现。 两者都将一种数据类型中的表达式转换为另一种数据类型中的相应值。 两者都执行日期和时间转换。

注意:这两个CONVERT实现中的参数以不同的顺序表示。 第一个是与MS SQL Server兼容的通用 IRIS标量函数，它接受三个参数。 第二个是带有两个参数的 ODBC标量函数。 下面的文本将分别处理这两种形式的CONVERT。

• CONVERT(datatype,expression)支持流数据的转换。 例如，可以将字符流字段的内容转换为数据类型为VARCHAR的字符串。
• {fn CONVERT(expression,datatype)}不支持流数据的转换; 指定要表达的流字段将导致SQLCODE -37错误。

第三十章 SQL函数 CONCAT

标量字符串函数，它返回作为连接两个字符表达式的结果的字符串。

大纲

{fn CONCAT(string-expression1,string-expression2)}

参数

• string-expression1, string-expression2 - 要连接的字符串表达式。表达式可以是列名、字符串文字、数字或另一个标量函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。

描述

连接两个字符串以返回连接的字符串。可以使用连接运算符(||)执行完全相同的操作。

可以连接数字或数字字符串的任意组合；连接结果是一个数字字符串。SQL在连接之前将数字转换为规范形式(指数被扩展，前导零和尾随零被删除)。在连接之前，数字字符串不会转换为规范形式。

可以将前导空格或尾随空格连接到字符串。将空值连接到字符串会产生空值；这是行业范围内的SQL标准。

字符串函数还可用于将两个或多个表达式连接成单个字符串。

示例

以下示例连接Home_State和Home_City列以创建位置值。使用CONCAT函数和concatenate运算符显示两次连接：

SELECT {fn CONCAT(Home_State,Home_City)} AS LocationFunc,
Home_State||Home_City AS LocationOp
FROM Sample.

第二十九章 SQL函数 COALESCE

返回第一个非空表达式的值的函数。

大纲

COALESCE(expression,expression [,...])

• expression - 要计算的一系列表达式。多个表达式被指定为逗号分隔的列表。此表达式列表限制为140个表达式。

描述

COALESSE函数按从左到右的顺序计算表达式列表，并返回第一个非空表达式的值。如果所有表达式的计算结果都为NULL，则返回NULL。

字符串返回时保持不变；保留前导和尾随空格。数字以规范形式返回，去掉了前导零和尾随零。

返回值的数据类型

非数字表达式(如字符串或日期)必须都属于相同的数据类型，并返回该数据类型的值。指定数据类型不兼容的表达式会导致SQLCODE-378错误，并显示DataType不匹配错误消息。可以使用CAST函数将表达式转换为兼容的数据类型。

数值表达式可以是不同的数据类型。如果指定具有不同数据类型的数值表达式，则返回的数据类型是与所有可能的结果值最兼容的表达式数据类型，即具有最高数据类型优先级的数据类型。

文字值(字符串、数字或NULL)被视为数据类型VARCHAR。如果只指定两个表达式，则文字值与数值表达式兼容：如果第一个表达式是数值表达式，则返回其数据类型；如果第一个表达式是文字值，则返回VARCHAR数据类型。

比较NULL处理函数

下表显示了各种SQL比较函

第二十八章 SQL函数 CHAR_LENGTH

返回表达式中的字符数的函数。

大纲

CHAR_LENGTH(expression)

参数

• expression - 表达式，可以是列名、字符串文字或另一个标量函数的结果。底层数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

CHAR_LENGTH返回整数数据类型。

描述

CHAR_LENGTH返回一个整数值，表示指定表达式中的字符数，而不是字节数。表达式可以是字符串，也可以是任何其他数据类型，如数字或数据流字段。返回的整数计数包括前导和尾随空格以及字符串终止字符。如果传递NULL值，则CHARACTER_LENGTH返回NULL，如果传递空字符串(‘’)值，则返回0。

在计算字符之前，会将数字解析为规范形式；不会解析带引号的数字字符串。在下面的示例中，第一个CHAR_LENGTH返回1(因为数字分析删除了前导和尾随零)，第二个CHAR_LENGTH返回8。

SELECT CHAR_LENGTH(007.0000) AS NumLen,
       CHAR_LENGTH('007.0000') AS NumStringLen
       
1   8

注意：CHAR_LENGTH、CHARACTER_LENGTH和DATALENGTH函数是相同的。 它们都接受一个流字段参数。

第二十七章 SQL函数 CHARINDEX

一个字符串函数，它返回子字符串在字符串中的位置，具有可选的搜索起点。

大纲

CHARINDEX(substring,string[,start])

参数

• substring - 要在字符串中匹配的子字符串。
• string - 作为子字符串搜索目标的字符串表达式。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从0或1开始。 负数、空字符串、NULL或非数字值被视为0。

CHARINDEX返回INTEGER数据类型。

描述

CHARINDEX在字符串中搜索子字符串。 如果找到匹配，则返回第一个匹配子字符串的起始位置，从1开始计算。 如果不能找到子字符串，CHARINDEX返回0。

空字符串是一个字符串值。 因此，可以将空字符串用于任意一个字符串参数值。 start参数将空字符串值视为0。 但是，请注意ObjectScript空字符串作为NULL传递给 SQL。

NULL不是SQL中的字符串值。 因此，为任何一个CHARINDEX字符串参数指定NULL都会返回NULL。

CHARINDEX不能将%Stream.GlobalCharacter字段用于字符串或子字符串参数。尝试这样做会生成SQLCODE-37错误。可以使用SUBSTRING函数获取%Stream.

第二十六章 SQL函数 CHARACTER_LENGTH

返回表达式中的字符数的函数。

大纲

CHARACTER_LENGTH(expression)

参数

• expression - 表达式，可以是列名、字符串文字或另一个标量函数的结果。底层数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

CHARACTER_LENGTH返回整数数据类型。

描述

CHARACTER_LENGTH返回一个整数值，表示指定表达式中的字符数，而不是字节数。表达式可以是字符串，也可以是任何其他数据类型，如数字或数据流字段。返回的整数计数包括前导和尾随空格以及字符串终止字符。如果传递NULL值，则CHARACTER_LENGTH返回NULL，如果传递空字符串(‘’)值，则返回0。

在计算字符之前，会将数字解析为规范形式；不会解析带引号的数字字符串。在下面的示例中，第一个CHARACTER_LENGTH返回1(因为数字分析删除了前导和尾随零)，第二个CHARACTER_LENGTH返回8。

SELECT CHARACTER_LENGTH(007.0000) AS NumLen,
       CHARACTER_LENGTH('007.0000') AS NumStringLen

注意:CHARACTER_LENGTH、CHAR_LENGTH和DATALENGTH函数是相同的。

      各大技术社区常年充斥着关于字符集支持、乱码的问题。Cache’/Ensemble/HealthConnect/IRIS的用户也经常遇到这类问题。为何文字乱码在信息化发展这么久后还会困扰我们？因为字符集、多语言实在有点复杂。

      我计划写三篇：第一篇花点时间回顾一下多语言字符集的简史，第二篇介绍一下各种技术对于字符集和字符编码的使用声明，最后一篇会介绍常见的ISC技术和工具的乱码、尤其是中文乱码的现象和解决办法。

第二十五章 SQL函数 CHAR

返回具有在字符串表达式中指定的ASCII代码值的字符的字符串函数。

大纲

CHAR(code-value)

{fn CHAR(code-value)}

参数

• code-value - 与字符相对应的整数代码。

描述

Char返回与指定的整数代码值对应的字符。因为 IRIS是UNICODE系统，所以可以为任何UNICODE字符指定整数代码，从0到65535。如果code-value是超出允许值范围的整数，则CHAR返回NULL。

如果代码值是非数字字符串，则CHAR返回一个空字符串（''）。如果传递空值，CHAR返回NULL。

请注意，CHAR可以用作ODBC标量函数(使用花括号语法)，也可以用作SQL常规函数。

示例

以下示例均返回字符Z：

SELECT CHAR(90) AS CharCode

Z

SELECT {fn CHAR(90)} AS CharCode

Z

下面的示例返回希腊字母lambda：

ClassMethod Cast2()
{
	&sql(SELECT {fn CHAR(955)}
	   INTO :greeklet)
	w !,"Greek letter: ",greeklet
}

DHC-APP> d ##class(PHA.TEST.SQLCommand).Cast2()
 
Greek letter: λ

第二十四章 SQL函数 CEILING

数值函数，返回大于或等于给定数值表达式的最小整数。

大纲

CEILING(numeric-expression)

{fn CEILING(numeric-expression)}

参数

• numeric-expression - 要计算其上限的数字。

CELING返回与NUMERIC-EXPRESSION相同的数据类型。

描述

CELING返回大于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为NULL值、空字符串(‘’)或任何非数字字符串时，CELING返回NULL。

请注意，CELING可以作为ODBC标量函数(使用花括号语法)调用，也可以作为SQL常规函数调用。

也可以使用Ceuling()方法调用从ObjectScript调用此函数：

$SYSTEM.SQL.Functions.EILING(numeric-expression)

示例

以下示例显示了CEILING 如何将分数转换为其CEILING 整数：

SELECT CEILING(167.111) AS CeilingNum1,
       CEILING(167.456) AS CeilingNum2,
       CEILING(167.

第二十三章 SQL函数 CAST（二）

转换位值

可以将expr值转换为BIT以返回0或1。 如果expr为1或任何其他非零数值，则返回1。 如果expr为“TRUE”、“TRUE”或“TRUE”，则返回1。 (“True”可以用任何大小写组合表示，但不能缩写为“T”。) 如果expr是任何其他非数值值，则返回0。 如果expr为0，则返回0。

在下面的例子中，前5个CAST操作返回1，后5个CAST操作返回0:

SELECT CAST(1 AS BIT) AS One, 
       CAST(7 AS BIT) AS Num,      
       CAST(743.6 AS BIT) AS Frac,  
       CAST(0.3 AS BIT) AS Zerofrac,
       CAST('tRuE' AS BIT) AS TrueWord,
       CAST(0 AS BIT) AS Zero,  
       CAST('FALSE' AS BIT) AS FalseWord, 
       CAST('T' AS BIT) AS T,    
       CAST('F' AS BIT) AS F,   
       CAST(0.

第二十二章 SQL函数 CAST（一）

将给定表达式转换为指定数据类型的函数。

第二十一章 SQL函数 ATAN2

接受两个坐标并返回以弧度为单位的反正切角的标量数值函数。

注意：IRIS可用，IRIS以下不可用。

大纲

{fn ATAN2(y,x)}

参数

• y - 指定y轴坐标的数值表达式。
• x - 指定x轴坐标的数值表达式。

ATAN2返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, ATAN2返回DOUBLE; 否则，返回NUMERIC。

描述

ATAN2采用射线(y,x)的笛卡尔坐标，并以浮点数的形式返回角的正切反(弧)。 用两个坐标的符号来确定笛卡尔坐标。 当x为正值时，ATAN2返回与ATAN(y/x)相同的值。 如果传递一个NULL值，ATAN2将返回NULL。 ATAN2将非数字字符串(包括空字符串("))视为数字值0。

ATAN2返回一个精度为36、刻度为18的值。

ATAN2只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

下面的例子调用ATAN2:

SELECT {fn ATAN2(15,30)} AS ArcTangent 

0.463647609000806116

第二十章 SQL函数 ATAN

一个标量数值函数，返回角的正切的弧切值(以弧度为单位)。

大纲

{fn ATAN(numeric-expression)}

参数

• numeric-expression - 一个数值表达式。 这是这个角的正切。

ATAN返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, ATAN返回DOUBLE; 否则，返回NUMERIC。

描述

ATAN接受任何数值，并以浮点数返回角度正切的反(弧)值。 如果传递一个NULL值，ATAN将返回NULL。 ATAN将非数字字符串(包括空字符串("))视为数字值0。

ATAN返回一个精度为36、刻度为18的值。

ATAN只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

下面的例子展示了ATAN的效果:

SELECT {fn ATAN(0.52)} AS ArcTangent 

0.479519291992596165

第十九章 SQL函数 ASIN

一个标量数值函数，返回角的正弦的反正弦(以弧度为单位)。

大纲

{fn ASIN(numeric-expression)}

参数

• numeric-expression - 数值在-1到1之间的数值表达式。 这是这个角的正弦值。

ASIN返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, ASIN返回DOUBLE; 否则，返回NUMERIC。

描述

ASIN以浮点数的形式返回角度正弦的反(弧)值。 numeric-expression的值必须是有符号的十进制数，取值范围为1 ~ -1(含1)。 超出此范围的数字将导致运行时错误，生成SQLCODE -400(发生致命错误)。 如果传递一个NULL值，ASIN将返回NULL。 ASIN将非数字字符串(包括空字符串("))视为数字值0。

ASIN返回一个精度为19、刻度为18的值。

ASIN只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

下面的例子展示了ASIN对两个正弦的影响。

SELECT {fn ASIN(0.52)} AS ArcSine 

0.54685095069594411

SELECT {fn ASIN(-1.00)} AS ArcSine 

-1.

第十八章 SQL函数 ASCII

一个字符串函数，返回字符串表达式的第一个(最左边)字符的整型ASCII码值。

大纲

ASCII(string-expression)

{fn ASCII(string-expression)}

参数

• string-expression - 字符串表达式，它可以是列的名称、字符串字面值或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。 CHAR或VARCHAR类型的字符串表达式。

描述

如果传入一个NULL或空字符串值，ASCII将返回NULL。 空字符串返回NULL与SQL Server一致。

SELECT ASCII('Z') AS AsciiCode

90

SELECT {fn ASCII('ZEBRA')} AS AsciiCode 

90

在执行ASCII转换之前，SQL将数字转换为规范形式。 下面的例子返回55，它是数字7的ASCII值:

SELECT ASCII(+007) AS AsciiCode

55

如果数字以字符串的形式表示，则不执行此数字解析。 下面的例子返回43，它是加(+)字符的ASCII值:

SELECT ASCII('+007') AS AsciiCode 

43

第十七章 SQL函数 ACOS

一个标量数值函数，返回给定余弦的弧余弦(以弧度为单位)。

大纲

{fn ACOS(numeric-expression)}

参数

• numeric-expression - 数值在-1到1之间的数值表达式。 这是这个角的余弦值。

ACOS返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, ACOS返回DOUBLE; 否则，返回NUMERIC。

描述

ACOS接受一个数值并以浮点数的形式返回余弦的反(弧)值。 numeric-expression的值必须是有符号的十进制数，取值范围为1 ~ -1(含1)。 超出此范围的数字将导致运行时错误，生成SQLCODE -400(发生致命错误)。 如果传入NULL值，ACOS将返回NULL。 ACOS将非数字字符串(包括空字符串("))视为数字值0。

ACOS返回一个精度为19、刻度为18的值。

ACOS只能用作ODBC标量函数(使用花括号语法)。

可以使用DEGREES函数将弧度转换为角度。 可以使用RADIANS函数来转换角度到弧度。

示例

下面的例子展示了ACOS对两个余弦的影响:

SELECT {fn ACOS(0.52)} AS ArcCosine 

1.02394537609895251

SELECT {fn ACOS(-1)} AS ArcCosine

3.

第十六章 SQL函数 ABS

返回数值表达式的绝对值的数值函数。

大纲

ABS(numeric-expression)

{fn ABS(numeric-expression)}

参数

• numeric-expression - 要返回其绝对值的数字。

ABS返回与数字表达式相同的数据类型。

描述

ABS返回绝对值，它总是0或正数。 如果数值表达式不是一个数字(例如，字符串'abc'，或空字符串'')，ABS返回0。 当传递null值时，ABS返回<null>。

请注意，ABS可以用作ODBC标量函数(带有花括号语法)，也可以用作SQL通用函数。

这个函数也可以通过调用ABS()方法从ObjectScript中调用:

  WRITE $SYSTEM.SQL.Functions.ABS(-0099)

示例

下面的例子展示了ABS的两种形式:

SELECT ABS(-99) AS AbsGen,{fn ABS(-99)} AS AbsODBC

下面的例子展示了ABS如何处理其他一些数字。 在调用ABS之前， SQL将数字表达式转换为规范形式，删除前导和末尾的零，并计算指数。

SELECT ABS(007) AS AbsoluteValue

7

SELECT ABS(-0.

第十五章 SQL窗口函数概述（二）

ROW子句

ROW子句可以与FIRST_VALUE(字段)和SUM(字段)窗口函数一起使用。 可以为其他windows函数指定它，但不执行任何操作(有或没有ROWS子句的结果相同)。

ROWS子句有两种语法形式:

ROWS framestart
ROWS BETWEEN framestart AND frameend

Framestart和frameend有五个可能的值:

UNBOUNDED PRECEDING                    /* 从当前分区的开头开始 */
offset PRECEDING   /* 开始偏移当前行之前的行数 */
CURRENT ROW                                      /* 从当前行开始 */
offset FOLLOWING  /* 继续偏移当前行后面的行数 */
UNBOUNDED FOLLOWING                  /* 继续到当前分区的末尾 */

ROWS子句语法可以在两个方向上指定一个范围。 例如，在无界前面和1后面之间的行以及在1后面和无界前面之间的行是完全相等的。

ROWS框架的开始语法默认为CURRENT ROW作为范围的第二个未指定的边界。

第十四章 SQL窗口函数概述（一）

指定用于计算聚合和排名的每行“窗口框架”的函数。

窗口函数和聚合函数

在应用WHERE、GROUP by和HAVING子句之后，窗口函数对SELECT查询选择的行进行操作。

窗口函数将一组行中的一个(或多个)字段的值组合在一起，并在结果集中为生成的列中的每一行返回一个值。

虽然窗口函数与聚合函数类似，因为它们将多行结果组合在一起，但它们与聚合函数的不同之处在于，它们本身并不组合行。

窗函数的语法

窗口函数被指定为SELECT查询中的选择项。 窗口函数也可以在SELECT查询的ORDER BY子句中指定。

窗口函数执行与由PARTITION by子句、ORDER by子句和ROWS子句指定的逐行窗口相关的任务，并为每一行返回一个值。

第十三章 SQL聚合函数 XMLAGG

一个聚合函数，它创建一个串接的值字符串。

大纲

XMLAGG([ALL | DISTINCT [BY(col-list)]] string-expr [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-指定XMLAGG返回string-expr的所有值的连接字符串。 如果没有指定关键字，这是默认值。
• DISTINCT - 可选-一个DISTINCT子句，指定XMLAGG返回一个只包含唯一string-expr值的连接字符串。 DISTINCT可以指定BY(colo -list)子句，其中colo -list可以是单个字段，也可以是用逗号分隔的字段列表。
• string-expr - 计算结果为字符串的SQL表达式。 通常，这是要从其中检索数据的列的名称。
• %FOREACH(col-list) - 可选-列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用在HAVING子句中的条件。

描述

XMLAGG聚合函数返回由string-expr中的所有值组成的串接字符串。 返回值的数据类型为VARCHAR，默认长度为4096。

• 一个简单的XMLAGG(或XMLAGG ALL)返回一个字符串，该字符串包含一个由所选行中string-expr的所有值组成的连接字符串。

第十二章 SQL聚合函数 VARIANCE, VAR_SAMP, VAR_POP

返回数据集统计方差的聚合函数。

大纲

VARIANCE([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

VAR_SAMP([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

VAR_POP([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-指定统计方差函数返回表达式中所有值的方差。 如果没有指定关键字，这是默认值。
• DISTINCT - 可选- DISTINCT子句，指定统计方差函数返回不同(唯一)表达式值的方差。 DISTINCT可以指定BY(colo -list)子句，其中colo -list可以是单个字段，也可以是用逗号分隔的字段列表。
• expression - 任何有效的表达式。 通常是包含要分析方差的数据值的列的名称。
• %FOREACH(col-list) - 可选-列名或以逗号分隔的列名列表。

第十一章 SQL聚合函数 SUM

返回指定列值之和的聚合函数。

大纲

SUM([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-指定SUM返回表达式中所有值的和。 如果没有指定关键字，这是默认值。
• DISTINCT - 可选-一个DISTINCT子句，指定SUM返回表达式中不同(唯一)值的和。 DISTINCT可以指定BY(colo -list)子句，其中colo -list可以是单个字段，也可以是用逗号分隔的字段列表。
• expression - 任何有效的表达式。 通常是包含要求和的数据值的列的名称。
• %FOREACH(col-list) - 可选-列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用在HAVING子句中的条件。

SUM返回与expression相同的数据类型，但有如下异常:TINYINT、SMALLINT和INTEGER返回的数据类型都是INTEGER。

注意:SUM可以指定为聚合函数，也可以指定为窗口函数。 本参考页面描述了SUM作为聚合函数的使用。 SUM作为一个窗口函数在窗口函数概述中描述。

描述

SUM聚合函数返回表达式值的和。 通常，表达式是查询返回的多行中字段的名称(或包含一个或多个字段名称的表达式)。

第十章 SQL聚合函数 STDDEV, STDDEV_SAMP, STDDEV_POP

返回数据集的统计标准差的聚合函数。

大纲

STDDEV([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

STDDEV_SAMP([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

STDDEV_POP([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-指定标准偏差函数返回表达式的所有值的标准偏差。如果未指定关键字，则这是默认值。
• DISTINCT - 可选-指定标准偏差函数返回不同(唯一)表达式值的标准偏差的DISTINCT子句。DISTINCT可以指定BY(COL-LIST)子句，其中COL-LIST可以是单个字段，也可以是逗号分隔的字段列表。
• expression - 任何有效的表达式。通常是包含要分析标准偏差的数据值的列的名称。
• %FOREACH(col-list) - 可选-列名或逗号分隔的列名列表。

[toc]

第九章 SQL聚合函数 MIN

返回指定列中的最小数据值的聚合函数。

大纲

MIN([ALL | DISTINCT [BY(col-list)]] expression [%FOREACH(col-list)] [%AFTERHAVING])

参数

• ALL - 可选-将聚合函数应用于所有值。ALL对MIN返回的值没有影响。提供它是为了与SQL-92兼容。
• DISTINCT - 可选-指定考虑每个唯一值。DISTINCT对MIN返回的值没有影响。它是为SQL-92兼容性提供的。
• expression - 任何有效的表达式。通常是包含要从中返回最小值的值的列的名称。
• %FOREACH(col-list) - 可选-列名或逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用HAVING子句中的条件。

MIN返回与表达式相同的数据类型。

描述

MIN聚合函数返回表达式的最小值(最小值)。通常，表达式是查询返回的多行中的字段名称(或包含一个或多个字段名称的表达式)。

MIN可以在引用表或视图的SELECT查询或子查询中使用。MIN可以出现在选择列表或HAVING子句中，与普通字段值一起出现。

MIN不能在WHERE子句中使用。除非SELECT是子查询，否则不能在联接的ON子句中使用MIN。

与大多数其他聚合函数一样，min不能应用于流字段。尝试这样做会生成SQLCODE-37错误。