CREATE LANGUAGE

功能描述

定义一种新的过程语言。单机和集中式暂不支持创建过程语言。

语法格式

CreateLanguage ::= CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name;

CreateLanguage ::= CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name
    HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ];

参数说明

• TRUSTED

  TRUSTED说明该语言并不授权没有权限的用户访问数据。 如果在注册该语言时忽略这个关键字，则只有超级用户权限可以使用。

• PROCEDURAL

  这是个没有用的字。

• name

  新过程语言的名称。这个名字应该在数据库的所有语言中唯一。

  出于向下兼容的原因，这个名字可以用单引号包围。

• HANDLER call_handler

  call_handler是一个以前注册过的函数名字， 该函数将被用来执行该过程语言的函数。过程语言的调用处理器必须用一种编译语言(比如 C) 书写，调用风格必须是版本1的调用风格，并且注册为不接受参数并且返回 language_handler类型的函数。language_handler 是用于将函数声明为调用处理器的占位符。

• INLINE inline_handler

  inline_handler是以前注册过的函数名字， 用来在该语言中执行一个匿名代码块(DO 命令)。 如果没有指定inline_handler函数， 那么该语言不支持匿名代码块。处理器函数必须接受一个internal 类型的参数，这将是DO命令的内部表示，并且它通常返回void。 忽略该处理器的返回值。

• VALIDATOR valfunction

  valfunction是一个以前注册过的函数名字， 在用该语言创建新函数的时候将用它来校验新函数。如果没有声明校验函数， 那么建立新函数的时候就不会检查它。校验函数必须接受一个类型为oid的参数， 它是将要创建的函数的 OID ，并且通常会返回void。

  校验函数通常会检查函数体，看看有没有语法错误，但是它也可以查看函数的其它属性， 比如该语言是否不能处理某种参数类型。校验函数应该用ereport() 函数报告错误。该函数的返回值将被忽略。

示例

创建标准的过程语言的比较好的方法：

CREATE LANGUAGE plperl;

对于pg_pltemplate还不知道的语言，需要下面这样的序列：

CREATE FUNCTION plsample_call_handler() RETURNS language_handler
    AS '$libdir/plsample'
    LANGUAGE C;
CREATE LANGUAGE plsample
    HANDLER plsample_call_handler;