该命令将更改全文本索引的特征,例如,更新选项和存储器选项。
根据 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-'
注意,在分布式 DB2 环境中,每个节点上都必须存在此目录。在目录下创建了一个子目录 NODE<nr> 以区分服务器的逻辑节点上的索引。将删除先前索引目录中的任何索引文件。
如果该目录不存在,则会为 DB2 实例所有者用户标识创建它。如果该目录存在,则确保在 UNIX 平台上实例所有者对该目录具有读/写许可权。
注意,在分布式 DB2 环境中,每个节点上都必须存在此目录。在目录下创建了一个子目录 NODE<nr> 以区分服务器的逻辑节点上的索引。将删除先前索引目录中的任何临时索引文件。
先前创建的持久高速缓存将移至新位置。此位置总是需要已取消激活的索引。
如果该整数太小,则 ACTIVATE CACHE 命令将失败。实际高速缓存大小是在执行 ACTIVATE CACHE 命令期间计算的。此更改需要已取消激活的索引。
注意,仅当索引不是使用 RECREATE ON UPDATE 选项创建时才能更改 UPDATE MINIMUM。
注意,仅当索引不是使用 RECREATE ON UPDATE 选项创建时才能更改 COMMITCOUNT。
还要注意,如果是使用 REPLICATION 子句来创建索引的,则不能更改 COMMITCOUNT。
如果正在对索引运行下列命令的其中一个命令,则不能发出该命令:
如果使用高速缓存选项来创建索引,则当激活了索引时不能对索引目录使用 ALTER INDEX 命令。必须首先取消激活高速缓存。
在分布式 DB2 环境中,仅在具有单个节点的表空间上才允许具有高速缓存选项的文本索引。