3.3.1　ALTER PROCEDUREの形式と規則

(a)　〔認可識別子.〕ルーチン識別子

特定の手続きのSQLオブジェクトだけを再作成する場合に指定します。

指定された手続きのインデクス情報が有効か無効か，又はSQLオブジェクトが有効か無効かにかかわらず，必ずSQLオブジェクトを再作成します。

SQLコンパイルオプションの変更のために使用します。

認可識別子

SQLオブジェクトを再作成する手続きの所有者の認可識別子を指定します。

パブリック手続きのSQLオブジェクトを再作成する場合は，認可識別子にPUBLICを指定します。

ルーチン識別子

SQLオブジェクトを再作成する手続き名を指定します。

(b)　〔AUTHORIZATION 認可識別子〕

〔ALL｜INDEX USING〔認可識別子.〕表識別子〕

再作成する手続きを，手続きの所有者の認可識別子と，手続きの状態で指定します。

〔AUTHORIZATION 認可識別子〕

手続きの所有者の認可識別子を指定して，そのユーザが所有するすべての手続き（そのユーザが定義したパブリック手続きを含む）のSQLオブジェクトを再作成します。

このオペランドを省略した場合，システム内のすべての手続きのSQLオブジェクトを再作成します。

ただし，実際にSQLオブジェクトを再作成するかどうかは，ALL句，INDEX USING句の指定との組み合わせによって決まります。

認可識別子

SQLオブジェクトを再作成する手続きの所有者の認可識別子を指定します。

〔ALL｜INDEX USING〔認可識別子.〕表識別子〕

どの状態の手続きの，SQLオブジェクトを再作成するかを指定します。

ALL句，INDEX USING句のどちらも指定しなかった場合，SQLオブジェクトが無効な手続きだけを再作成します。

ALL

指定した手続きのSQLオブジェクトが有効か無効か，また，インデクス情報が有効か無効かにかかわらず，すべて再作成する場合に指定します。

INDEX USING〔認可識別子.〕表識別子

インデクス情報が無効な手続きのSQLオブジェクトだけを再作成します。

インデクスの追加又は削除をした場合に，手続きのSQLオブジェクト中のインデクス情報が無効となるため，インデクスを追加又は削除した実表の表識別子を指定して，その表を使用するSQLオブジェクトでインデクス情報が無効なすべての手続きのSQLオブジェクトを再作成します。

なお，手続きのSQLオブジェクト中のインデクス情報だけが無効な場合でも，その手続きを実行できますが，インデクス情報が有効な場合の方が性能は良くなります。

指定した実表又はビュー表を基表として定義したビュー表を使用している手続きについても，インデクス情報が無効ならばSQLオブジェクトを再作成します。

INDEX USING句を指定すると，インデクス情報だけが無効な手続きのSQLオブジェクトを再作成しますが，SQLオブジェクトが無効な手続きについては再作成しません。SQLオブジェクトが無効な手続きの再作成が必要な場合は，別途，INDEX USING句を省略するか，ALL指定でALTER PROCEDUREを発行してください。

〔認可識別子.〕表識別子

SQLオブジェクトを再作成する手続きが使用する実表又はビュー表の所有者の認可識別子と表識別子を指定します。

認可識別子を省略した場合，実行ユーザの認可識別子が仮定されます。

表識別子にパブリックビューを指定する場合は，認可識別子にPUBLICを指定してください。

(c)　SQLコンパイルオプション

：：＝｛ISOLATION データ保証レベル 〔FOR UPDATE ｛EXCLUSIVE｜COMPATIBLE｝〕
　　　　｜OPTIMIZE LEVEL SQL最適化オプション〔，SQL最適化オプション〕…
　　　　｜ADD OPTIMIZE LEVEL SQL拡張最適化オプション〔，SQL拡張最適化オプション〕…
　　　　｜SUBSTR LENGTH 文字の最大長 ｝

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

〔ISOLATION データ保証レベル 〔FOR UPDATE ｛EXCLUSIVE｜COMPATIBLE｝〕〕

SQLのデータ保証レベルを指定します。

データ保証レベル

データ保証レベルとは，トランザクションのどの時点までデータの内容を保証するかのレベルです。次に示すデータ保証レベルを指定できます。

• 0

  データの内容を保証しない場合に指定します。

  0レベルを指定すると，ほかのユーザが更新中のデータでも，更新完了を待たないで参照できます。ただし，参照する表が共用表の場合，ほかのユーザが排他モードでLOCK文を実行しているときには，排他解除待ちとなります。

• 1

  検索処理の終了までデータの内容を保証したい場合に指定します。

  1レベルを指定すると，検索処理が終了するまで（HiRDBがページ，又は行を見終わるまで）一度検索したデータをほかのユーザは更新できません。

• 2

  トランザクションの終了まで一度検索したデータの内容を保証したい場合に指定します。

  2レベルを指定すると，トランザクションが終了するまで一度検索したデータをほかのユーザは更新できません。

