ALTER PROCEDURE (外部)

ALTER PROCEDURE (外部) ステートメントは、現行サーバーで外部プロシージャーを変更します。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込むことができ、また対話式に呼び出すこともできます。 これは、動的に準備できる実行可能ステートメントです。

権限

このステートメントの権限 ID が保持する特権には、少なくとも以下の 1 つ が含まれていなければなりません。

  • ステートメント内で識別されるプロシージャーに対しては次のもの。
    • そのプロシージャーに対する ALTER 特権、および
    • そのプロシージャーを含むライブラリーに対する *EXECUTE システム権限
  • データベース管理者権限

別の外部プログラムが指定されている場合、ステートメントの権限 ID によって保持される特権には、新規の外部プロシージャーを作成するために必要な同一特権が含まれていなければなりません。詳しくは、CREATE PROCEDURE (外部)を参照してください。

SQL 特権に対応するシステム権限の説明については、『関数またはプロシージャーへの権限を検査する際の対応するシステム権限』、『表またはビューへの権限を検査する際の対応するシステム権限』、および『特殊タイプへの権限を検査する際の対応するシステム権限』を参照してください。

構文

構文図を読む構文図をスキップする
>>-ALTER-------------------------------------------------------->

>--+-PROCEDURE--procedure-name--+------------------------------+-+-->
   |                            '-(--+--------------------+--)-' |   
   |                                 | .-,--------------. |      |   
   |                                 | V                | |      |   
   |                                 '---parameter-type-+-'      |   
   '-SPECIFIC PROCEDURE--specific-name---------------------------'   

   .-ALTER-.                
>--+-------+--option-list--------------------------------------><

parameter-type

|----data-type--+------------+----------------------------------|
                '-AS LOCATOR-'     

data-type

|--+-built-in-type------+---------------------------------------|
   +-distinct-type-name-+   
   '-array-type-name----'   


構文図を読む構文図をスキップする
option-list

|--+-----------------------+------------------------------------>
   '-LANGUAGE--+-C-------+-'   
               +-C++-----+     
               +-CL------+     
               +-COBOL---+     
               +-COBOLLE-+     
               +-JAVA----+     
               +-PLI-----+     
               +-REXX----+     
               +-RPG-----+     
               '-RPGLE---'     

>--+----------------------------------------+------------------->
   '-+-PARAMETER STYLE SQL----------------+-'   
     +-PARAMETER STYLE GENERAL------------+     
     +-PARAMETER STYLE GENERAL WITH NULLS-+     
     +-PARAMETER STYLE JAVA---------------+     
     '-PARAMETER STYLE DB2GENERAL---------'     

                         (1)                          
>--+-------------------+------+-------------------+------------->
   +-NOT DETERMINISTIC-+      +-MODIFIES SQL DATA-+   
   '-DETERMINISTIC-----'      +-READS SQL DATA----+   
                              +-CONTAINS SQL------+   
                              '-NO SQL------------'   

   .-CALLED ON NULL INPUT-.  .-INHERIT SPECIAL REGISTERS-.   
>--+----------------------+--+---------------------------+------>

>--+------------------------------+--+-----------+-------------->
   '-DYNAMIC RESULT SETS--integer-'  +-NO DBINFO-+   
                                     '-DBINFO----'   

>--+---------------------+--+------------+---------------------->
   +-ALLOW DEBUG MODE----+  +-FENCED-----+   
   +-DISABLE DEBUG MODE--+  '-NOT FENCED-'   
   '-DISALLOW DEBUG MODE-'                   

>--+--------------------------------------+--------------------->
   '-EXTERNAL NAME--external-program-name-'   

>--+---------------------+--+-+----------------------+-+--------|
   +-OLD SAVEPOINT LEVEL +  | +-COMMIT ON RETURN NO--+ |   
   '-NEW SAVEPOINT LEVEL '  | '-COMMIT ON RETURN YES-' |   
                            '-AUTONOMOUS---------------'   
注:
  1. option-list 内の文節は、どのような順番で指定してもかまいません。
構文図を読む構文図をスキップする
built-in-type

