预发布版本文档。 PostgreSQL 19beta4 为测试版本,最终发布内容可能有所不同。
DO
DO — 执行匿名代码块
大纲
DO [ LANGUAGElang_name]code
描述
DO 执行匿名代码块,换言之,就是执行一个以过程语言编写的瞬时匿名函数。
该代码块会被当作一个不带参数、返回 void 的函数体。它只会被解析并执行一次。
可选的 LANGUAGE 子句可以写在代码块之前,也可以写在之后。
参数
注解
要使用的过程语言必须已经通过 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 语句。