↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

DO

执行匿名代码块

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-DO
file
sql-do.html
lang
en
name
DO
purpose
execute an anonymous code block
purpose zh
未知
sections same as
未知
slug
18
synopsis html
DO [ LANGUAGE <em class="replaceable"><code>lang_name</code></em> ] <em class="replaceable"><code>code</code></em>
synopsis text
DO [ LANGUAGE lang_name ] code

语法

DO [ LANGUAGE lang_name ] code
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

DO LANGUAGE lang_name code

版本定义 PG 18

DO [ LANGUAGE lang_name ] code

描述

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语句。

另见

CREATE LANGUAGE

比较版本

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c