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

大纲

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

scalar-expression IN (subquery)

参数

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

描述

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

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

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

相等测试

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

SELECT Name, Home_State FROM Sample.Person
WHERE Home_State IN ('ME','NH','VT','MA','RI','CT') 

如果Home_State等于逗号分隔列表中的任何值,则计算为true
列出的项可以是常量或表达式。

IN比较使用为标量表达式定义的排序规则类型,而不考虑单个项的排序规则类型。
默认情况下,字符串数据类型字段是用SQLUPPER排序规则定义的,它不区分大小写。

下面两个示例说明排序规则匹配是基于标量表达式排序规则的。
Home_State字段是用SQLUPPER(不区分大小写)排序规则定义的。
因此,下面的示例返回NH Home_State值:

SELECT Name, Home_State FROM Sample.Person
WHERE Home_State IN ('ME','nH','VT')

下面的示例不返回NH Home_State值:

SELECT Name, Home_State FROM Sample.Person
WHERE %EXACT(Home_State) IN ('ME','nH','VT')

在值列表中包含NULL没有意义。
NULL表示没有值,因此无法通过所有相等测试。
指定IN谓词(或任何其他谓词)将消除指定字段的任何NULL实例。
这在以下不正确(但可执行)的示例中显示:

SELECT FavoriteColors FROM Sample.Person
WHERE FavoriteColors IN ($LISTBUILD('Red'),$LISTBUILD('Blue'),NULL)
  /* NULL here is meaningless. No FavoriteColor NULL fields returned */

在谓词结果集中包含NULL字段的唯一方法是指定is NULL谓词,如下例所示:

SELECT FavoriteColors FROM Sample.Person
WHERE FavoriteColors IN ($LISTBUILD('Red'),$LISTBUILD('Blue')) OR FavoriteColors IS NULL

当使用日期或时间进行IN谓词相等性比较时,将自动执行适当的数据类型转换。
如果WHERE字段类型为TimeStamp,则DateTime类型的值将转换为TimeStamp
如果WHERE字段类型为Date,则类型为TimeStampString的值将转换为Date
如果WHERE字段为type Time,则类型为TimeStampString的值将转换为Time

下面的示例执行相同的相等比较并返回相同的数据。
DOB字段的数据类型为Date:

SELECT Name,DOB FROM Sample.Person 
WHERE DOB IN ({d '1951-02-02'},{d '1987-02-28'})

 

SELECT Name,DOB FROM Sample.Person 
WHERE DOB IN ({ts '1951-02-02 02:37:00'},{ts '1987-02-28 16:58:10'})

%SelectMode

如果%SelectMode设置为逻辑格式以外的值,那么IN谓词值必须以%SelectMode格式(ODBCDisplay)指定。
这主要适用于日期、时间和IRIS格式列表(%List)。
以逻辑格式指定谓词值通常会导致SQLCODE错误。
例如,SQLCODE -146“无法将日期输入转换为有效的逻辑日期值”。

在以下动态SQL示例中,In谓词必须以%SelectMode=1 (ODBC)格式指定日期:

/// dclass(PHA.TEST.SQLCommand).In()
ClassMethod In()
{
   
     
	s q1 = "SELECT Name,DOB FROM Sample.Person "
	s q2 = "WHERE DOB IN('1956-03-05','1956-04-08','1956-04-18','1990-04-25')"
	s myquery = q1_q2
	s tStatement =class(%SQL.Statement).%New()
	s tStatement.%SelectMode=1
	s qStatus = tStatement.%Prepare(myquery)
	if qStatus'=1 {
   
     
		w "%Prepare failed:" 
		d $System.Status.DisplayError(qStatus) 
		q
	}
	s rset = tStatement.%Execute()
	d rset.%Display()
	w !,"End of data"
}

子查询比较

可以在子查询中使用IN谓词来测试列值(或任何其他表达式)是否等于任何子查询行值。
例如:

SELECT Name,Home_State FROM Sample.Person
WHERE Name IN 
   (SELECT Name FROM Sample.Employee
    HAVING Salary < 50000)

注意,子查询在SELECT列表中必须只有一个选择项。

下面的例子使用一个IN子查询返回不是Vendor状态的`Employee状态:

SELECT Home_State
FROM Sample.Employee
WHERE Home_State NOT IN (SELECT Address_State FROM Sample.Vendor)
GROUP BY Home_State

下面的示例将排序规则函数表达式匹配到带有子查询的IN谓词:

SELECT Name,Id FROM Sample.Person
WHERE %EXACT(Spouse) NOT IN
   (SELECT Id FROM Sample.Person
    WHERE Age < 65)

IN不能同时指定子查询和逗号分隔的文字值列表。

文字替换覆盖

在编译预解析期间,可以用圆括号将每个IN谓词参数括起来,从而覆盖文字替换。
例如,WHERE Home_State IN (('ME'),('NH'),('VT'),('MA'),('RI'),('CT'))
这可以通过改善整体选择性和/或下标边界选择性来提高查询性能。
但是,当使用不同的值多次调用同一个查询时,应该避免使用这种方法,因为这将导致为每个查询调用创建一个单独的缓存查询。

IN and %INLIST

IN%INLIST谓词都可以用于提供多个值来进行OR相等比较。
%INLIST谓词用于将值匹配到%List结构的元素。
在动态SQL中,可以将%INLIST谓词值作为单个主机变量提供。
必须将IN谓词值作为单独的主机变量提供。
因此,更改IN谓词值的数量将导致创建一个单独的缓存查询。
%INLIST接受一个谓词值,一个包含多个元素的%List;
更改%List元素的数量不会导致创建一个单独的缓存查询。
%INLIST还提供了一个数量级的SIZE参数,SQL使用它来优化性能。
由于这些原因,使用它通常是有利的

%INLIST($LISTFROMSTRING(val)) rather than IN(val1,val2,val3,..valn).

%INLIST可以执行相等比较;
它不能执行子查询比较。