SYSTS_UPGRADE_CATALOG プロシージャー - テキスト検索カタログのアップグレード

このプロシージャーは、管理表および管理ビューを含む Text Search カタログを、製品の最新バージョンにアップグレードします。

このプロシージャーは、製品の最新バージョンで使用される新しいカタログ表およびビューを作成するとともに、既存のカタログ表およびビューを更新します。廃止されたカタログ表およびビューは削除されます。

許可

このプロシージャーの許可 ID が持つ特権に、SYSTS_ADM ロールおよび DBADM 権限が含まれている必要があります。

デフォルトの PUBLIC 特権

なし

構文

スキーマは SYSPROC です。

プロシージャー・パラメーター

メッセージ・ロケール: 戻されるすべてのエラー・メッセージに使用されるロケールを指定する、タイプ VARCHAR(33) の入力引数。引数が NULL または空ストリングであるか、指定したロケールのメッセージ・ファイルがサーバーで使用できない場合には、'en_US' が使用されます。
message: 正常に完了した操作の警告または通知メッセージを指定する、タイプ VARCHAR(32K) の出力引数。

例

例 1: 次の例では、以前のリリースのテキスト検索がデータベースで使用可能になっています。 SYSTS_UPGRADE_CATALOG プロシージャーを呼び出すと、テキスト検索カタログ表がアップグレードされます。プロシージャーが成功すると、操作の成功を示す出力パラメーター・メッセージが呼び出し元に戻されます。

CALL SYSPROC.SYSTS_UPGRADE_CATALOG('en_US',?)

Value of output parameters
--------------------------
Parameter Name  : MESSAGE
Parameter Value  : CIE0213W The Db2 Text Search Catalog has been upgraded to 
the current version. You will now need to update the text search index using 
the SYSPROC.SYSTS_UPGRADE_INDEX stored procedure. 
index also needs to be updated by calling "SYSPROC.SYSTS_UPGRADE_INDEX".
  		
Return Status = 0

例 2: 次の例では、プロシージャーを呼び出す前は、旧リリースの Text Search がデータベースで使用可能になっていません。 message_locale の位置にある NULL 値は、デフォルト・ロケール 'en_US' が使用されることを意味します。エラー・メッセージはすべて英語で戻されます。

   CALL SYSPROC.SYSTS_UPGRADE_CATALOG('',?)

SQL20427N  An error occurred during a text search administration procedure 
or command. The error message is "CIE0323E Specified or default database 
not enabled for text. ". 
SQLSTATE=38H14

例 3: 次の例では、テキスト検索カタログとテキスト検索索引が現行バージョンに既にアップグレードされています。

CALL SYSPROC.SYSTS_UPGRADE_CATALOG('en_US',?)

Value of output parameters
--------------------------
Parameter Name  : MESSAGE
Parameter Value  : CIE0002I The Db2 Text Search release level is current 
for the database. The system has not been upgraded. 

  	Return Status = 0

使用上の注意

テキスト検索カタログ固有のアップグレードを実行するため、SYSTS_UPGRADE_CATALOG プロシージャーが DB2 UPGRADE DATABASE コマンドに組み込まれています。データベース・アップグレードがテキスト検索カタログのアップグレードに失敗した場合、ユーザーが SYSTS_UPGRADE_CATALOG プロシージャーを別個に実行し、データベース・アップグレードを完了させる必要があります。

テキスト検索索引カタログをアップグレードするには、以下の手順を実行します。

Text Search インスタンス・サービスが停止していることを確認します。
SYSTS_UPGRADE_CATALOG プロシージャーを実行します。
注: Text Search 管理プロシージャーは、データベースへの既存の接続を使用します。現行トランザクションは、プロシージャーの完了結果に応じてコミットされるかまたはロールバックされる場合があります。そのため、そのようなコミットまたはロールバックからの予期しない影響を避けるために、すべてのトランザクション変更をコミットすることをお勧めします。これを行う 1 つの方法は、AUTOCOMMIT をオンにすることです。
SYSTS_UPGRADE_CATALOG プロシージャーが、カタログに Text Search サーバー情報の設定を試行します。 SYSIBMTS.TSSERVER の内容を検討して、必要に応じて、Text Search サーバー情報を更新してください。
SYSTS_UPGRADE_INDEX プロシージャーについて示されている手順に従って、テキスト検索索引をアップグレードします。 SYSTS_UPGRADE_INDEX プロシージャーの実行が正常に完了するまでは、SYSIBMTS.TSDEFAULTS 管理ビュー内のバージョン値が更新されません。