第二十八章 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函数是相同的。 它们都接受一个流字段参数。 LENGTH和$LENGTH函数不接受流字段参数。

第二十七章 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。

第二十六章 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

      各大技术社区常年充斥着关于字符集支持、乱码的问题。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.999) AS CeilingNum3

第二十三章 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.0 AS BIT) AS Zerodot     

示例

第二十二章 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.570796326794896619

第十八章 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.141592653589793238

第十六章 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.000) AS AbsoluteValue

0

SELECT ABS(-99E4) AS AbsoluteValue

990000

第十五章 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子句指定的逐行窗口相关的任务，并为每一行返回一个值。 这三个子句都是可选的，但是如果指定了，必须按照以下语法中的顺序指定:

window-function() OVER (
                      [ PARTITION BY partfield ]
                      [ ORDER BY orderfield ]
                      [ ROWS framestart ] | [ ROWS BETWEEN framestart AND frameend ]
                      )

第十三章 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。

第十二章 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])

参数

第十一章 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])

参数

[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错误。

第八章 SQL聚合函数 MAX

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

大纲

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

参数

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

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

描述

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

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

MAX不能在WHERE子句中使用。 MAX不能在JOIN的ON子句中使用，除非SELECT是子查询。

第七章 SQL聚合函数 LIST

创建逗号分隔值列表的聚合函数。

大纲

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

参数

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

描述

LIST聚合函数返回指定列中以逗号分隔的值列表。

第六章 SQL聚合函数 JSON_ARRAYAGG

创建JSON格式值数组的聚合函数。

注：IRIS可用，IRIS之前版本不可用。

大纲

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

参数

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

描述

JSON_ARRAYAGG聚合函数返回指定列中值的JSON格式数组。

第五章 SQL聚合函数 %DLIST

创建值列表的聚合函数。

大纲

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

参数

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

描述

%DLIST聚合函数返回一个ObjectScript %List结构，其中包含指定列中的值作为列表元素。

一个简单的%DLIST(或%DLIST ALL)返回列表，该列表由所选行中string-expr的所有非null值组成。 string-expr为NULL的行不会作为元素包含在列表结构中。

第四章 SQL聚合函数 COUNT（二）

权限

要使用COUNT(*)，必须对指定的表具有表级别的SELECT权限。 要使用COUNT(column-name)，必须对指定的列具有列级的SELECT权限，或者对指定的表具有表级的SELECT权限。 可以通过调用%CHECKPRIV命令来确定当前用户是否具有SELECT权限。 可以通过调用$SYSTEM.SQL.Security.CheckPrivilege()方法来确定指定的用户是否具有表级SELECT权限。

性能

为了获得最优的COUNT性能，你应该按照以下方式定义索引:

• 对于COUNT(*)，如果需要，定义位图扩展索引。 这个索引可能是在创建表时自动定义的。
• 对于COUNT(fieldname)，为指定字段定义一个位片索引。 查询计划优化COUNT(fieldname)自动应用默认的排序规则到fieldname。

未提交事务所做的更改

与所有聚合函数一样，COUNT总是返回数据的当前状态，包括未提交的更改，而不管当前事务的隔离级别如何，如下所示:

• COUNT插入和更新的记录的计数，即使这些更改尚未提交并可能回滚。
• COUNT不计算已删除的记录，即使这些删除还没有提交并且可以回滚。

示例

下面的示例返回Sample.Person中的总行数：

SELECT COUNT(*) AS TotalPersons
     FROM Sample.Person

第三章 SQL聚合函数 COUNT（一）

返回表或指定列中的行数的聚合函数。

大纲

COUNT(*)

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

参数

• * - 指定应计算所有行以返回指定表中的总行数。 COUNT(*)不接受其他参数，不能与ALL或DISTINCT关键字一起使用。 COUNT(*)不接受表达式参数，也不使用任何特定列的信息。 COUNT(*)返回指定表或视图中的行数，但不消除重复项。 它分别计数每一行，包括包含NULL值的行。
• ALL - 可选-指定COUNT返回表达式中所有值的计数。 如果没有指定关键字，这是默认值。
• DISTINCT - 可选-一个DISTINCT子句，指定COUNT返回表达式的不同(唯一)值的计数。 不能与流字段一起使用。 DISTINCT可以指定BY(colo -list)子句，其中colo -list可以是单个列名，也可以是用逗号分隔的列名列表。
• expression - 任何有效的表达式。 通常是包含要计算的数据值的列的名称。
• %FOREACH(col-list) - 可选-列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选-应用在HAVING子句中的条件。

COUNT返回BIGINT数据类型。

描述

第二章 SQL聚合函数 AVG

返回指定列值的平均值的聚合函数。

大纲

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

参数

• ALL - 可选-指定AVG返回表达式所有值的平均值。 如果没有指定关键字，则为默认值。
• DISTINCT - 可选 - DISTINCT子句，指定AVG只计算一个值的唯一实例的平均值。 DISTINCT可以指定BY(col-list)子句，其中col-list可以是单个字段，也可以是逗号分隔的字段列表。
• expression - 任何有效的表达式。 通常是包含要取平均值的数据值的列的名称。
• %FOREACH(col-list) - 可选—列名或以逗号分隔的列名列表。
• %AFTERHAVING - 可选 - 应用在HAVING子句中找到的条件。

AVG返回NUMERIC或DOUBLE数据类型。 如果expression是DOUBLE类型，AVG返回DOUBLE; 否则，它返回NUMERIC。

描述

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

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

第一章 聚合函数概述

计算列的所有值并返回单个聚合值的函数。

支持聚合函数

聚合函数执行与单个列中的一个或多个值相关的任务，并返回单个值。 支持的功能有:

• SUM - 返回指定列的值的和。
• AVG - 返回指定列值的平均值。
• COUNT - 返回表中的行数，或指定列中非空值的个数。
• MAX - 返回指定列中使用的最大值。
• MIN - 返回指定列中使用的最小值。
• VARIANCE，VAR_SAMP, VAR_POP - 返回指定列的值的统计方差。
• STDDEV, STDDEV_SAMP, STDDEV_POP - 返回指定列值的统计标准偏差。
• LIST - 以逗号分隔的列表形式返回指定列中使用的所有值。
• %DLIST - 返回指定列中使用的所有值，作为 IRIS列表结构中的元素。
• XMLAGG - 将指定列中使用的所有值作为连接字符串返回。
• JSON_ARRAYAGG - 返回指定列中使用的所有值作为JSON格式数组。

可以使用CREATE aggregate命令定义其他用户定义的聚合函数。

聚合函数忽略为NULL的字段。 例如，LIST和%DLIST不包含指定字段为NULL的行的元素。 COUNT只计算指定字段的非空值。

聚合函数(COUNT除外)不能应用于流字段。 这样做会产生一个SQLCODE -37错误。 可以使用COUNT来计数流字段值，但有一些限制。

第二十章 SQL谓词 %STARTSWITH（二）

首尾空格

在大多数情况下，%STARTSWITH将前导空格视为与任何其他字符相同的字符。 例如，%STARTSWITH ' B'可用于选择只有一个前导空白后跟字母B的字段值。然而，只包含空白的子字符串不能选择前导空白; 它选择非空值。

尾随空格的%STARTSWITH行为取决于数据类型和排序规则类型。 %STARTSWITH忽略定义为SQLUPPER的字符串子串的尾随空格。 %STARTSWITH不会忽略数字、日期或列表子字符串中的尾随空格。

在下面的示例中，%STARTSWITH将结果集限制为以“M”开头的名称。 因为Name是一个SQLUPPER字符串数据类型，子字符串的末尾空格将被忽略:

SELECT Name FROM Sample.Person
WHERE Name %STARTSWITH 'M      '

在下面的示例中，%STARTSWITH从结果集中删除所有行，因为对于数值，子字符串的末尾空格不会被忽略:

SELECT Name,Age FROM Sample.Person
WHERE Age %STARTSWITH '6      '

在下面的示例中，%STARTSWITH从结果集中删除所有行，因为对于列表值，子字符串中的末尾空不会被忽略: