SQL COMMAND · 函数与过程
CALL
调用一个过程
CALL函数与过程引入 11现存至 20 devel0 次语法变更
- 动词
CALL- 对象
—- 分组
- 函数与过程
- 引入版本
- 11
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
CALL name ( [ argument ] [, ...] )
描述
CALL执行一个过程。
如果该过程有任何输出参数,则会返回一行结果,其中包含这些参数的值。
参数
name过程的名称(可以是模式限定的)。
argument过程调用的参数表达式。
参数中可以包含参数名,使用语法
。 这与普通函数调用中的工作方式相同;详见Section 4.3。name=>value对于所有没有默认值的过程参数,都必须提供参数,包括
OUT参数。 不过,与OUT参数匹配的实参不会被求值, 因此通常只需写成NULL。 (如果为OUT参数写入其他内容, 可能会与未来的PostgreSQL版本产生兼容性问题。)
注解
用户必须拥有该过程的EXECUTE权限,才能调用它。
若要调用函数(而不是过程),请改用SELECT。
如果在事务块中执行CALL,则被调用的过程不能执行事务控制语句。 只有当CALL作为独立事务执行时,才允许使用事务控制语句。
PL/pgSQL对CALL命令中的输出参数采用不同的处理方式; 参见Section 41.6.3。
示例
CALL do_db_maintenance();
兼容性
CALL符合 SQL 标准,但对输出参数的处理除外。 标准规定用户应写变量来接收输出参数的值。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 14← 13正文更新
正文更新PostgreSQL 12← 11正文更新
正文更新PostgreSQL 11← 10新增此命令
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
CALL | CALL | — | — | |
| 调用一个过程 | 现存 | |||
DO | DO | — | — | |
| 执行匿名代码块 | 现存 | |||
CREATE AGGREGATE | CREATE | AGGREGATE | 203 次 | |
| 定义一个新的聚合函数 | 现存 | |||
ALTER AGGREGATE | ALTER | AGGREGATE | 141 次 | |
| 更改一个聚合函数的定义 | 现存 | |||
DROP AGGREGATE | DROP | AGGREGATE | — | |
| 移除一个聚合函数 | 现存 | |||
CREATE FUNCTION | CREATE | FUNCTION | 143 次 | |
| 定义一个新函数 | 现存 | |||
ALTER FUNCTION | ALTER | FUNCTION | 143 次 | |
| 更改函数的定义 | 现存 | |||
DROP FUNCTION | DROP | FUNCTION | — | |
| 移除一个函数 | 现存 | |||
CREATE LANGUAGE | CREATE | LANGUAGE | 131 次 | |
| 定义一种新的过程语言 | 现存 | |||
ALTER LANGUAGE | ALTER | LANGUAGE | 141 次 | |
| 更改一种过程语言的定义 | 现存 | |||
DROP LANGUAGE | DROP | LANGUAGE | — | |
| 移除一种过程语言 | 现存 | |||
CREATE PROCEDURE | CREATE | PROCEDURE | 141 次 | |
| 定义一个新过程 | 现存 | |||
ALTER PROCEDURE | ALTER | PROCEDURE | 142 次 | |
| 更改过程的定义 | 现存 | |||
DROP PROCEDURE | DROP | PROCEDURE | — | |
| 移除一个过程 | 现存 | |||
ALTER ROUTINE | ALTER | ROUTINE | 142 次 | |
| 更改一个例程的定义 | 现存 | |||
DROP ROUTINE | DROP | ROUTINE | — | |
| 移除一个例程 | 现存 | |||
CREATE TRANSFORM | CREATE | TRANSFORM | — | |
| 定义一个新的转换 | 现存 | |||
DROP TRANSFORM | DROP | TRANSFORM | — | |
| 移除一个转换 | 现存 | |||