|--+-+---SMALLINT---+--------------------------------------------------------------------------+--|
   | +-+-INTEGER-+--+                                                                          |   
   | | '-INT-----'  |                                                                          |   
   | '---BIGINT-----'                                                                          |   
   |                  .-(5,0)------------------------.                                         |   
   +-+-+-DECIMAL-+-+--+------------------------------+-----------------------------------------+   
   | | '-DEC-----' |  |             .-,0--------.    |                                         |   
   | '-+-NUMERIC-+-'  '-(--integer--+-----------+--)-'                                         |   
   |   '-NUM-----'                  '-, integer-'                                              |   
   |          .-(--53--)------.                                                                |   
   +-+-FLOAT--+---------------+-+--------------------------------------------------------------+   
   | |        '-(--integer--)-' |                                                              |   
   | +-REAL---------------------+                                                              |   
   | |         .-PRECISION-.    |                                                              |   
   | '-DOUBLE--+-----------+----'                                                              |   
   |             .-(--34--)-.                                                                  |   
   +---DECFLOAT--+----------+------------------------------------------------------------------+   
   |             '-(--16--)-'                                                                  |   
   |                    .-(--1--)-------.                                                      |   
   +-+-+-+-CHARACTER-+--+---------------+----------+--+----------------+---------------------+-+   
   | | | '-CHAR------'  '-(--integer--)-'          |  +-FOR BIT DATA---+                     | |   
   | | '-+-+-CHARACTER-+--VARYING-+--(--integer--)-'  +-FOR SBCS DATA--+                     | |   
   | |   | '-CHAR------'          |                   +-FOR MIXED DATA-+                     | |   
   | |   '-VARCHAR----------------'                   '-ccsid-clause---'                     | |   
   | |                                          .-(--1M--)-------------.                     | |   
   | '-----+-+-CHARACTER-+--LARGE OBJECT-+------+----------------------+--+----------------+-' |   
   |       | '-CHAR------'               |      '-(--integer--+---+--)-'  +-FOR SBCS DATA--+   |   
   |       '-CLOB------------------------'                    +-K-+       +-FOR MIXED DATA-+   |   
   |                                                          +-M-+       '-ccsid-clause---'   |   
   |                                                          '-G-'                            |   
   |                .-(--1--)-------.                                                          |   
   +-+---GRAPHIC----+---------------+-------+--+--------------+--------------------------------+   
   | |              '-(--integer--)-'       |  '-ccsid-clause-'                                |   
   | +-+-GRAPHIC VARYING-+--(--integer--)---+                                                  |   
   | | '-VARGRAPHIC------'                  |                                                  |   
   | |             .-(--1M--)-------------. |                                                  |   
   | '---DBCLOB----+----------------------+-'                                                  |   
   |               '-(--integer--+---+--)-'                                                    |   
   |                             +-K-+                                                         |   
   |                             +-M-+                                                         |   
   |                             '-G-'                                                         |   
   |                             .-(--1--)-------.                                             |   
   +-+-+-+-NATIONAL CHARACTER-+--+---------------+----------+---------------------+------------+   
   | | | +-NATIONAL CHAR------+  '-(--integer--)-'          |                     |            |   
   | | | '-NCHAR--------------'                             |                     |            |   
   | | '-+-+-NATIONAL CHARACTER-+--VARYING-+--(--integer--)-'                     |            |   
   | |   | +-NATIONAL CHAR------+          |                                      |            |   
   | |   | '-NCHAR--------------'          |                                      |            |   
   | |   '-NVARCHAR------------------------'                                      |            |   
   | |                                                   .-(--1M--)-------------. |            |   
   | '-----+-+-NATIONAL CHARACTER-+--LARGE OBJECT-+------+----------------------+-'            |   
   |       | '-NCHAR--------------'               |      '-(--integer--+---+--)-'              |   
   |       '-NCLOB--------------------------------'                    +-K-+                   |   
   |                                                                   +-M-+                   |   
   |                                                                   '-G-'                   |   
   |             .-(--1--)-------.                                                             |   
   +-+-+-BINARY--+---------------+---------+-----------------+---------------------------------+   
   | | |         '-(--integer--)-'         |                 |                                 |   
   | | '-+-BINARY VARYING-+--(--integer--)-'                 |                                 |   
   | |   '-VARBINARY------'                                  |                                 |   
   | |                              .-(--1M--)-------------. |                                 |   
   | '---+-BLOB----------------+----+----------------------+-'                                 |   
   |     '-BINARY LARGE OBJECT-'    '-(--integer--+---+--)-'                                   |   
   |                                              +-K-+                                        |   
   |                                              +-M-+                                        |   
   |                                              '-G-'                                        |   
   +-+-DATE-------------------------+----------------------------------------------------------+   
   | |       .-(--0--)-.            |                                                          |   
   | +-TIME--+---------+------------+                                                          |   
   | |            .-(--6--)-------. |                                                          |   
   | '-TIMESTAMP--+---------------+-'                                                          |   
   |              '-(--integer--)-'                                                            |   
   |             .-(--200--)-----.                                                             |   
   +---DATALINK--+---------------+--+--------------+-------------------------------------------+   
   |             '-(--integer--)-'  '-ccsid-clause-'                                           |   
   +---ROWID-----------------------------------------------------------------------------------+   
   '---XML-------------------------------------------------------------------------------------'   

ccsid-clause

|--CCSID--integer-----------------------------------------------|

説明

PROCEDURE または SPECIFIC PROCEDURE
変更するプロシージャーを識別します。procedure-name では、現行サーバーに存在する外部プロシージャーを指定する必要があります。

指定したプロシージャーが変更されます。 プロシージャーの所有者は保持されます。プロシージャーが変更された時点で外部プログラムまたはサービス・プログラムが存在する場合、プロシージャーに対するすべての特権が保持されます。

