ALTER ROUTINE関数,手続き,及びトリガのSQLオブジェクトの再作成

機能

SQL関数,SQL手続き,及びトリガのSQLオブジェクトを再作成します。また,Java関数及びJava手続きのコンパイルオプションを変更します。

使用権限

関数,手続き,及びトリガの所有者
自分が所有する関数,手続き(自分が定義したパブリック関数,パブリック手続きを含む),及びトリガのSQLオブジェクトを再作成できます。
  • AUTHORIZATION句には,自分の認可識別子だけ指定できます。
  • AUTHORIZATION句を省略した場合,エラーとなります。
DBA権限を持つユーザ
自分が所有する関数,手続き(自分が定義したパブリック関数,パブリック手続きを含む),及びトリガ,並びに他ユーザが所有する関数,手続き(他ユーザが定義したパブリック関数,パブリック手続きを含む),及びトリガのSQLオブジェクトを再作成できます。
  • AUTHORIZATION句には,自分及び他ユーザの認可識別子を指定できます。
  • AUTHORIZATION句を省略することで,システム内のすべての関数及び手続きのSQLオブジェクトを再作成できます。

形式

 ALTER ROUTINE〔〔AUTHORIZATION 認可識別子〕〔ALL〕〕
   〔SQLコンパイルオプション〔SQLコンパイルオプション〕…〕

 SQLコンパイルオプション::={ISOLATION データ保証レベル 〔FOR UPDATE EXCLUSIVE〕
                |OPTIMIZE LEVEL SQL最適化オプション
                         〔,SQL最適化オプション〕…
                |ADD OPTIMIZE LEVEL SQL拡張最適化オプション
                         〔,SQL拡張最適化オプション〕…
                |SUBSTR LENGTH 文字の最大長

オペランド

再作成する関数,手続き,及びトリガを,所有者の認可識別子と,関数,手続き,及びトリガの状態で指定します。

〔AUTHORIZATION 認可識別子〕
関数,手続き,及びトリガの所有者(パブリック関数,パブリック手続きの定義者を含む)の認可識別子を指定して,そのユーザが所有するすべての関数,手続き,及びトリガのSQLオブジェクトを再作成します。このオペランドを省略した場合,システム内のすべての関数,手続き,及びトリガのSQLオブジェクトを再作成します。ただし,実際にSQLオブジェクトを再作成するかどうかは,ALL句の指定との組み合わせによって決まります。
認可識別子
再作成する関数,手続き,及びトリガの,所有者の認可識別子を指定します。
〔ALL〕
どの状態の関数,手続き,及びトリガの,SQLオブジェクトを再作成するかを指定します。このオペランドを省略した場合,SQLオブジェクトが無効な関数,手続き,及びトリガだけ再作成します。
ALL
指定した関数,手続き,及びトリガのSQLオブジェクトが有効か無効かに関係なく,すべて再作成する場合に指定します。

SQLコンパイルオプションにはISOLATION,OPTIMIZE LEVEL,ADD OPTIMIZE LEVEL,SUBSTR LENGTHをそれぞれ1回しか指定できません。

〔ISOLATION データ保証レベル 〔FOR UPDATE EXCLUSIVE〕〕
SQLのデータ保証レベルを指定します。
データ保証レベル
データ保証レベルとは,トランザクションのどの時点までデータの内容を保証するかのレベルです。次に示すデータ保証レベルを指定できます。
  • 0
    データの内容を保証しない場合に指定します。
    0レベルを指定すると,ほかのユーザが更新中のデータでも,更新完了を待たないで参照できます。ただし,参照する表が共用表の場合,ほかのユーザが排他モードでLOCK文を実行しているときには,排他解除待ちとなります。
  • 1
    検索処理の終了までデータの内容を保証したい場合に指定します。
    1レベルを指定すると,検索処理が終了するまで(HiRDBがページ,又は行を見終わるまで)一度検索したデータをほかのユーザは更新できません。
  • 2
    トランザクションの終了まで一度検索したデータの内容を保証したい場合に指定します。
    2レベルを指定すると,トランザクションが終了するまで一度検索したデータをほかのユーザは更新できません。
〔FOR UPDATE EXCLUSIVE〕
手続き中のFOR UPDATE句を指定した,又は仮定されるカーソル,及び問合せに対してSQLコンパイルオプションで指定したデータ保証レベルに関係なく常にWITH EXCLUSIVE LOCKを仮定する場合に指定します。データ保証レベルに2レベルを指定した場合,FOR UPDATE句を指定した,又は仮定されるカーソル,及び問合せにはWITH EXCLUSIVE LOCKを仮定するため,FOR UPDATE EXCLUSIVEを指定する必要はありません。SQLコンパイルオプションにデータ保証レベルを指定し,FOR UPDATE EXCLUSIVEを省略した場合,FOR UPDATE EXCLUSIVE指定なしとなります。
《クライアント環境定義との関係》
ALTER ROUTINEに対して,PDISLLVL,PDFORUPDATEEXLOCKの指定は無効となります。
《SQLとの関係》
手続き中のSQL文に排他オプションを指定している場合はSQLコンパイルオプションで指定したデータ保証レベル,及びFOR UPDATE EXCLUSIVEから仮定する排他オプションよりSQL文に指定した排他オプションが優先されます。
このオペランドを省略した場合,前回のSQLオブジェクト作成時(CREATE PROCEDURE,ALTER PROCEDURE,CREATE TYPE,ALTER ROUTINE,CREATE TRIGGER,又はALTER TRIGGERの実行時)に指定した値が仮定されます。
データ保証レベルについては,マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。
〔OPTIMIZE LEVEL SQL最適化オプション〔,SQL最適化オプション〕…〕
データベースの状態を考慮して,最も効率的なアクセスパスを決定するための最適化の方法を指定します。
SQL最適化オプションは,識別子(文字列)で指定する方法と,数値で指定する方法がありますが,通常時は識別子で指定する方法をお勧めします。
省略した場合,前回のSQLオブジェクト作成時(CREATE PROCEDURE,ALTER PROCEDURE,CREATE TYPE,ALTER ROUTINE,CREATE TRIGGER,又はALTER TRIGGER)に採用した値が仮定されます。
 
識別子で指定する場合:

OPTIMIZE LEVEL "識別子"〔,"識別子"〕…

<指定例>
  • ネストループジョイン優先とグループ分け高速化処理を適用する場合
    OPTIMIZE LEVEL "PRIOR_NEST_JOIN","RAPID_GROUPING"
  • すべての最適化を適用しない場合
    OPTIMIZE LEVEL "NONE"
<規則>
  1. 識別子は一つ以上指定してください。
  2. 識別子を二つ以上指定する場合は,コンマ(,)で区切ってください。
  3. 識別子に指定できる内容(最適化方法)については,「表3-4 SQL最適化オプションの指定値(ALTER ROUTINE)」を参照してください。
  4. すべての最適化を適用しない場合は,識別子に"NONE"を指定してください。ただし,同時に"NONE"以外の識別子を指定すると,"NONE"は無効になります。
  5. 識別子は大文字及び小文字で指定できます。
  6. 同じ識別子を二つ以上指定しても,一つ指定したものとみなされますが,なるべく同じ識別子は指定しないようにしてください。
 
数値で指定する場合:

OPTIMIZE LEVEL 符号なし整数〔,符号なし整数〕…

<指定例>
  • 複数のSQLオブジェクト作成,ANDの複数インデクス利用の抑止,及び複数インデクス利用の強制を適用する場合
    符号なし整数をコンマで区切って指定する場合:
    OPTIMIZE LEVEL 4,10,16
    符号なし整数の和を指定する場合:
    OPTIMIZE LEVEL 30
  • 既に14(4+10)を指定していて,新たに16を追加する場合
    OPTIMIZE LEVEL 14,16
  • すべての最適化を適用しない場合
    OPTIMIZE LEVEL 0
<規則>
  1. バージョン06-00より前のHiRDBから,バージョン06-00以降のHiRDBにバージョンアップする場合,バージョン06-00より前の合計値指定も有効となります。最適化オプションを変更する必要がない場合は,バージョン06-00以降のHiRDBにバージョンアップしたときにこのオペランドの指定値を変更する必要はありません。
  2. 符号なし整数は一つ以上指定してください。
  3. 符号なし整数を二つ以上指定する場合は,コンマ(,)で区切ってください。
  4. 符号なし整数に指定できる内容(最適化方法)については,「表3-4 SQL最適化オプションの指定値(ALTER ROUTINE)」を参照してください。
  5. すべての最適化を適用しない場合は,符号なし整数に0を指定してください。ただし,同時に0以外の識別子を指定すると,0は無効になります。
  6. 同じ符号なし整数を二つ以上指定しても,一つ指定したものとみなされますが,なるべく同じ符号なし整数は指定しないようにしてください。
  7. 複数の最適化方法を指定する場合,その符号なし整数の和を指定することもできます。ただし,同じ最適化方法の値は二つ以上足さないでください(足した結果が別の最適化方法とみなされることもあるため)。
  8. 複数の最適化方法の値を足して指定する場合,どの最適方法を指定しているのか分かりにくくなるため,コンマで区切って指定する方法をお勧めします。また,既に複数の最適化方法の値を足して指定している場合で,新たに別の最適化方法が必要になったときは,追加する値をコンマで区切って後ろに指定できます。
 
《システム定義との関係》
  1. ALTER ROUTINEに対して,システム定義のpd_optimize_levelオぺランドの指定は無効となります。
  2. システム定義のpd_floatable_besオペランド,又はpd_non_floatable_besオペランドを指定している場合,「フロータブルサーバ対象拡大(データ取り出しバックエンドサーバ)」及び「フロータブルサーバ対象限定(データ取り出しバックエンドサーバ)」の指定は無効となります。
  3. システム定義のpd_indexlock_modeオペランドにKEYを指定している場合(インデクスキー値排他の場合),「更新SQLの作業表作成抑止」の指定は無効になります。
《クライアント環境定義との関係》
ALTER ROUTINEに対して,PDSQLOPTLVLの指定は無効となります。
《SQLとの関係》
SQL文中にSQL最適化指定を指定している場合は,SQL最適化オプションよりもSQL最適化指定が優先されます。SQL最適化指定については,「2.24 SQL最適化指定」を参照してください。
《SQL最適化オプションの指定値》
SQL最適化オプションの指定値を次の表に示します。各最適化方法の内容については,マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。

表3-4 SQL最適化オプションの指定値(ALTER ROUTINE)

項番最適化方法指定値
識別子符号なし整数
1ネストループジョイン強制"FORCE_NEST_JOIN"4
2複数のSQLオブジェクト作成"SELECT_APSL"10
3フロータブルサーバ対象拡大(データ取り出しバックエンドサーバ)※1※2"FLTS_INC_DATA_BES"16
4ネストループジョイン優先"PRIOR_NEST_JOIN"32
5フロータブルサーバ候補数の拡大※2"FLTS_MAX_NUMBER"64
6ORの複数インデクス利用の優先"PRIOR_OR_INDEXES"128
7自バックエンドサーバでのグループ化,ORDER BY,DISTINCT集合関数処理※2"SORT_DATA_BES"256
8ANDの複数インデクス利用の抑止"DETER_AND_INDEXES"512
9グループ分け高速化処理"RAPID_GROUPING"1024
10フロータブルサーバ対象限定(データ取り出しバックエンドサーバ)※1※2"FLTS_ONLY_DATA_BES"2048
11データ収集用サーバの分離機能※1※2"FLTS_SEPARATE_COLLECT_SVR"2064
12インデクス利用の抑止(テーブルスキャン強制)"FORCE_TABLE_SCAN"4096
13複数インデクス利用の強制"FORCE_PLURAL_INDEXES"32768
14更新SQLの作業表作成抑止"DETER_WORK_TABLE_FOR_UPDATE"131072
15探索高速化条件の導出"DERIVATIVE_COND"262144
16スカラ演算を含むキー条件の適用"APPLY_ENHANCED_KEY_COND"524288
17プラグイン提供関数からの一括取得機能"PICKUP_MULTIPLE_ROWS_PLUGIN"1048576​
18導出表の条件繰り込み機能"MOVE_UP_DERIVED_COND"2097152​
注※1
フロータブルサーバ対象拡大(データ取り出しバックエンドサーバ),及びフロータブルサーバ対象限定(データ取り出しバックエンドサーバ)を共に指定した場合,それぞれの最適化方法は有効にはなりません。代わりに,データ収集用サーバの分離機能として動作します。
注※2
HiRDB/シングルサーバの場合,指定しても無効となります。
〔ADD OPTIMIZE LEVEL SQL拡張最適化オプション〔,SQL拡張最適化オプション〕…〕
データベースの状態を考慮して,最も効率的なアクセスパスを決定するための最適化の方法を指定します。
SQL拡張最適化オプションは,識別子(文字列)で指定する方法と,数値で指定する方法があります。
省略した場合,前回のSQLオブジェクト作成時(CREATE PROCEDURE,ALTER PROCEDURE,CREATE TYPE,ALTER ROUTINE,CREATE TRIGGER,又はALTER TRIGGER)に採用した値が仮定されます。
識別子で指定する場合:

ADD OPTIMIZE LEVEL "識別子"〔,"識別子"〕…

<指定例>
  • 「コストベース最適化モード2の適用」及び「ハッシュジョイン,副問合せのハッシュ実行」を適用する場合
    ADD OPTIMIZE LEVEL "COST_BASE_2","APPLY_HASH_JOIN"
  • すべての最適化を適用しない場合
    ADD OPTIMIZE LEVEL "NONE"
<規則>
  1. 識別子は一つ以上指定してください。
  2. 識別子を二つ以上指定する場合は,コンマ(,)で区切ってください。
  3. 識別子に指定できる内容(最適化方法)については,「表3-5 SQL拡張最適化オプションの指定値(ALTER ROUTINE)」を参照してください。
  4. すべての最適化を適用しない場合は,識別子に"NONE"を指定してください。
  5. 識別子は大文字及び小文字で指定できます。
  6. 同じ識別子を二つ以上指定しても,一つ指定したものとみなされますが,なるべく同じ識別子は指定しないようにしてください。
 
数値で指定する場合:

ADD OPTIMIZE LEVEL 符号なし整数〔,符号なし整数〕…

<指定例>
  • 「コストベース最適化モード2の適用」及び「ハッシュジョイン,副問合せのハッシュ実行」を適用する場合
    ADD OPTIMIZE LEVEL 1,2
  • すべての最適化を適用しない場合
    ADD OPTIMIZE LEVEL 0
<規則>
  1. 符号なし整数は一つ以上指定してください。
  2. 符号なし整数を二つ以上指定する場合は,コンマ(,)で区切ってください。
  3. 符号なし整数に指定できる内容(最適化方法)については,「表3-5 SQL拡張最適化オプションの指定値(ALTER ROUTINE)」を参照してください。
  4. すべての最適化を適用しない場合は,符号なし整数に0を指定してください。
  5. 同じ符号なし整数を二つ以上指定しても,一つ指定したものとみなされますが,なるべく同じ符号なし整数は指定しないようにしてください。
 
《システム定義との関係》
ALTER ROUTINEに対して,システム定義のpd_optimize_levelオぺランドの指定は無効となります。
《クライアント環境定義との関係》
ALTER PROCEDUREに対して,PDADDITIONALOPTLVLの指定は無効となります。
《SQLとの関係》
SQL文中にSQL最適化指定を指定している場合は,SQL最適化オプションよりもSQL最適化指定が優先されます。SQL最適化指定については,「2.24 SQL最適化指定」を参照してください。
《SQL拡張最適化オプションの指定値》
SQL拡張最適化オプションの指定値を次の表に示します。各最適化方法の内容については,マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。

表3-5 SQL拡張最適化オプションの指定値(ALTER ROUTINE)

項番最適化方法指定値
識別子符号なし整数
1コストベース最適化モード2の適用"COST_BASE_2"1
2ハッシュジョイン,副問合せのハッシュ実行"APPLY_HASH_JOIN"2
3値式に対する結合条件適用機能"APPLY_JOIN_COND_FOR_VALUE_EXP"32
4ジョインを含むSQL文の外部サーバ実行の抑止"DETER_JOIN_SQL"67108864​
5直積を含むSQL文の外部サーバ実行の強制"FORCE_CROSS_JOIN_SQL"134217728​
6無条件に生成する,外部サーバで実行できる探索高速化条件の導出の抑止"DETER_FSVR_DERIVATIVE_COND"1073741824​
注1
項番2~6は,「コストベース最適化モード2の適用」を指定した場合,有効となります。
注2
項番4~6は,外部表を検索する場合に有効となる最適化です。それ以外の場合は無効となります。
〔SUBSTR LENGTH 文字の最大長〕
1文字を表現する最大バイト数を指定します。
文字の最大長に指定できる値は,3~6です。
pdntenvコマンド(UNIX版の場合はpdsetupコマンド)で文字コード種別にutf-8を指定した場合にだけ有効となり,スカラ関数SUBSTRの結果の長さに影響します。SUBSTRについては,「2.16.1(21) SUBSTR」を参照してください。
<規則>
バージョン08-00より前のHiRDBからバージョン08-00以降のHiRDBにバージョンアップする場合は,3を仮定します。文字の最大長を変更する必要がない場合は,バージョン08-00以降のHiRDBにバージョンアップしたときにこのオペランドを指定する必要はありません。
《システム定義との関係》
ALTER ROUTINEに対して,システム定義のpd_substr_lengthオぺランドの指定は無効となります。pd_substr_lengthオぺランドについては,マニュアル「HiRDB Version 8 システム定義」を参照してください。
《クライアント環境定義との関係》
ALTER ROUTINEに対して,PDSUBSTRLENの指定は無効となります。PDSUBSTRLENについては,マニュアル「HiRDB Version 8 UAP開発ガイド」を参照してください。
《pdntenvコマンド又はpdsetupコマンドで指定した文字コード種別との関係》
文字コード種別にutf-8を指定した場合だけ有効になります。
そのほかの文字コード種別の場合は,構文チェックだけ行い,指定を無視します。
このオペランドを省略した場合,前回のSQLオブジェクト作成時(CREATE PROCEDURE,ALTER PROCEDURE,CREATE FUNCTION,CREATE TYPE,ALTER ROUTINE,CREATE TRIGGER,又はALTER TRIGGERの実行時)に指定した値が仮定されます。

共通規則

  1. ALTER ROUTINEでSQLコンパイルオプションを指定する場合,再作成するルーチンの元のCREATE PROCEDURE,CREATE FUNCTION,CREATE TYPE,又はCREATE TRIGGERにSQLコンパイルオプションを反映してできるSQL文は,SQL文の最大長を超えないようにしてください。
  2. SQLコンパイルオプションの指定は手続き及びトリガに対してだけ有効となり,関数に対しては無効となります。
  3. 次の条件では,Java手続きからALTER ROUTINEを実行できません。
    • 実行中のSQLオブジェクトが再作成になる場合

留意事項

  1. ALTER ROUTINEは,OLTP下のX/Openに従ったUAPから指定できません。
  2. 複数の関数,手続き,及びトリガのSQLオブジェクトを再作成する場合,関数,手続き,及びトリガごとに自動的にCOMMIT文又はROLLBACK文が実行されます。
  3. ALTER ROUTINE実行直後にGET DIAGNOSTICS文を実行すると,ALTER ROUTINEの診断情報を取得できます。このとき,再作成が正常終了した関数,手続き,及びトリガのSQLコードは0となります。
  4. データ保証レベル,SQL最適化オプション,SQL拡張最適化オプション,及び文字の最大長は,ルーチン及びトリガの定義時,又は再作成時の指定で決まり,手続き呼出し時,関数呼出し時,及びトリガ動作実行時のシステム定義やクライアント環境定義の影響を受けません。
  5. 手続き及びトリガで使用している表(そのトリガを定義した表を除く)に対してインデクスの追加又は削除をした場合,手続き及びトリガのSQLオブジェクト中のインデクス情報が無効となります。この場合,このトリガは実行できません。また,手続き又はトリガからこの手続きを実行できないため,ALL指定でSQLオブジェクトを再作成してください。
  6. Java手続き及びJava関数はSQLオブジェクトが作成されないため,SQLオブジェクトの再作成はしません。SQLコンパイルオプションの更新だけできます。
  7. ネストするトリガがある場合,次のことに注意してください。
    • ネストするトリガの一部,又はすべてが無効状態となっている場合,1回のALTER ROUTINE実行ではすべてのトリガが有効にならないことがあります(ALTER ROUTINEはKFPA11528-Eエラーとなります)。この場合,ALTER ROUTINEが正常終了するまで,ALTER ROUTINEを繰り返し実行してください。
  8. ネストするトリガがある場合,かつトリガ動作中の探索条件に関数を指定している場合は,次のことに注意してください。
    • この関数を削除した場合,ALTER ROUTINEが正常終了しても,トリガ実行時にKFPA11529-Eエラーとなることがあります。この場合,実行時エラーとなったトリガ又はルーチンを再作成(ALTER TRIGGER又はALTER PROCEDURE)して再実行してください。実行時エラーとなるトリガ又はルーチンは,関数を削除したトリガの呼び出し元のトリガ又はルーチンです。
  9. ループするトリガがある場合,次のことに注意してください。
    • ループするトリガがすべて無効状態になっている場合,ALTER ROUTINEでの再作成はできません。この場合,ループするトリガ及びこれらのトリガを定義している表にあるすべてのトリガを削除し,再定義してください。
  10. 他ユーザが定義したパブリック関数,パブリック手続きのSQLオブジェクトを再作成した場合も,そのSQLオブジェクトの定義者は変わりません。

使用例

  1. すべての関数,手続き,及びトリガの中で,SQLオブジェクトが無効となっている関数及び手続きを再作成します。

     ALTER ROUTINE

  2. ユーザ(USER1)の関数,手続き,及びトリガをすべて再作成します。

     ALTER ROUTINE
         AUTHORIZATION USER1 ALL