ALTER FUNCTION

The ALTER FUNCTION statement is used to change one or more characteristics of a stored function.

The syntax for the ALTER FUNCTION statement is as follows:

ALTER FUNCTION func_name [characteristic ...]

characteristic: {
    COMMENT 'string'
  | LANGUAGE SQL
  | { CONTAINS SQL | NO SQL | READS SQL DATA | MODIFIES SQL DATA }
  | SQL SECURITY { DEFINER | INVOKER }
}

The ALTER FUNCTION statement cannot be used to change the parameters or body of a stored function. If such changes are needed, you must use DROP FUNCTION and CREATE FUNCTION to drop and recreate the function.

You must have the ALTER ROUTINE privilege for the function. By default, this privilege is automatically granted to the function creator.

The characteristics of routine usage data are as follows:

• CONTAINS SQL indicates that the routine does not contain statements that read or write data. This is the default value. For example, statements like SET@x=1 or DO RELEASE_LOCK('abc') are executed but do not read or write data.

• NO SQL indicates that the routine does not contain SQL statements.

• READS SQL DATA indicates that the routine contains statements that read data (such as SELECT) but do not write data.

• MODIFIES SQL DATA indicates that the routine contains statements that may write data (such as INSERT or DELETE).

The SQL SECURITY option can be set to DEFINER or INVOKER to specify whether the routine is executed using the privileges of the specified user (who must have access to the database associated with the routine) or the privileges of the caller. The default value is DEFINER. The user calling the routine must have the EXECUTE privilege for the routine.

Here is an example of the ALTER FUNCTION statement:

obclient> ALTER FUNCTION my_func LANGUAGE SQL READS SQL DATA  COMMENT 'Example';
Query OK, 0 rows affected