2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0

DO

DO — 执行匿名代码块

概要

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

提交更正

如果您在文档中发现任何不正确之处、与您对特定功能的实际体验不符之处,或者需要进一步说明之处,请使用此表格报告文档问题。