选择 打开 改范围 完整检索页

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

文档 / SQL 命令 / 函数与过程

SQL COMMAND · 函数与过程

DO

执行匿名代码块

DO函数与过程引入 10(基线)现存至 20 devel0 次语法变更

动词
DO
对象
引入版本
10(基线)
状态
现存
语法变更次数
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正文更新

    正文更新

同组命令

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