SQL谓词 %FIND

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。 这个抽象类定义了ContainsItem()布尔方法。 ContainsItem()方法将标量表达式值与值集值匹配。

使用以下三种方法对位图块序列中的值进行迭代:

• GetChunk(c)，返回块编号为c的位图块。
• NextChunk(.c)，它返回第一个块编号为> c的位图块。
• PreviousChunk(.c)，返回第一个块号< c的位图块。

排序类型

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

SIZE子句

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

%FIND和%INSET比较

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