PostgreSQL 8.1.4 Documentation
Prev | Fast Backward |  | Fast Forward | Next

# EXECUTE

## Name

EXECUTE -- execute a prepared statement

## Synopsis

    EXECUTE plan_name [ (parameter [, ...] ) ]

## Description

`EXECUTE` is used to execute a previously prepared statement. Since prepared statements only exist for the duration of a session, the prepared statement must have been created by a `PREPARE` statement executed earlier in the current session.

If the `PREPARE` statement that created the statement specified some parameters, a compatible set of parameters must be passed to the `EXECUTE` statement, or else an error is raised. Note that (unlike functions) prepared statements are not overloaded based on the type or number of their parameters; the name of a prepared statement must be unique within a database session.

For more information on the creation and usage of prepared statements, see PREPARE.

## Parameters

`plan_name`

  The name of the prepared statement to execute.

`parameter`

  The actual value of a parameter to the prepared statement. This must be an expression yielding a value of a type compatible with the data type specified for this parameter position in the `PREPARE` command that created the prepared statement.

## Outputs

The command tag returned by `EXECUTE` is that of the prepared statement, and not `EXECUTE`.

## Examples

Examples are given in the Examples section of the PREPARE documentation.

## Compatibility

The SQL standard includes an `EXECUTE` statement, but it is only for use in embedded SQL. This version of the `EXECUTE` statement also uses a somewhat different syntax.

## See Also

DEALLOCATE, PREPARE

Prev | Home | Next
END | Up | EXPLAIN