FILTER 参数

使用 FILTER 索引参数可指定在对列中数据建立索引之前应先对该数据进行过滤。

重要：过滤并不会修改存储在表列中的文档；文档仍然以专用格式化文本存储。

在创建过滤索引之前，配置您的数据库服务器以进行过滤、记录和跟踪。请参阅配置数据库服务器以进行过滤，以获取完整详细信息。

在配置完数据库服务器之后，可以在 CREATE INDEX 语句中使用 FILTER 索引参数，以在对文档建立索引之前从这些文档中过滤掉专用信息。

以下语句在表 my_table 的 abstract 列上创建了一个 etx 索引，并指定应该在将 abstract 列中的文档添加到索引之前对其进行过滤。

CREATE INDEX abstract_index ON my_table (abstract etx_clob_ops)
    USING etx (FILTER = 'STOP_ON_ERROR');

可以对 GBase 8s Excalibur Text Search DataBlade 模块支持的全部 7 种数据类型的列启用过滤：CHAR、VARCHAR、BLOB、CLOB、LVARCHAR、IfxDocDesc 和 IfxMRData。

可以将 FILTER 索引参数设置为下表描述的三个值之一：

值	描述
NONE	将文档添加到 etx 索引之前不对其进行过滤。例如，对于一个 Microsoft^® Word 文档，这意味该文档的所有格式信息会随它一起添加到索引中。将 FILTER 索引参数设置为 NONE，效果等同于根本不指定 FILTER 索引参数。
STOP_ON_ERROR	如果在过滤期间出错，那么执行语句的客户机程序将收到一条识别导致错误的行的消息，该错误会记录到跟踪日志（如果已启用跟踪），同时停止该语句。请参阅处理过滤错误，以获取有关在出现过滤错误时决定要执行的操作的信息。
CONTINUE_ON_ERROR	如果在过滤期间出错，那么识别导致错误的行的消息会被记录到跟踪日志中，同时未过滤的文档及其所有格式信息会被插入索引，并且该语句会继续执行。请参阅处理过滤错误，以获取有关在出现过滤错误时决定要执行的操作的信息。请参阅启用跟踪，以获取有关如何设置跟踪的信息。

为包含数据的表创建 etx 索引后，会自动过滤在表中插入新行或更新行时添加的数据。

您还可以通过使用 etx_Filter() 例程在 SELECT 语句中过滤文档。请参阅 etx_Filter() 例程，以获取有关该例程的更多信息。

有关可以使用 GBase 8s Excalibur Text Search DataBlade 模块过滤的文件格式的列表，请参阅可以过滤的文档格式。