PROCEDURE procedure-name
プロシージャーを名前によって識別します。 procedure-name では、ただ 1 つの外部プロシージャーを指定する必要があります。 このプロシージャーには、パラメーターをいくつでも定義することができます。 指定されたスキーマまたは暗黙のスキーマの中に、 指定された名前のプロシージャーが複数ある場合、エラーが戻されます。
PROCEDURE procedure-name (parameter-type,...)
プロシージャーを一意的に識別するプロシージャー・シグニチャーによって、プロシージャーを識別します。 procedure-name (parameter-type,...) では、指定されたプロシージャー・シグニチャーを持つ 外部プロシージャーを識別する必要があります。指定されたパラメーターは、プロシージャーの作成時に指定された、 対応する位置にあるデータ・タイプと一致していなければなりません。 変更される特定のプロシージャー・インスタンスを識別する場合、データ・タイプの数とデータ・タイプの論理連結が使用されます。 データ・タイプの同義語は、一致として扱われます。 デフォルトがあるパラメーターは、このシグニチャーに含まれていなければなりません。

プロシージャー名 () を指定する場合、識別されるプロシージャー にパラメーターを使用することはできません。

procedure-name
プロシージャーの名前を識別します。
(parameter-type,...)
プロシージャーのパラメーターを識別します。

非修飾の特殊タイプ名または配列タイプ名を指定する場合、データベース・マネージャーはその特殊タイプまたは配列タイプのスキーマ名を解決するための SQL パスを検索します。

長さ属性、精度属性、あるいは位取り属性があるデータ・タイプの場合、以下のいずれかを使用します。

  • 中が空の括弧は、データ・タイプが一致しているか否かの判別時にデータベース・マネージャーによって属性が無視されることを示します。 例えば、DEC() は、DEC(7,2) のデータ・タイプで定義されたプロシージャーのパラメーターに一致するものとみなされます。 ただし、精度値は特定のデータ・タイプ (REAL または DOUBLE) を示すため、 中が空の括弧で FLOAT を指定することはできません。
  • 長さ属性、精度属性、あるいは位取り属性に特定の値を指定する場合、その値は、 CREATE PROCEDURE ステートメントの中で暗黙的または明示的に指定された値と正確に一致している必要があります。 データ・タイプが FLOAT の場合、 突き合わせはデータ・タイプ (REAL または DOUBLE) に基づいて行われるので、 精度は指定された値に厳密に一致している必要はありません。
  • 長さ属性、精度属性、または位取り属性が明示的に指定されておらず、空の括弧も指定されていない場合、該当のデータ・タイプのデフォルト属性が暗黙指定されます。暗黙の長さは、CREATE PROCEDURE ステートメントの中で暗黙的または明示的 に指定された値と正確に一致している必要があります。

FOR DATA 文節または CCSID 文節の指定はオプショナルです。 いずれの文節も指定しないと、データ・タイプが一致するかどうかを判定する場合に、データベース・マネージャーが属性を無視することを示します。 どちらか一方の文節を指定する場合は、CREATE PROCEDURE ステートメントに 暗黙的または明示的に指定されている値と一致させる必要があります。

AS LOCATOR
プロシージャーが、このパラメーターのロケーターを受け取るように定義されることを示します。 AS LOCATOR を指定する場合は、データ・タイプは LOB または XML、あるいは LOB または XML に基づく特殊タイプでなければなりません。
SPECIFIC PROCEDURE specific-name
プロシージャーを特定名によって識別します。 specific-name は、現行サーバーに存在してい る特定のプロシージャーを識別していなければなりません。
ALTER option-list
プロシージャーの 1 つ以上のオプションが変更されることを示します。 オプションが指定されない場合は、既存のプロシージャー定義での値が使用されます。 各オプションの説明については、CREATE PROCEDURE (外部)を参照してください。

注

プロシージャーの定義または変更に関する一般考慮事項: プロシージャーの定義に関する一般情報については、CREATE PROCEDURE を参照してください。ALTER PROCEDURE (外部) を使用すると、プロシージャーに関する特権を保持したままで、個々の属性を変更できます。

代替構文: 以下のキーワードは、旧リリースとの互換性を維持するためにサポートされている同義語です。 これらのキーワードは標準キーワードではないので、原則として使用しないようにしてください。

  • キーワード VARIANT と NOT VARIANT は、NOT DETERMINISTIC と DETERMINISTIC の同義語として使用することができます。
  • キーワード NULL CALL は、CALLED ON NULL INPUT の同義語として使用できます。
  • DYNAMIC RESULT SET、RESULT SETS、および RESULT SET は、DYNAMIC RESULT SETS の同義語として使用できます。
  • SQL の同義語として、値 DB2SQL を使用できます。

例

MYPROC プロシージャーの定義を変更して、そのプロシージャーの呼び出し時に起動する外部プログラムの名前を変更します。外部プログラムの名前は、PROG10A です。

  ALTER PROCEDURE MYPROC 
    EXTERNAL NAME PROG10A
親トピック: ステートメント