このオペランドを省略した場合，前回のSQLオブジェクト作成時（CREATE PROCEDURE，ALTER PROCEDURE，又はALTER ROUTINEの実行時）に指定した値が仮定されます。

データ保証レベルについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

〔FOR UPDATE ｛EXCLUSIVE｜COMPATIBLE｝〕

手続き中で，FOR UPDATE句を指定した（FOR UPDATEが仮定される場合を含む）カーソル又は問合せに対して，SQLコンパイルオプションで指定したデータ保証レベルに関係なく，常にWITH EXCLUSIVE LOCKを仮定する場合に指定します。

このオペランドを省略した場合，EXCLUSIVEを仮定します。ただし，0904互換モードを適用している場合はCOMPATIBLEを仮定します。

バージョン09-50より前のHiRDBでFOR UPDATE EXCLUSIVEを省略した手続きと同じ動作をさせたい場合は，COMPATIBLEを指定します。

このオペランドと，ISOLATIONデータ保証レベルの関係から決まるFOR UPDATEの排他オプションを次に示します。

ISOLATION データ保証レベル	FOR UPDATE EXCLUSVIE	FOR UPDATE COMPATIBLE
0	WITH EXCLUSIVE LOCK	WITHOUT LOCK WAIT
1	WITH EXCLUSIVE LOCK	WITHOUT LOCK WAIT
2	WITH EXCLUSIVE LOCK	WITH EXCLUSIVE LOCK

《クライアント環境定義との関係》

ALTER PROCEDUREに対して，PDISLLVL，PDFORUPDATEEXLOCKの指定は無効となります。

《SQLとの関係》

手続き中のSQL文に排他オプションを指定している場合はSQLコンパイルオプションで指定するデータ保証レベル，FOR UPDATE EXCLUSIVE，及びFOR UPDATE COMPATIBLEから仮定する排他オプションよりSQL文に指定した排他オプションが優先されます。

《システム定義との関係》

ALTER PROCEDUREに対して，pd_isolation_levelオぺランドの指定は無効となります。

〔OPTIMIZE LEVEL SQL最適化オプション〔，SQL最適化オプション〕…〕

データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法を指定します。

SQL最適化オプションの指定値及びその内容については，マニュアル「HiRDB UAP開発ガイド」の「PDSQLOPTLVL」を参照してください。

SQL最適化オプションは，識別子（文字列）で指定する方法と，数値で指定する方法がありますが，通常時は識別子で指定する方法をお勧めします。

省略した場合，前回のSQLオブジェクト作成時（CREATE PROCEDURE，ALTER PROCEDURE，又はALTER ROUTINE）に採用した値が仮定されます。

識別子で指定する場合：

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

＜指定例＞

• ネストループジョイン優先とグループ分け高速化処理を適用する場合

  OPTIMIZE LEVEL "PRIOR_NEST_JOIN","RAPID_GROUPING"

• すべての最適化を適用しない場合

  OPTIMIZE LEVEL "NONE"

＜規則＞

1. 識別子は一つ以上指定してください。

2. 識別子を二つ以上指定する場合は，コンマ（，）で区切ってください。

3. すべての最適化を適用しない場合は，識別子に"NONE"を指定してください。ただし，同時に"NONE"以外の識別子を指定すると，"NONE"は無効になります。

4. 識別子は大文字及び小文字で指定できます。

5. 同じ識別子を二つ以上指定しても，一つ指定したものとみなされますが，なるべく同じ識別子は指定しないようにしてください。

数値で指定する場合：

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. すべての最適化を適用しない場合は，符号なし整数に0を指定してください。ただし，同時に0以外の識別子を指定すると，0は無効になります。

5. 同じ符号なし整数を二つ以上指定しても，一つ指定したものとみなされますが，なるべく同じ符号なし整数は指定しないようにしてください。

6. 複数の最適化方法を指定する場合，その符号なし整数の和を指定することもできます。ただし，同じ最適化方法の値は二つ以上足さないでください（足した結果が別の最適化方法とみなされることもあるため）。

7. 複数の最適化方法の値を足して指定する場合，どの最適方法を指定しているのか分かりにくくなるため，コンマで区切って指定する方法をお勧めします。また，既に複数の最適化方法の値を足して指定している場合で，新たに別の最適化方法が必要になったときは，追加する値をコンマで区切って後ろに指定できます。

《システム定義との関係》

1. ALTER PROCEDUREに対して，システム定義のpd_optimize_levelオぺランドの指定は無効となります。

2. システム定義のpd_floatable_besオペランド，又はpd_non_floatable_besオペランドを指定している場合，「フロータブルサーバ対象拡大（データ取り出しバックエンドサーバ）」及び「フロータブルサーバ対象限定（データ取り出しバックエンドサーバ）」の指定は無効となります。

