ALTER
FUNCTION
文は、無効なスタンドアロン・ストアド・ファンクションを明示的に再コンパイルします。 明示的に再コンパイルすることによって、実行時に暗黙的に再コンパイルする必要がなくなり、また、実行時のコンパイル・エラーとパフォーマンス上のオーバーヘッドもなくなります。
注意: この文では、既存のファンクションの宣言または定義は変更されません。 スタンドアロン・ストアド・ファンクションを再宣言または再定義するには、CREATE FUNCTION文をOR REPLACE 句とともに使用します。 |
前提条件
ファンクションが自身のスキーマ内にある必要があります。自身のスキーマ内にない場合は、ALTER
ANY
PROCEDURE
システム権限が必要です。
構文
alter_function::=
compiler_parameters_clause::=
キーワードとパラメータの説明
schema
ファンクションが含まれているスキーマを指定します。 schema
を省略すると、ファンクションは自身のスキーマ内に存在するとみなされます。
function
再コンパイルするファンクションの名前を指定します。
COMPILE
COMPILE
を指定すると、データベースでファンクションを再コンパイルできます。 COMPILE
キーワードは必須です。 データベースによってファンクションが正常にコンパイルされない場合は、SQL*PlusコマンドSHOW
ERRORS
を使用して、関連付けられているコンパイラ・エラー・メッセージを確認できます。
再コンパイル中、コンパイラの永続的なスイッチ設定はすべて削除され、セッションから再度取得されてコンパイルの最後に格納されます。 この処理を回避するには、REUSE
SETTINGS
句を指定します。
DEBUG
を指定すると、PL/SQLデバッガで使用するためのコードを生成して格納するようにPL/SQLコンパイラに指示できます。 この句を指定した場合の効果は、compiler_parameters_clause
でPLSQL_DEBUG
= TRUE
を指定した場合と同じです。
この句を使用すると、PL/SQLの永続的なコンパイラ・パラメータのいずれかに対して値を指定できます。 コンパイル時のこれらの初期化パラメータの値は、ユニットのメタデータとともに格納されます。 このようなパラメータの値は、適切な*_PLSQL_OBJECT_SETTINGS
ビューを問い合せて確認できます。 PL/SQLの永続的なパラメータは、PLSQL_OPTIMIZE_LEVEL
、PLSQL_CODE_TYPE
、PLSQL_DEBUG
、PLSQL_WARNINGS
、PLSQL_CCFLAGS
およびNLS_LENGTH_SEMANTICS
です。
各パラメータは、それぞれの文で1回のみ指定できます。 各設定は、現在コンパイルされているライブラリ・ユニットに対してのみ有効であり、このセッションまたはシステムの他のコンパイルには影響しません。 セッションまたはシステム全体に影響を与えるには、ALTER
SESSION
またはALTER
SYSTEM
文を使用してパラメータの値を設定する必要があります。
この句からいずれかのパラメータを省略してREUSE SETTINGS
を指定した場合に、このライブラリ・ユニットの以前のコンパイルでそのパラメータの値が指定されていると、データベースによって以前の値が使用されます。 いずれかのパラメータを省略した場合に、REUSE SETTINGS
を指定しないか、または以前のコンパイルでそのパラメータの値が指定されていないと、データベースによってセッション環境からそのパラメータの値が取得されます。
compiler_parameters_clauseに対する制限 DEBUG
を指定する場合、PLSQL_DEBUG
パラメータの値は設定できません。いずれの句もPLSQL_DEBUG
パラメータを設定しますが、各パラメータに値を指定できるのは1回のみのためです。
参照:
|
REUSE
SETTINGS
を指定すると、Oracleによってコンパイラ・スイッチ設定が削除および再取得されないようにすることができます。 この句を指定すると、Oracleによって既存の設定が保持され、この文の他の場所に値が指定されていないパラメータの再コンパイルにその設定が使用されます。
下位互換性を保つために、この文によって設定されるPLSQL_CODE_TYPE
およびPLSQL_DEBUG
パラメータの値が反映されるように、PLSQL_COMPILER_FLAGS
初期化パラメータの永続的に格納される値がデータベースによって設定されます。
参照:
|
例
ファンクションの再コンパイル: 例 サンプル・ユーザーoe
が所有しているファンクションget_bal
を明示的に再コンパイルするには、次の文を発行します。
ALTER FUNCTION oe.get_bal COMPILE;
get_bal
の再コンパイル中にデータベースでコンパイル・エラーが発生しなかった場合、get_bal
は有効となります。その後、データベースでは、実行時に再コンパイルせずにこのファンクションを実行できます。 get_bal
の再コンパイル時にコンパイル・エラーが発生した場合は、データベースによってエラーが戻され、get_bal
は無効なままになります。
また、データベースによって、get_bal
に依存するオブジェクトもすべて無効にされます。 その後、最初に明示的に再コンパイルせずにこれらのオブジェクトのいずれかを参照すると、データベースによって実行時にそのオブジェクトが暗黙的に再コンパイルされます。
関連トピック