IBM Books
(C) IBM Corp. 2000

Net Search Extender 管理およびユーザーズ・ガイド

ALTER INDEX

コマンドは、更新オプションおよび保管オプションのような、 フル・テキスト索引の特性を変更します。

許可

DB2 カタログ・ビューによると、 このコマンドのユーザー ID は、フル・テキスト索引が作成された表に対して 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 接続のユーザー ID が使用されます。

index-name
CREATE INDEX コマンドで指定されたテキスト索引の名前。

INDEX DIRECTORY directory
テキスト索引の保管先ディレクトリー・パス。 ディレクトリーは索引データを含むので、ディレクトリーには、 DB2 インスタンス所有者ユーザー ID 用の 読み取り/書き込み、および実行権限があることを確認してください。

分散 DB2 環境では、このディレクトリーはすべてのノード上に存在する必要があることに注意してください。サブディレクトリー NODE<nr> は、サーバーの論理ノード上の索引を区別するために、このディレクトリーの下に作成されます。 以前の索引ディレクトリーからの索引ファイルは、すべて削除されます。

WORK DIRECTORY workdirectory
検索操作と管理操作中に一時ファイルを保管します。 新規索引ディレクトリーとは無関係に、別個の作業ディレクトリーを変更できます。

ディレクトリーが存在しない場合は、DB2 インスタンス所有者ユーザー ID 用に作成されます。 ディレクトリーが存在する場合は、ディレクトリーがインスタンス所有者用に 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
追加の文書のためにフリーにしておくキャッシュのパーセンテージを指定します。 パーセンテージは 0 以上で 100 より小さい整数値でなければなりません。 それまでの永続キャッシュは削除され、 この変更には非アクティブ化された索引が必要であることに注意してください。 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 が設定されており、 ユーザーがサーバーでコマンドを実行している場合は、 このパラメーターを省略できます。 ユーザー ID には必須 DB2 許可がなければならないことに注意してください。

USER userid USING password
password および userid を使用してデータベースに接続します。 指定しない場合は、パスワードなしで現行ユーザー ID から接続が試行されます。

使用法

次のコマンドのいずれかが索引上で実行中の場合には、このコマンドを発行できないことに注意してください。

キャッシュ・オプションを指定して索引を作成する場合、 索引がアクティブになっているときは、 索引ディレクトリーに対して ALTER INDEX コマンドを使用できません。 まず始めに、キャッシュを非アクティブにします。

分散 DB2 環境では、 キャッシュ・オプション付きのテキスト索引は、 単一ノード表スペース上にのみ許可されています。

データベースへの変更
DB2 Net Search Extender カタログ・ビューを変更します。

ファイル・システムへの変更


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]