IBM Books
(C) IBM Corp. 2000, 2003.

Net Search Extender

管理和用户指南

ALTER INDEX

该命令将更改全文本索引的特征,例如,更新选项和存储器选项。

授权

根据 DB2 目录视图,此命令中的用户标识必须对为其创建全文本索引的表必须具有 CONTROL 特权。

命令语法

>>-ALTER-INDEX--+------------------+--index-name--FOR-TEXT------>
                '-index-schema-"."-'
 
>--+--------------------------+--+-------------------+---------->
   '-|update-characteristics|-'  '-|storage-options|-'
 
>--+----------------------+------------------------------------><
   '-|connection-options|-'
 
storage-options:
 
|--+----------------------------+------------------------------->
   '-INDEX-DIRECTORY--directory-'
 
>--+-------------------------------+---------------------------->
   '-WORK-DIRECTORY--workdirectory-'
 
>--+------------------------------------------------+----------->
   '-CACHE TABLE--+-PERSISTENT--+---------------+-+-'
                  |             '-IN--directory-' |
                  '-TEMPORARY---------------------'
 
>--+---------------------+--+-----------------------------+-----|
   '-PCTFREE--percentage-'  '-MAXIMUM CACHE SIZE--memsize-'
 
update-characteristics:
 
|--+------------------------------------------+----------------->
   '-UPDATE-FREQUENCY--+-NONE---------------+-'
                       '-|update-frequency|-'
 
>--+----------------------------+------------------------------->
   '-UPDATE-MINIMUM--minchanges-'
 
>--+-------------------------------+----------------------------|
   '-COMMITCOUNT-FOR-UPDATE--count-'
 
update-frequency:
 
|--D--(--+-*---------+--)--H--(--+-*----------+--)--M----------->
         | .-,-----. |           | .-,------. |
         | V       | |           | V        | |
         '---0...6-+-'           '---0...23-+-'
 
      .-,------.
      V        |
>--(----0...59-+--)---------------------------------------------|
 
connection-options:
 
|--+--------------------------------------------------------------+--|
   '-CONNECT-TO--database-name--+-------------------------------+-'
                                '-USER--userid--USING--password-'
 
 

命令参数

index-schema
文本索引的模式,如在 CREATE INDEX 命令中指定的那样。如果没有指定任何模式,则使用 DB2 连接的用户标识。

index-name
文本索引的名称,如在 CREATE INDEX 命令中指定的那样。

INDEX DIRECTORY directory
用来存储文本索引的目录路径。由于该目录将包含索引数据,因此应确保该目录对 DB2 实例所有者用户标识具有读/写和运行许可权。

注意,在分布式 DB2 环境中,每个节点上都必须存在此目录。在目录下创建了一个子目录 NODE<nr> 以区分服务器的逻辑节点上的索引。将删除先前索引目录中的任何索引文件。

WORK DIRECTORY workdirectory
在搜索和管理操作期间用来存储临时文件。可以独立地更改新的索引目录的独立工作目录。

如果该目录不存在,则会为 DB2 实例所有者用户标识创建它。如果该目录存在,则确保在 UNIX 平台上实例所有者对该目录具有读/写许可权。

注意,在分布式 DB2 环境中,每个节点上都必须存在此目录。在目录下创建了一个子目录 NODE<nr> 以区分服务器的逻辑节点上的索引。将删除先前索引目录中的任何临时索引文件。

CACHE TABLE PERSISTENT IN directory
指定在取消激活或系统重新引导之后,CREATE INDEX 中已高速缓存的表就是持久的了。在任何一种情况下,这都允许快速执行 ACTIVATE CACHE。持久高速缓存存储在指定的目录中。

先前创建的持久高速缓存将移至新位置。此位置总是需要已取消激活的索引。

CACHE TABLE TEMPORARY
指定高速缓存的结果表现在是临时的,并且已经删除了任何先前存在的持久高速缓存。注意,此更改需要已取消激活的索引。

MAXIMUM CACHE SIZE memsize
指定在 ACTIVATE CACHE 期间要构建的高速缓存表的新的最大大小。以兆字节为单位将 memsize 参数指定为正整数。

如果该整数太小,则 ACTIVATE CACHE 命令将失败。实际高速缓存大小是在执行 ACTIVATE CACHE 命令期间计算的。此更改需要已取消激活的索引。

PCTFREE percentage
指定保留的用于附加文档的高速缓存的百分比。该百分比必须是小于 100 并且大于或等于 0 的整数。注意,会删除先前的持久高速缓存,并且此更改需要已取消激活的索引。参见ACTIVATE CACHE

UPDATE FREQUENCY
通过使用下列参数,索引更新步骤可确定何时进行更新:

如果不指定 UPDATE FREQUENCY 关键字,则频率设置将保持不变。

UPDATE MINIMUM minchanges
在对索引进行增量更新之前允许对文本文档所做的最小更改数。如果不指定 UPDATE MINIMUM 关键字,则不会更改该设置。

注意,仅当索引不是使用 RECREATE ON UPDATE 选项创建时才能更改 UPDATE MINIMUM。

COMMITCOUNT FOR UPDATE count
对于更新处理,可以指定落实计数。有关进一步的信息,参见UPDATE INDEX。这同时适用于 UPDATE 命令和 UPDATE FREQUENCY 规范,它将调度更新处理。

注意,仅当索引不是使用 RECREATE ON UPDATE 选项创建时才能更改 COMMITCOUNT。

还要注意,如果是使用 REPLICATION 选项来创建索引的,则不能更改 COMMITCOUNT。

CONNECT TO database-name
作为此命令的目标的数据库的名称。如果设置了 DB2DBDFT 并且用户正在服务器上运行命令,则可以省略此参数。注意,用户标识必须具有必需的 DB2 权限。

USER userid USING password
使用 passworduserid 来连接至数据库。如果未指定它们,则会尝试使用当前用户标识而不带密码来建立连接。

用法

如果正在对索引运行下列命令之一,则不能发出该命令:

在分布式 DB2 环境中,仅在具有单个节点的表空间上才允许具有高速缓存选项的文本索引。

对数据库的更改
更改 DB2 Net Search Extender 目录视图。

对文件系统的更改


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]