Ensures that a skeletal instance of an object exists before executing an ALTER statement.

Syntax

sa_make_object( 
  objtype,
  objname
  [, owner
  [, tabname ]  ] 
)

objtype:
'procedure' 
| 'function' 
| 'view' 
| 'trigger' 
| 'service'
| 'event'

Arguments

Remarks

This procedure is particularly useful in scripts or command files that are run repeatedly to create or modify a database schema. A common problem in such scripts is that the first time they are run, a CREATE statement must be executed, but subsequent times an ALTER statement must be executed. This procedure avoids the necessity of querying the system views to find out whether the object exists.

To use the procedure, follow it by an ALTER statement that contains the entire object definition.

Permissions

Resource authority is required to create or modify database objects

Side effects

Automatic commit

See also

• ALTER EVENT statement
• ALTER FUNCTION statement
• ALTER PROCEDURE statement
• ALTER TRIGGER statement
• ALTER VIEW statement
• ALTER SERVICE statement

Examples

The following statements ensure that a skeleton procedure definition is created, define the procedure, and grant permissions on it. A command file containing these instructions could be run repeatedly against a database without error.

CALL sa_make_object( 'procedure','myproc' );
ALTER PROCEDURE myproc( in p1 INT, in p2 CHAR(30) )
BEGIN
    // ...
END;
GRANT EXECUTE ON myproc TO public;

The following example uses the sa_make_object system procedure to add a skeleton web service.

CALL sa_make_object( 'service','my_web_service' );