Menu

文档

CREATE LANGUAGE

功能描述

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

语法格式

CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name
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;

本文档遵循知识共享许可协议CC 4.0 (http://creativecommons.org/Licenses/by/4.0/)。