DO（做）

执行匿名的代码块作为暂时匿名函数。

概要

  1. DO [ LANGUAGE lang_name ] code

描述

DO 执行了一个匿名代码块，或换而言之为一个程序化语言的暂时的匿名函数

该代码块被认为似乎是一个没有参数的函数体，返回空值。它被解析被执行了一次。

可选参数 LANGUAGE 子句可以出现在代码块的前或者后。

匿名块是程序化语言结构，该结构提供在运行时创建和执行程序代码的能力，而不用将代码作为数据库对象持久的存储在系统目录中。匿名代码块的概念和UNIX shell脚本相似，该能允许将多个手动输入命令分组并作为一步骤执行。顾名思义，匿名块没有名字，因此不能被其他对象引用。虽然动态创建，匿名块可以轻松的作为脚本存储在操作系统文件中以便重复执行。

匿名块是标准程序语言块。他们携带语法并且遵循适用于该程序语言的规则，包括变量的声明和作用于，执行，异常处理和语言使用。

匿名块的编译和执行结合在一个步骤中，而用户定义的函数需要在每次定义变更之前重新定义。

参数

code

需要执行的程序化语言代码。这必须指定为字符串文本。正如使用 CREATE FUNCTION 命令。建议使用美元引用文字。可选关键字无效。支持这些程序语言：PL/pgSQL（plpgsql），PL/Python （plpythonu），and PL/Perl （plperl 和 plperlu）。

lang_name

代码所用程序语言的名字。该语言默认是 plpgsql。该语言必须在Greenplum数据库中安装并且在用户数据库中注册。

注意

PL/pgSQL 语言安装在Greenplum数据库系统中并且注册在用户创建的数据库中。PL/Python 语言是默认安装的，但是没有注册。其他语言没有安装也没有注册。系统目录 pg_language 包含了在数据库中注册语言的信息。

如果语言不可信，则用户必须有对程序语言有 USAGE 权限，或者必须是超级用户。这和使用该语言创建函数的权限要求一样。

示例

该 PL/pgSQL 例子对webuser用户赋予在 public 模式中所有视图的所有权限：

  1. DO $$DECLARE r record;
  2. BEGIN
  3.     FOR r IN SELECT table_schema, table_name FROM information_schema.tables
  4.              WHERE table_type = 'VIEW' AND table_schema = 'public'
  5.     LOOP
  6.         EXECUTE 'GRANT ALL ON ' || quote_ident(r.table_schema) || '.' || quote_ident(r.table_name) || ' TO webuser';
  7.     END LOOP;
  8. END$$;

该 PL/pgSQL 例子决定是否Greenplum数据库用户是超级用户。在例子中，匿名块检索从临时表的输入值。

  1. CREATE TEMP TABLE list AS VALUES ('gpadmin') DISTRIBUTED RANDOMLY;
  3. DO $$ 
  4. DECLARE
  5.   name TEXT := 'gpadmin' ;
  6.   superuser TEXT := '' ;
  7.   t1_row   pg_authid%ROWTYPE;
  8. BEGIN
  9.   SELECT * INTO t1_row FROM pg_authid, list 
  10.      WHERE pg_authid.rolname = name ;
  11.   IF t1_row.rolsuper = 'f' THEN
  12.     superuser := 'not ';
  13.   END IF ;
  14.   RAISE NOTICE 'user % is %a superuser', t1_row.rolname, superuser ;
  15. END $$ LANGUAGE plpgsql ;

注意： 例子 PL/pgSQL 使用 SELECT 和 INTO 子句。它和 SQL 命令的 SELECT INTO 语句不同。

兼容性

SQL标准中没有 DO 语句。

另见

CREATE LANGUAGE Greenplum PL/pgSQL 程序化语言

上级话题： SQL命令参考