|Oracle9i SQL Reference
Release 2 (9.2)
Part Number A96540-02
FUNCTION statement to recompile an invalid standalone stored function. Explicit recompilation eliminates the need for implicit run-time recompilation and prevents associated run-time compilation errors and performance overhead.
This statement does not change the declaration or definition of an existing function. To redeclare or redefine a function, use the
The function must be in your own schema or you must have
PROCEDURE system privilege.
Specify the schema containing the function. If you omit
schema, Oracle assumes the function is in your own schema.
Specify the name of the function to be recompiled.
COMPILE to cause Oracle to recompile the function. The
COMPILE keyword is required. If Oracle does not compile the function successfully, you can see the associated compiler error messages with the SQL*Plus command
During recompilation, Oracle drops all persistent compiler switch settings, retrieves them again from the session, and stores them at the end of compilation. To avoid this process, specify the
DEBUG to instruct the PL/SQL compiler to generate and store the code for use by the PL/SQL debugger.
SETTINGS to prevent Oracle from dropping and reacquiring compiler switch settings. With this clause, Oracle preserves the existing settings and uses them for the recompilation.
If you specify both
SETTINGS, Oracle sets the persistently stored value of the
PLSQL_COMPILER_FLAGS parameter to
DEBUG. No other compiler switch values are changed.
PL/SQL User's Guide and Reference and Oracle9i Application Developer's Guide - Fundamentals for more information on the interaction of the
To explicitly recompile the function
get_bal owned by the sample user
oe, issue the following statement:
If Oracle encounters no compilation errors while recompiling
get_bal becomes valid. Oracle can subsequently execute it without recompiling it at run time. If recompiling
get_bal results in compilation errors, Oracle returns an error, and
get_bal remains invalid.
Oracle also invalidates all objects that depend upon
get_bal. If you subsequently reference one of these objects without explicitly recompiling it first, Oracle recompiles it implicitly at run time.