第七章 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聚合函数返回指定列中以逗号分隔的值列表。

一个简单的LIST(或LIST ALL)返回一个字符串，其中包含一个逗号分隔的列表，该列表由所选行中string-expr的所有值组成。 其中string-expr为空字符串(")的行由逗号分隔列表中的占位符逗号表示。 string-expr为NULL的行不包含在逗号分隔的列表中。

第六章 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格式数组。

一个简单的JSON_ARRAYAGG(或JSON_ARRAYAGG ALL)返回一个JSON数组，其中包含所选行中string-expr的所有值。

第五章 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.

第三章 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从结果集中删除所有行，因为对于列表值，子字符串中的末尾空不会被忽略:

SELECT Name,FavoriteColors FROM Sample.

第十九章 SQL谓词 %STARTSWITH（一）

用指定初始字符的子字符串匹配值。

大纲

scalar-expression %STARTSWITH substring

参数

• scalar-expression - 将其值与子字符串进行比较的标量表达式(最常见的是数据列)。
• substring - 解析为包含与标量表达式中的值匹配的第一个或多个字符的字符串或数字的表达式。

描述

%STARTSWITH谓词允许选择以子字符串中指定的字符开头的数据值。 如果substring不匹配任何标量表达式值，%STARTSWITH返回空字符串。 无论显示模式如何，这个匹配总是在逻辑(内部存储)数据值上执行。

下面的示例选择所有以“M”开头的名称:

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

可以用NOT来颠倒谓词的意思。 下面的示例选择除了以“M”开头的名称以外的所有名称:

SELECT Name FROM Sample.MyTest WHERE NOT Name %STARTSWITH 'M'

排序类型

%STARTSWITH使用与它匹配的字段相同的排序规则类型。 默认情况下，字符串数据类型字段是用SQLUPPER排序规则定义的，它不区分大小写。

第十八章 SQL谓词 SOME

将值与子查询中的至少一个匹配值匹配。

大纲

scalar-expression comparison-operator SOME (subquery)

参数

• scalar-expression - 将其值与子查询生成的结果集进行比较的标量表达式(最常见的是数据列)。
• comparison-operator - 以下比较操作符之一:=(等于)，<>或!=(不等于)，<(小于)，<=(小于或等于)，>(大于)，>=(大于或等于)，[(包含)，或](跟随)。
• subquery - 一个用括号括起来的子查询，它返回一个用于与标量表达式比较的结果集。

描述

SOME关键字与比较操作符一起创建谓词(量化比较条件)，如果标量表达式的值与子查询检索到的一个或多个对应值匹配，则该谓词为真。 SOME谓词将单个标量表达式项与单个子查询SELECT项进行比较。 具有多个选择项的子查询将生成SQLCODE -10错误。

注意:SOME和ANY关键字是同义词。

示例

下面的例子选择了居住在密西西比河以西任何一个州的工资超过75,000美元的员工:

SELECT Name,Salary,Home_State FROM Sample.Employee
WHERE Salary > 75000
AND Home_State = SOME
 (SELECT State FROM Sample.

第十七章 SQL谓词 %PATTERN

用包含字面值、通配符和字符类型代码的模式字符串匹配值。

大纲

scalar-expression %PATTERN pattern

参数

• scalar-expression - 一个标量表达式(最常见的是数据列)，它的值正在与模式进行比较。
• pattern - 一个带引号的字符串，表示要与标量表达式中的每个值匹配的字符模式。 模式字符串可以包含双引号括起来的文字字符、指定字符类型的字母代码以及数字和作为通配符的句点(.)字符。

描述

%PATTERN谓词允许将字符类型代码和字面值的模式匹配到由标量表达式提供的数据值。 如果模式匹配完整的标量表达式值，则返回该值。 如果pattern没有完全匹配任何标量表达式值，%pattern将返回空字符串。

%PATTERN使用与ObjectScript模式匹配操作符相同的模式代码(? 操作符)。 模式由一对或多对重复计数和一个值组成。 重复计数可以是整数，句点(.)表示“任意数量的字符”，或者使用句点和整数的组合指定的范围。 值可以是字符类型代码字母或字符串字面值(在引号中指定)。

请注意，一个模式通常由多个重复/值对组成，因为该模式必须与整个数据值完全匹配。因此，许多模式都以“.E”对结尾，这意味着数据值的其余部分可以由任意数量的任意类型的字符组成。

第十六章 SQL谓词 %MATCHES

用包含字面值、通配符和范围的模式字符串匹配值。

大纲

scalar-expression %MATCHES pattern [ESCAPE char]

参数

• scalar-expression - 一个标量表达式(最常见的是数据列)，它的值正在与模式进行比较。
• pattern - 一个带引号的字符串，表示要与标量表达式中的每个值匹配的字符模式。 模式字符串可以包含文字字符，问号(?)和星号(*)通配符，方括号用于指定允许的值，反斜杠(\)用于指定紧跟其后的字符被视为文字。 模式也可以是空字符串或NULL，尽管它不匹配或返回NULL项。
• ESCAPE char - 可选-包含单个字符的字符串。 这个字符字符可以在模式中用于指定紧跟在它后面的字符将被视为文字。 如果未指定，默认转义字符是反斜杠(\)。

描述

%MATCHES谓词是 IRIS扩展，用于将值匹配到模式字符串。 %MATCHES返回True或False用于匹配操作。 模式字符串可以由字面量字符、通配符字符和匹配字面量的列表或范围组成。

模式匹配区分大小写。 模式匹配基于标量表达式的EXACT值，而不是它的排序规则值。 因此，%MATCHES操作始终是大小写敏感的，即使标量表达式的排序规则类型不区分大小写。

%MATCHES支持以下模式通配符:

• ? - 匹配任意类型的任意单个字符。

第十五章 SQL谓词 LIKE

用包含字面值和通配符的模式字符串匹配值。

大纲

scalar-expression LIKE pattern [ESCAPE char]

参数

• scalar-expression - 一个标量表达式(最常见的是数据列)，它的值正在与模式进行比较。
• pattern - 一个带引号的字符串，表示要与标量表达式中的每个值匹配的字符模式。 模式字符串可以包含字面字符、下划线(_)和百分比(%)通配符。
• ESCAPE char 可选-包含单个字符的字符串。 这个字符字符可以在模式中用于指定紧跟在它后面的字符将被视为文字。

描述

LIKE谓词允许选择那些匹配模式中指定的字符的数据值。 模式可以包含通配符。 如果pattern不匹配任何标量表达式值，LIKE返回空字符串。

LIKE可以在任何可以指定谓词条件的地方使用，如本手册的谓词概述页面所述。

LIKE谓词支持以下通配符:

• _ - 任何单个字符
• % - 由0个或多个字符组成的序列。 (根据SQL标准，NULL不被认为是一个0字符的序列，因此不被这个通配符选中。)

在动态SQL或嵌入式SQL中，模式可以将通配符和输入参数或输入主机变量表示为连接的字符串，如示例部分所示。

注意:当在运行时提供谓词值时(使用?

第十四章 SQL谓词 IS NULL

确定一个数据值是否为NULL。

大纲

scalar-expression IS [NOT] NULL

描述

IS NULL谓词检测未定义的值。 可以检测到所有空值，或所有非空值:

SELECT Name, FavoriteColors FROM Sample.Person
WHERE FavoriteColors IS NULL 

SELECT Name, FavoriteColors FROM Sample.Person
WHERE FavoriteColors IS NOT NULL

IS NULL / IS NOT NULL谓词是少数几个可以在WHERE子句中用于流字段的谓词之一。 如下面的例子所示:

SELECT Title,%OBJECT(Picture) AS PhotoOref FROM Sample.Employee
WHERE Picture IS NOT NULL

不应将IS NULL谓词与SQL ISNULL函数混淆。

    您可能已经听说，我们目前正在为所有正在使用 Caché 和 Ensemble 的客户提供限时免费迁移到我们的下一代数据平台 InterSystems IRIS 的机会。

    虽然我们依旧如往常一样全力支持那些正在使用 Caché 数据库和 Ensemble 集成引擎的客户，但我们还是认为 InterSystems IRIS 是未来的关键。它结合了 Caché 和 Ensemble 的所有功能，并添加了大量令人兴奋的强大功能，从机器学习到原生 Python。

    这也正是我们为现有客户提供迁移到 InterSystems IRIS 并使用这些新功能的原因。 我们也通过就地迁移支持轻松迁移，这意味着无需数据库转换、分步迁移指南、教程等。

    听起来挺有趣对吗？ 以下是我针对当前 Caché 和 Ensemble 应迁移到 InterSystems IRIS 的五个主要原因。

第十三章 SQL谓词 IS JSON

确定数据值是否为JSON格式。

注意：IRIS版本可用。其他不行。

大纲

scalar-expression IS [NOT] JSON [keyword]

参数

• scalar-expression - 正在检查JSON格式的标量表达式。
• keyword - 可选—可选值、标量、数组或对象。 默认为VALUE。

描述

IS JSON谓词确定数据值是否为JSON格式。 下面的示例确定谓词是否是格式化正确的JSON字符串，是JSON对象还是JSON数组:

ClassMethod IsJson()
{
	s q1 = "SELECT TOP 5 Name FROM Sample.Person "
	s q2 = "WHERE '{""name"":""Fred"",""spouse"":""Wilma""}' IS JSON"
	s myquery = q1_q2
	s tStatement = ##class(%SQL.Statement).%New()
	s qStatus = tStatement.%Prepare(myquery)
	if qStatus'=1 {
		w "%Prepare failed:" 
		d $System.Status.DisplayError(qStatus) 
		q
	}
	s rset = tStatement.

第十二章 SQL谓词 %INSET

将一个值匹配到一组生成的值。

大纲

scalar-expression %INSET valueset [SIZE ((nn))]

参数

• scalar-expression - 一个标量表达式(最常见的是表的RowId字段)，它的值正在与值集进行比较。
• valueset - 对实现ContainsItem()方法的用户定义对象的对象引用(oref)。 该方法接受一组数据值，并在与标量表达式中的值匹配时返回一个布尔值。
• SIZE ((nn)) - 可选-用于查询优化的数量级整数(10、100、1000等)。

描述

%INSET谓词允许通过选择与值集中指定的值相匹配的数据值来筛选结果集。 当标量表达式的值与valueset中的值匹配时，此匹配将成功。 如果值集值不匹配任何标量表达式值，%INSET返回空字符串。 无论显示模式如何，这个匹配总是在逻辑(内部存储)数据值上执行。

对于NULL值，%INSET永远不为真。 因此，它不会将标量表达式中的NULL与值集中的NULL相匹配。

与其他比较条件一样，%INSET用于SELECT语句的WHERE子句或HAVING子句中。

%INSET启用使用抽象的、编程指定的匹配值集过滤字段值。 具体地说，它使用抽象的、编程指定的临时文件或位图索引来过滤RowId字段值，其中的值集行为类似于位图索引或常规索引的最低下标层。

第十一章 SQL谓词 %INLIST

将一个值匹配到%List结构化列表中的元素。

大纲

scalar-expression %INLIST list [SIZE ((nn))]

参数

• scalar-expression - 将其值与列表元素进行比较的标量表达式(最常见的是数据列)。
• list - 包含一个或多个元素的%List结构。
• SIZE ((nn)) - 可选-指定列表中元素数量估计值的整数。 必须指定为具有下列值之一的字面值:10、100、1000、10000，等等。

描述

%INLIST谓词是 IRIS扩展，用于将字段的值与列表结构的元素匹配。 %INLIST和IN都允对多个指定值执行这样的相等比较。 %INLIST将这些多个值指定为单个列表参数的元素。 因此，%INLIST允许改变要匹配的值的数量，而无需创建单独的缓存查询。

可选的%INLIST SIZE子句提供整数nn，它指定list中列表元素数量的数量级估计数。 IRIS使用这个数量级估计来确定最佳查询计划。 因为不管列表中元素的数量是多少，都会使用相同的缓存查询，所以指定SIZE允许创建缓存查询，针对列表中预期的元素的大致数量进行优化。 更改SIZE字面值将创建一个单独的缓存查询。 指定nn为以下文字之一:10、100、1000、10000，等等。

第十章 SQL谓词 IN

将值匹配到以逗号分隔的非结构化列表中的项。

大纲

scalar-expression IN (item1,item2[,...])

scalar-expression IN (subquery)

参数

• scalar-expression - 标量表达式(最常见的是数据列)，将其值与以逗号分隔的值列表或子查询生成的结果集进行比较。
• item - 一个或多个文本值、输入主机变量或解析为文本值的表达式。 以任何顺序列出，以逗号分隔。
• subquery - 一个用括号括起来的子查询，它从单个列返回一个结果集，用于与标量表达式进行比较。

描述

IN谓词用于将值匹配到非结构化的项系列。 通常，它将列数据值与以逗号分隔的值列表进行比较。 IN可以执行相等比较和子查询比较。

与大多数谓词一样，可以使用NOT逻辑操作符反转IN。 IN和NOT IN都不能用于返回空字段。 返回NULL字段使用IS NULL。

可以在任何可以指定谓词条件的地方使用IN，如本手册的谓词概述页面所述。

相等测试

IN谓词可以用作多个相等比较的简写，这些比较用OR操作符连接在一起。 例如:

SELECT Name, Home_State FROM

第九章 SQL谓词 FOR SOME %ELEMENT

将列表元素值或列表元素的数量与谓词匹配。

大纲

FOR SOME %ELEMENT(field) [[AS] e-alias] (predicate)

参数

• field - 将其元素与谓词进行比较的标量表达式(最常见的是数据列)。
• AS e-alias - 可选-用于限定谓词中的%KEY或%VALUE的元素别名。通常，当谓词包含嵌套的FOR某些%ELEMENT条件时，会使用此别名。别名必须是有效的标识符。
• (predicate) - 用括号括起来的谓词条件。 在这个条件中，使用%VALUE和/或%KEY来确定条件匹配的是什么。 %VALUE匹配元素值(%VALUE= ' Red ')。 %KEY匹配元素的最小数目(%KEY=2)。 在此条件下，如果您指定了e-alias， %VALUE和%KEY可能是可选限定的。 这个谓词可以由多个带有AND和OR逻辑运算符的条件表达式组成。

描述

FOR SOME %ELEMENT谓词将字段中的列表元素与指定的谓词匹配。 SOME关键字指定字段中至少有一个元素必须满足指定的谓词子句。

谓词子句必须包含%VALUE或%KEY关键字，后跟谓词条件。 这些关键字不区分大小写。

下面的例子解释了%VALUE和%KEY的用法:

• (%VALUE=’Red’) 匹配所有包含值Red作为其列表元素之一的字段值。

我想与您分享一些在 Caché 中同样存在但几乎不为人知且大多未使用的存储功能。 它们当然可以在 IRIS 中使用，并且在大型分布式存储架构中变得越来越重要。

第八章 SQL谓词 FOR SOME

确定是否根据字段值的条件测试返回记录。

大纲

FOR SOME (table [AS t-alias]) (fieldcondition)

参数

• table - Table可以是单个表，也可以是用逗号分隔的表列表。 括号是必须的。

• AS t-alias - 可选-前一个表名的别名。 别名必须是有效的标识符; 它可以是一个分隔符。

• fieldcondition - fieldcondition 指定一个或多个引用一个或多个字段的条件表达式。 字段条件用括号括起来。 可以使用AND(&)和OR(!)逻辑操作符在字段条件中指定多个条件表达式。

描述

FOR SOME谓词允许根据表中一个或多个字段值的布尔条件测试来决定是否返回记录。 如果fieldcondition计算结果为true，则返回记录。 如果fieldcondition计算结果为false，则不返回记录。

对于表(及其可选的t-alias)参数，必须使用括号分隔。 分隔括号对于字段条件参数也是强制性的。 允许(但不是必需的)在这两组括号之间使用空格。

通常，FOR SOME用于确定是否根据另一个表中一条记录的内容从一个表返回一条记录。 FOR SOME还可用于确定是否根据同一表中记录的内容从表中返回记录。 在后一种情况下，要么返回所有记录，要么不返回任何记录。

第七章 SQL谓词 %FIND

使用位图块迭代将一个值匹配到一组生成的值。

大纲

scalar-expression %FIND valueset [SIZE ((nn))]

参数

• scalar-expression - 一个标量表达式(最常见的是表的RowId字段)，它的值正在与值集进行比较。
• valueset - 对用户定义对象的对象引用(oref)，该对象实现位图块迭代方法和ContainsItem()方法。 该方法接受一组数据值，并在与标量表达式中的值匹配时返回一个布尔值。
• SIZE ((nn)) - 可选-用于查询优化的数量级整数(10、100、1000等)。

描述

通过选择与值集中指定的值相匹配的数据值，通过迭代位图块序列中的值，%FIND谓词允许筛选结果集。 当标量表达式的值与valueset中的值匹配时，此匹配将成功。 如果值集值不匹配任何标量表达式值，%FIND返回空字符串。 无论显示模式如何，这个匹配总是在逻辑(内部存储)数据值上执行。

%FIND和其他比较条件一样，用于SELECT语句的WHERE子句或HAVING子句中。

%FIND使用抽象的、通过编程指定的匹配值集来过滤字段值。 具体来说，它使用抽象的、编程指定的位图来过滤RowId字段值，其中的值集行为类似于位图索引的下标层。

用户定义类派生自抽象类%SQL.AbstractFind。

第六章 SQL谓词 EXISTS

检查表中是否至少存在一个对应行。

大纲

EXISTS select-statement

参数

• select-statement - 一种简单的查询，通常包含一个条件表达式。

描述

EXISTS谓词测试指定的表，通常至少测试一行是否存在。 因为EXISTS后面的SELECT语句正在被检查是否包含某些内容，所以子句通常是这样的形式:

EXISTS (SELECT... FROM... WHERE...)

SELECT name
     FROM Table_A
     WHERE EXISTS
     (SELECT *
          FROM Table_B
          WHERE Table_B.Number = Table_A.Number)

在本例中，谓词测试子查询指定的一行或多行是否存在。

注意，测试必须发生在SELECT语句上(而不是在UNION上)。

NOT EXISTS子句测试表中是否有一行不存在，如下例所示:

SELECT EmployeeName,Age
     FROM Employees
     WHERE NOT EXISTS (SELECT * FROM BonusTable
     WHERE NOT (BonusTable.

第五章 SQL谓词 BETWEEN

大纲

scalar-expression BETWEEN lowval AND highval

参数

• scalar-expression - 一种标量表达式(最常见的是数据列)，将其值与低值和高值(包括高值)之间的值范围进行比较。
• lowval - 解析为低排序规则序列值的表达式，指定与标量表达式中的每个值匹配的值范围的开始。
• highval - 解析为高排序规则序列值的表达式，指定要与标量表达式中的每个值匹配的值范围的末尾。

描述

BETWEEN谓词允许选择lowval和highval指定范围内的数据值。 这个范围包括低值和高值本身。 这等价于一对大于或等于操作符和一对小于或等于操作符。 下面的例子展示了这种比较:

SELECT Name,Age FROM Sample.Person
WHERE Age BETWEEN 18 AND 21
ORDER BY Age

这将返回Sample中的所有记录。 年龄值介于18到21之间的人员表，包括这些值。 注意，必须按升序指定BETWEEN值; 例如BETWEEN 21 AND 18这样的谓词将返回空字符串。 如果标量表达式的值都不在指定的范围内，则BETWEEN返回空字符串。

与大多数谓词一样，BETWEEN可以使用NOT逻辑运算符进行反转。 BETWEEN和NOT BETWEEN都不能用于返回NULL字段。

第四章 SQL谓词 ANY

将值与子查询中的至少一个匹配值匹配。

大纲

scalar-expression comparison-operator ANY (subquery)

参数

• scalar-expression - 将其值与子查询生成的结果集进行比较的标量表达式(最常见的是数据列)。
• comparison-operator - 以下比较操作符之一:=(等于)，<>或!=(不等于)，<(小于)，<=(小于或等于)，>(大于)，>=(大于或等于)，[(包含)，或](跟随)。
• subquery - 一个用括号括起来的子查询，它返回一个用于与标量表达式比较的结果集。

描述

ANY关键字与比较操作符一起创建谓词(量化比较条件)，如果标量表达式的值匹配子查询检索到的一个或多个对应值，则该谓词为真。 ANY谓词将单个标量表达式项与单个子查询SELECT项进行比较。 具有多个选择项的子查询将生成SQLCODE -10错误。

注意:ANY和SOME关键字是同义词。

任何可以指定谓词条件的地方都可以使用ANY，如本手册的谓词概述页面所述。

在适用的情况下，系统自动对任意子查询应用集值子查询优化(SVSO)。

示例

下面的例子选择了居住在密西西比河以西任何一个州的工资超过75,000美元的员工:

SELECT Name,Salary,Home_State FROM Sample.

第三章 SQL谓词 ALL

将值与子查询中的所有对应值匹配。

大纲

scalar-expression comparison-operator ALL (subquery)

参数

• scalar-expression - 将其值与子查询生成的结果集进行比较的标量表达式(最常见的是数据列)。
• comparison-operator - 以下比较操作符之一:=(等于)，<>或!=(不等于)，<(小于)，<=(小于或等于)，>(大于)，>=(大于或等于)，[(包含)，或](跟随)。
• subquery - 一个用括号括起来的子查询，它从单个列返回一个结果集，用于与标量表达式进行比较。

描述

ALL关键字与比较操作符一起创建谓词(量化比较条件)，如果标量表达式的值与子查询检索到的所有对应值匹配，则该谓词为真。 ALL谓词将单个标量表达式项与单个子查询SELECT项进行比较。 具有多个选择项的子查询将生成SQLCODE -10错误。

ALL可以在任何可以指定谓词条件的地方使用，如本手册的谓词概述页面所述。

在适用的情况下，系统自动对ALL子查询应用集值子查询优化(SVSO)。

示例

下面的示例选择了Person数据库中小于Employee数据库中所有年龄的年龄:

SELECT DISTINCT Age FROM Sample.

第二章 SQL谓词的概述（二）

谓词和%SelectMode

所有谓词都使用逻辑(内部存储)数据值进行比较。 但是，有些谓词可以对谓词值执行格式模式转换，将谓词值从ODBC或Display格式转换为Logical格式。 其他谓词不能执行格式模式转换，因此必须始终以Logical格式指定谓词值。

执行格式模式转换的谓词确定是否需要从匹配字段的数据类型(如DATE``%List)进行转换，并确定从%SelectMode设置进行转换的类型。 如果%SelectMode设置为逻辑格式以外的值(例如%SelectMode=ODBC或%SelectMode=Display)，则必须以正确的ODBC或Display格式指定谓词值。

• 相等谓词执行格式模式转换。 IRIS将谓词值转换为逻辑格式，然后与字段值进行匹配。 如果%SelectMode设置为逻辑格式以外的模式，则必须以%SelectMode格式(ODBC或Display)指定显示值与逻辑存储值不同的数据类型的谓词值。 例如，日期、时间和%list格式的字符串。 因为IRIS会自动执行这种格式转换，所以在Logical格式中指定这种类型的谓词值通常会导致SQLCODE错误。 例如，SQLCODE -146“无法将日期输入转换为有效的逻辑日期值”(IRIS假设提供的逻辑值是ODBC或Display值，并试图将其转换为逻辑值——但没有成功)。

我使用例如select $ZVERSION sql语句在浏览器的sql查询中可以查到版本信息，但是放到jdbc程序中查询显示查询结果为0,不知道什么原因，要怎么才能查到这些信息呢，最好是通过java程序的方式

第一章 SQL谓词的概述（一）

描述计算结果为真或假的逻辑条件。

使用谓词

谓词是一个条件表达式，其计算结果为布尔值(true或false)。

谓词可以如下使用:

• 在SELECT语句的WHERE子句或HAVING子句中确定哪些行与特定查询相关。 注意，不是所有谓词都可以在HAVING子句中使用。
• 在JOIN操作的ON子句中确定哪些行与连接操作相关。
• 在UPDATE或DELETE语句的WHERE子句中，确定要修改哪些行。
• WHERE CURRENT OF语句的AND子句中。
• 在CREATE TRIGGER语句的WHEN子句中确定何时应用触发操作代码。

谓词列表

每个谓词包含一个或多个比较操作符，可以是符号，也可以是关键字子句。 SQL支持以下比较操作符:

• = (equals) ，<> (does not equal)，!= (does not equal)，> (is greater than)，>= (is greater than or equal to)，< (is less than)，<= (is less than or equal to) - 比较条件。 可用于数字比较或字符串排序顺序比较。 对于数值比较，空字符串值(")被计算为0。 在任何相等比较中，NULL总是返回空集; 请使用IS NULL谓词。
• IS [NOT] NULL - 测试字段是否有未定义(NULL)值。