CALL
CALL — вызвать процедуру
Синтаксис
CALLимя( [аргумент] [, ...] )
Описание
CALL вызывает процедуру.
Если у процедуры есть выходные параметры, возвращается строка результата, содержащая значения этих параметров.
Параметры
имяИмя процедуры (возможно, дополненное схемой).
аргументВыражение, определяющее аргумент для вызова процедуры.
В аргументе может передаваться имя параметра в записи
. Это работает так же, как и с обычными вызовами функций; за подробностями обратитесь к Разделу 4.3.имя=>значениеАргументы должны задаваться для всех параметров процедуры, для которых не определены значения по умолчанию, включая параметры
OUT. Однако аргументы, соответствующие параметрамOUT, не вычисляются, поэтому вместо них обычно часто просто пишутNULL. (Если передавать в параметрахOUTкакие-то другие значения, возможны проблемы совместимости с будущими версиями Postgres Pro.)
Примечания
Чтобы вызывать процедуру, пользователь должен иметь право EXECUTE для неё.
Для вызова функции (не процедуры) следует использовать SELECT.
Если CALL выполняется в блоке транзакции, вызываемая процедура не может выполнять операторы управления транзакциями. Такие операторы допускаются, только если CALL выполняется в собственной транзакции.
Выходные параметры команд CALL в PL/pgSQL обрабатываются по-другому; см. Подраздел 45.6.3.
Примеры
CALL do_db_maintenance();
Совместимость
Команда CALL соответствует стандарту SQL, за исключением особенности обработки выходных параметров. Стандарт говорит, что для получения значений таких параметров нужно указывать переменные.
См. также
CREATE PROCEDURECALL
CALL — invoke a procedure
Synopsis
CALLname( [argument] [, ...] )
Description
CALL executes a procedure.
If the procedure has any output parameters, then a result row will be returned, containing the values of those parameters.
Parameters
nameThe name (optionally schema-qualified) of the procedure.
argumentAn argument expression for the procedure call.
Arguments can include parameter names, using the syntax
. This works the same as in ordinary function calls; see Section 4.3 for details.name=>valueArguments must be supplied for all procedure parameters that lack defaults, including
OUTparameters. However, arguments matchingOUTparameters are not evaluated, so it's customary to just writeNULLfor them. (Writing something else for anOUTparameter might cause compatibility problems with future Postgres Pro versions.)
Notes
The user must have EXECUTE privilege on the procedure in order to be allowed to invoke it.
To call a function (not a procedure), use SELECT instead.
If CALL is executed in a transaction block, then the called procedure cannot execute transaction control statements. Transaction control statements are only allowed if CALL is executed in its own transaction.
PL/pgSQL handles output parameters in CALL commands differently; see Section 45.6.3.
Examples
CALL do_db_maintenance();
Compatibility
CALL conforms to the SQL standard, except for the handling of output parameters. The standard says that users should write variables to receive the values of output parameters.