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.AbstractFind。此抽象类定义ContainsItem()方法，该方法是%inset唯一支持的方法。ContainsItem()方法返回值集。

排序类型

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

如果为列分配不同的排序规则类型，则还必须将此排序规则类型应用于%INSET子字符串。

Size子句

可选的%INSET SIZE子句提供整数nn，它指定valueset中值数量的数量级估计值。 IRIS使用这个数量级估计来确定最佳查询计划。 指定nn为以下文字之一:10、100、1000、10000，等等。 因为nn必须在编译时作为常量值可用，所以在所有SQL代码中必须将其指定为文字。 注意，必须为所有SQL指定嵌套括号，嵌入式SQL除外。

%INSET和%FIND比较

• INSET是最简单和最通用的接口。 它支持ContainsItem()方法。
• %FIND支持使用位图索引对位图块进行迭代。 它模拟了ObjectScript $ORDER函数的功能，支持NextChunk()、PreviousChunk()和GetChunk()迭代方法，以及ContainsItem()方法。