↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 函数与过程

SQL COMMAND · 函数与过程

DO

执行匿名代码块

执行匿名代码块

DO函数与过程引入 9.0现存至 20 devel0 次语法变更

动词
DO
对象
—
引入版本
9.0
状态
现存
语法变更次数
0
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

DO LANGUAGE lang_name code

语法概要

DO [ LANGUAGE lang_name ] code

PostgreSQL 18 手册 · 查看完整参考页

描述

DO 执行匿名代码块,换言之,就是执行一个以过程语言编写的瞬时匿名函数。

该代码块会被当作一个不带参数、返回 void 的函数体。它只会被解析并执行一次。

可选的 LANGUAGE 子句可以写在代码块之前,也可以写在之后。

参数

code

要执行的过程语言代码。与 CREATE FUNCTION 一样,它必须以字符串字面值形式指定。建议使用美元引用的字符串字面值。

lang_name

编写该代码所用的过程语言名称。如果省略,默认值为 plpgsql。

注解

要使用的过程语言必须已经通过 CREATE EXTENSION 安装到当前数据库中。plpgsql 默认已安装,而其他语言则不会。

用户必须拥有该过程语言的 USAGE 权限;如果该语言是不受信任的,则必须是超级用户。这与用该语言创建函数时的权限要求相同。

如果在事务块中执行 DO,则该过程语言代码不能执行事务控制语句。只有当 DO 在其自身事务中执行时,才允许使用事务控制语句。

示例

将模式 public 中所有视图上的全部权限授予角色 webuser:

DO $$
DECLARE r record;
BEGIN
    FOR r IN SELECT table_schema, table_name FROM information_schema.tables
             WHERE table_type = 'VIEW' AND table_schema = 'public'
    LOOP
        EXECUTE 'GRANT ALL ON ' || quote_ident(r.table_schema) || '.' || quote_ident(r.table_name) || ' TO webuser';
    END LOOP;
END$$;

兼容性

SQL 标准中没有 DO 语句。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 11← 10正文更新

    正文更新
  2. PostgreSQL 9.0← 8.4新增此命令

同组命令

命令动词对象版本变动最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
CALLCALL— —
调用一个过程现存
DODO— —
执行匿名代码块现存
CREATE AGGREGATECREATEAGGREGATE 1911 次
定义一个新的聚合函数现存
ALTER AGGREGATEALTERAGGREGATE 147 次
更改一个聚合函数的定义现存
DROP AGGREGATEDROPAGGREGATE 106 次
移除一个聚合函数现存
CREATE FUNCTIONCREATEFUNCTION 1416 次
定义一个新函数现存
ALTER FUNCTIONALTERFUNCTION 1411 次
更改函数的定义现存
DROP FUNCTIONDROPFUNCTION 104 次
移除一个函数现存
CREATE LANGUAGECREATELANGUAGE 137 次
定义一种新的过程语言现存
ALTER LANGUAGEALTERLANGUAGE 144 次
更改一种过程语言的定义现存
DROP LANGUAGEDROPLANGUAGE 8.25 次
移除一种过程语言现存
CREATE PROCEDURECREATEPROCEDURE 141 次
定义一个新过程现存
ALTER PROCEDUREALTERPROCEDURE 142 次
更改过程的定义现存
DROP PROCEDUREDROPPROCEDURE —
移除一个过程现存
ALTER ROUTINEALTERROUTINE 142 次
更改一个例程的定义现存
DROP ROUTINEDROPROUTINE —
移除一个例程现存
CREATE TRANSFORMCREATETRANSFORM 101 次
定义一个新的转换现存
DROP TRANSFORMDROPTRANSFORM 9.61 次
移除一个转换现存