DELETE 時
3.2 XML データ検索プラグインのユティリティ
3.2.11 phjcond(インデクス詰め替えユティリティ)
(1) 機能
不要なインデクスを削除します。
(2) 実行者
HiRDB 管理者が実行できます。
(3) 形式
phjcond -d インデクス識別子 -r RDエリア名 [-l ログ取得方式] [-t 詰め替え時間] [-q 世代番号]
(4) コマンド引数
-d インデクス識別子:
詰め替え対象となるインデクス識別子を指定します。
必ずインデクス作成時に指定したインデクス識別子を指定してください。
•
UNIX の場合
インデクス識別子を「"」(ダブルクォーテーション)で囲んだ場合は,英大文字と英小文字が区別 されます。「"」で囲まない場合はすべて大文字として扱われます。また,インデクス識別子にスペー スが含まれる場合は,「"」で囲む必要があります。なお,sh,csh および ksh の場合は,さらに「'」
(アポストロフィ)で囲む必要があります。
•
Windows の場合
インデクス識別子を「\"」で囲んだ場合は,英大文字と英小文字が区別されます。「\"」で囲まない 場合はすべて大文字として扱われます。また,インデクス識別子にスペースが含まれる場合は,「"」
で囲む必要があります。
-r RD エリア名:
指定されたインデクスがある RD エリア名を指定します。
•
UNIX の場合
RD エリア名を「"」(ダブルクォーテーション)で囲んだ場合は,英大文字と英小文字が区別され ます。「"」で囲まない場合はすべて大文字として扱われます。また,RD エリア名にスペースが含 まれる場合は,「"」で囲む必要があります。なお,sh,csh および ksh の場合は,さらに「'」(ア ポストロフィ)で囲む必要があります。
•
Windows の場合
RD エリア名を「\"」で囲んだ場合は,英大文字と英小文字が区別されます。「\"」で囲まない場合 はすべて大文字として扱われます。また,RD エリア名にスペースが含まれる場合は,「"」で囲む 必要があります。
-l ログ取得方式:
インデクス詰め替え処理でのログ取得方式を指定します。
省略時は「p」が設定されます。
•
a:
ログ取得モードで実行します。
ロールバックおよびロールフォワードに必要なデータベース更新ログを取得します。インデクスの バックアップを取得する必要はありません。
•
p:
更新前ログ取得モードで実行します。
ロールバックに必要なデータベース更新ログを取得します。インデクス詰め替え処理後,バックアッ プを取得する必要があります。
ログレスモードで実行します。
データベース更新ログを取得しません。インデクス詰め替え処理前およびインデクス詰め替え処理 後にバックアップを取得する必要があります。
-t 詰め替え時間:
インデクス詰め替えユティリティの実行時間を分単位で指定します。
実行時間は半角数字で 0〜6,000 の間で 15 分単位で指定してください。15 の倍数でない値が指定され た場合は,15 分単位で切り上げられます。
実行時間に 0 を指定した場合,またはこのオペランドを省略した場合,詰め替え処理が完了するまで処 理を続けます。
指定した実行時間で詰め替え処理が完了しなかった場合,ユティリティが指定時間を過ぎて終了した旨 のメッセージを出力します。
-q 世代番号:
Staticizer Option のインナレプリカ機能を使用する場合,処理対象とする RD エリアを 0〜10 の世代 番号で指定します。指定を省略した場合は,カレント RD エリアが仮定されます。
•
0
オリジナル RD エリアを対象とします。
•
1〜10
指定した世代番号の RD エリアを対象とします。
このオペランドは,Staticizer Option がインストールされていない場合は指定できません。
なお,インナレプリカ機能については,マニュアル「インナレプリカ機能 HiRDB Staticizer Option」
を参照してください。
(5) 規則
このユティリティは,HiRDB が稼働中のときだけ実行できます。
(6) 注意事項
• 詰め替え処理は,1 回の処理ですべてのインデクスを処理できないことがあります。このため,詰め替 え実施後,インデクス情報の取得ユティリティで未実施インデクス数(Number of No Condensed Index)を確認してください。インデクス情報の取得ユティリティの詳細については,「3.2.4 phjidxls
(インデクス情報の取得ユティリティ)
」を参照してください。この値が大きいときは,インデクス空き 容量に注意して,再度詰め替えを実行してください。• このユティリティは,インデクス空き容量がある状態(推奨 10%以上)で実行する必要があります。
空きのない状態でユティリティを実行したとき,または詰め替え未実施インデクス数(Number of No Condensed Index)が減らない場合は,新たに RD エリアを追加してインデクスの拡張ユティリティ を使用し,空き容量がある状態で実行してください。インデクスの拡張ユティリティの詳細について は,「3.2.7 phjexpnd(インデクスの拡張ユティリティ)」を参照してください。空き容量は,インデ クス情報の取得ユティリティの Free Size of Index File で確認してください。インデクス情報の取得
ユティリティの詳細については,「3.2.4 phjidxls(インデクス情報の取得ユティリティ)」を参照して ください。
• 詰め替え実行時間を指定した場合,指定時間と実際の処理時間との間に多少のずれが生じることがあり ます。
• XML データを削除すると,詰め替え可能 XML データ率は増加します。このため,詰め替え中断時に XML データを削除すると,詰め替え処理完了後でも詰め替え可能 XML データ率は 0 になりません。
• このユティリティ実行中は,処理対象となる RD エリアに対して排他モード(EX)による排他制御を するので,ほかのトランザクションと同時に実行できません。
• 詰め替えを実行する契機の指標として,インデクス情報の取得ユティリティの「Ratio of Condensable Documents(詰め替え可能 XML データ率)」が,50%以上を目安としてください。インデクス情報の 取得ユティリティの詳細については,「3.2.4 phjidxls(インデクス情報の取得ユティリティ)」を参照 してください。
• インデクス情報の取得ユティリティの「Ratio of Condensed Index(詰め替え作業率)」は,詰め替 え処理が制限時間で終了したときの詰め替え作業進ちょく率を表します。インデクス情報の取得ユティ リティの詳細については,「3.2.4 phjidxls(インデクス情報の取得ユティリティ)」を参照してくださ い。
• このユティリティを実行する際に,グローバルバッファを指定すると,実行性能が向上します。
• 詰め替え時間を指定した場合,指定時間を過ぎて詰め替え処理を中断したときは,メッセージログに
「02001-I phjcond is Time Out.」のメッセージが出力されます。
詰め替え処理を完了して終了した場合は,「02003-I phjcond command ended」のメッセージが出力 されます。