Vertica Analytics Platform Version 9.2.x Documentation


Adds an external procedure to Vertica. See Implementing External Procedures in Extending Vertica for more information about external procedures.


CREATE PROCEDURE [[database.]schema.]procedure( [ argument-list] ) 
... AS 'executable'
... LANGUAGE 'language'
... USER 'OS-user'



Specifies a schema, by default public. If schema is any schema other than public, you must supply the schema name. For example:


If you specify a database, it must be the current database.


Specifies a name for the external procedure, where procedure-name conforms to conventions described in Identifiers.


A comma-delimited list of procedure arguments, where each argument is specified as follows:

[ argname ] argtype
  • argname optionally provides a descriptive name for this argument.
  • argtype must be one of the following data types supported by Vertica: BIGINT, BOOLEAN, DECIMAL, DOUBLE PRECISION, FLOAT, FLOAT8, INT, INT8, INTEGER, MONEY, NUMBER, NUMERIC, REAL, SMALLINT, TINYINT, VARCHAR.

If the procedure is defined with no arguments, supply an empty argument list.

executable The name of the executable program in the procedures directory.

Specifies the procedure language, set to EXTERNAL.


The owner of the file. The external program must allow execute privileges for this user. The user cannot be root.


Non-superuser: CREATE privilege on the schema to contain the procedure.

System Security

  • A procedure file must be owned by the database administrator (OS account) or by a user in the same group as the administrator. (The procedure file owner cannot be root.) The procedure file must also have the set UID attribute enabled, and allow read and execute permission for the group.
  • External procedures that you create with CREATE PROCEDURE are always run with Linux dbadmin privileges. If a dbadmin or pseudosuperuser grants a non-dbadmin permission to run a procedure using GRANT (Procedure), be aware that the non-dbadmin user runs the procedure with full Linux dbadmin privileges.


The following example shows how to create procedure helloplanet for external procedure file This file accepts one varchar argument.

Create the file:

echo "hello planet argument: $1" >> /tmp/myprocedure.log 

Create the procedure with the following SQL:

=> CREATE PROCEDURE helloplanet(arg1 varchar) AS '' LANGUAGE 'external' USER 'dbadmin';