3. システム定義のpd_indexlock_modeオペランドにKEYを指定している場合（インデクスキー値排他の場合），「更新SQLの作業表作成抑止」の指定は無効になります。

《クライアント環境定義との関係》

ALTER PROCEDUREに対して，PDSQLOPTLVLの指定は無効となります。

《SQLとの関係》

SQL文中にSQL最適化指定を指定している場合は，SQL最適化オプションよりもSQL最適化指定が優先されます。SQL最適化指定については，「SQL最適化指定」を参照してください。

〔ADD OPTIMIZE LEVEL SQL拡張最適化オプション〔，SQL拡張最適化オプション〕…〕

データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法を指定します。

SQL拡張最適化オプションの指定値及びその内容については，マニュアル「HiRDB UAP開発ガイド」の「PDADDITIONALOPTLVL」を参照してください。

SQL拡張最適化オプションは，識別子（文字列）で指定する方法と，数値で指定する方法があります。

省略した場合，前回のSQLオブジェクト作成時（CREATE PROCEDURE，ALTER PROCEDURE，又はALTER ROUTINE）に採用した値が仮定されます。

識別子で指定する場合：

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

＜指定例＞

• 「コストベース最適化モード2の適用」及び「ハッシュジョイン，副問合せのハッシュ実行」を適用する場合

  ADD OPTIMIZE LEVEL "COST_BASE_2","APPLY_HASH_JOIN"

• すべての最適化を適用しない場合

  ADD OPTIMIZE LEVEL "NONE"

＜規則＞

1. 識別子は一つ以上指定してください。

2. 識別子を二つ以上指定する場合は，コンマ（,）で区切ってください。

3. すべての最適化を適用しない場合は，識別子に"NONE"を指定してください。

4. 識別子は大文字及び小文字で指定できます。

5. 同じ識別子を二つ以上指定しても，一つ指定したものとみなされますが，なるべく同じ識別子は指定しないようにしてください。

数値で指定する場合：

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

＜指定例＞

• 「コストベース最適化モード2の適用」及び「ハッシュジョイン，副問合せのハッシュ実行」を適用する場合

  ADD OPTIMIZE LEVEL 1,2

• すべての最適化を適用しない場合

  ADD OPTIMIZE LEVEL 0

＜規則＞

1. 符号なし整数は一つ以上指定してください。

2. 符号なし整数を二つ以上指定する場合は，コンマ（,）で区切ってください。

3. すべての最適化を適用しない場合は，符号なし整数に0を指定してください。

4. 同じ符号なし整数を二つ以上指定しても，一つ指定したものとみなされますが，なるべく同じ符号なし整数は指定しないようにしてください。

《システム定義との関係》

ALTER PROCEDUREに対して，システム定義のpd_optimize_levelオぺランドの指定は無効となります。

《クライアント環境定義との関係》

ALTER PROCEDUREに対して，PDADDITIONALOPTLVLの指定は無効となります。

《SQLとの関係》

SQL文中にSQL最適化指定を指定している場合は，SQL最適化オプションよりもSQL最適化指定が優先されます。SQL最適化指定については，「SQL最適化指定」を参照してください。

〔SUBSTR LENGTH 文字の最大長〕

1文字を表現する最大バイト数を指定します。

文字の最大長に指定できる値は，3〜6（pdntenvコマンド（UNIX版の場合はpdsetupコマンド）で文字コード種別にutf-8_ivsを指定した場合は3〜10）です。

pdntenvコマンド（UNIX版の場合はpdsetupコマンド）で文字コード種別にutf-8，又はutf-8_ivsを指定した場合にだけ有効となり，スカラ関数SUBSTRの結果の長さに影響します。SUBSTRについては，「SUBSTR」を参照してください。

＜規則＞

バージョン08-00より前のHiRDBからバージョン08-00以降のHiRDBにバージョンアップする場合は，3を仮定します。文字の最大長を変更する必要がない場合は，バージョン08-00以降のHiRDBにバージョンアップしたときにこのオペランドを指定する必要はありません。

《システム定義との関係》

ALTER PROCEDUREに対して，システム定義のpd_substr_lengthオぺランドの指定は無効となります。pd_substr_lengthオぺランドについては，マニュアル「HiRDB システム定義」を参照してください。

《クライアント環境定義との関係》

ALTER PROCEDUREに対して，PDSUBSTRLENの指定は無効となります。PDSUBSTRLENについては，マニュアル「HiRDB UAP開発ガイド」を参照してください。

《pdntenvコマンド又はpdsetupコマンドで指定した文字コード種別との関係》

文字コード種別にutf-8，又はutf-8_ivsを指定した場合だけ有効になります。

そのほかの文字コード種別の場合は，構文チェックだけ行い，指定を無視します。

このオペランドを省略した場合，前回のSQLオブジェクト作成時（CREATE PROCEDURE，ALTER PROCEDURE，又はALTER ROUTINEの実行時）に指定した値が仮定されます。