ALTER PROCEDURE Statement

Replaces an existing procedure with a modified version. Include the entire modified procedure in the ALTER PROCEDURE statement, and reassign user permissions on the procedure.

Syntax

Syntax 1

ALTER PROCEDURE [ owner.]procedure-name procedure-definition

Syntax 2

ALTER PROCEDURE [ owner.]procedure-name
   REPLICATE {  ON | OFF  }

Syntax 3

ALTER PROCEDURE [ owner.]procedure-name
   SET HIDDEN

Syntax 4

ALTER PROCEDURE [ owner.]procedure-name
   RECOMPILE

Syntax 5

ALTER PROCEDURE 
   [ owner.]procedure-name ( [ parameter, …] )
   [  RESULT (result-column, ...)]
   EXTERNAL NAME ‘external-call’ [ LANGUAGE JAVA [ environment-name ] }

environment-name:
   DISALLOW | ALLOW SERVER SIDE REQUESTS

external-call:
   [column-name:]function-name@library; ...

Parameters

procedure-definition – CREATE PROCEDURE syntax following the name.

REPLICATE – if a procedure needs to be relocated to other sites using SAP Sybase Replication Server, use the REPLICATE ON clause.

SET HIDDEN – to obfuscate the definition of the associated procedure and cause it to become unreadable. The procedure can be unloaded and reloaded into other databases.
Note: This setting is irreversible. It is recommended that you retain the original procedure definition outside of the database.

RECOMPILE – recompiles a stored procedure. When you recompile a procedure, the definition stored in the catalog is re-parsed and the syntax is verified.
The procedure definition is not changed by recompiling. You can recompile procedures with definitions hidden with the SET HIDDEN clause, but their definitions remain hidden.

RESULT – for procedures that generate a result set but do not include a RESULT clause, the database server attempts to determine the result set characteristics for the procedure and stores the information in the catalog. This can be useful if a table referenced by the procedure has been altered to add, remove, or rename columns since the procedure was created.

environment-name – DISALLOW is the default. ALLOW indicates that server-side connections are allowed.
Note:
- Do not specify ALLOW unless necessary. Use of teh ALLOW clause slows down certain types of SAP Sybase IQ table joins.
- Do not use UDFs with both ALLOW SERVER SIDE REQUESTS and DISALLOW SERVER SIDE REQUESTS clauses in the same query.

Usage

The ALTER PROCEDURE statement must include the entire new procedure. You can use PROC as a synonym for PROCEDURE. Both Watcom and Transact-SQL dialect procedures can be altered through the use of ALTER PROCEDURE. Existing permissions on the procedure are not changed. If you execute DROP PROCEDURE followed by CREATE PROCEDURE, execute permissions are reassigned.

You cannot combine Syntax 2 with Syntax 1.

When using the ALTER PROCEDURE statement for table UDFs, the same set of restrictions apply as for the CREATE PROCEDURE Statement (External Procedures).

Standards

SQL—Vendor extension to ISO/ANSI SQL grammar.
Sybase—Not supported by Adaptive Server Enterprise.

Permissions

Alter a Watcom-SQL or Transcat-SQL procedure – Requires one of:

ALTER ANY PROCEDURE system privilege.
ALTER ANY OBJECT system privilege.
You own the procedure.

Alter an external C/C++ or external environment procedure – Requires CREATE EXTERNAL REFERENCE system privilege. Also requires one of:

ALTER ANY PROCEDURE system privilege.
ALTER ANY OBJECT system privilege.
You own the procedure.