Postgresql 中文操作指南

DO

DO——执行匿名的代码块

Synopsis

DO [ LANGUAGE lang_name ] code

Description

DO 执行匿名的代码块，或者换句话说，执行某个过程语言中的瞬态匿名函数。

代码块被视为没有参数的功能主体，返回 void 。它被解析并执行一次。

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

Parameters

  • code

    • 要执行的过程语言代码。这必须指定为字符串文字，就像 CREATE FUNCTION 一样。建议使用以美元引用的文字。

  • lang_name

    • 代码所用的过程语言名。如果省略此项，则默认为 plpgsql 。

Notes

在经过 CREATE EXTENSION 的方式安装到当前数据库中后，待使用的过程语言才已完成安装。 plpgsql 已安装作为默认语言，但其他语言并未安装。

该用户必须针对过程语言拥有 USAGE 权限，否则必须是超级用户（如果该语言不可信）。这是与用该语言创建函数相同的权限要求。

如果 DO 在事务块中执行，则该过程代码无法执行事务控制语句。仅当 DO 在其自身的事务中执行时才允许使用事务控制语句。

Examples

授予角色 webuser 对架构 public 中所有视图的所有权限：

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$$;

Compatibility

SQL 标准中没有 DO 语句。

See Also

CREATE LANGUAGE