createlang

Name

createlang -- 定义一种新的 PostgreSQL 过程语言

Synopsis

createlang [connection-option...] langname [dbname]
createlang [connection-option...] --list | -l dbname

描述

createlang 是一个用于向 PostgreSQL 数据库增加新的编程语言的工具。 createlang 可以处理所有 PostgreSQL 版本缺省就提供的语言,但是不能处理其它方面提供的语言。

尽管可以用 SQL 命令直接增加后端编程语言,我们还是推荐使用 createlang, 因为它进行了一些检查而且更容易使用。参阅 CREATE LANGUAGE 获取更多信息。

选项

createlang 接受下列命令行参数:

langname

声明要被定义的过程编程语言的名称。

[-d] dbname
[--dbname] dbname

声明要向哪个数据库增加该语言。 缺省是使用和当前系统用户同名地数据库。

-e
--echo

执行的时候显示所执行的 SQL 命令。

-l
--list

显示一个在目标数据库里已经安装的语言的列表。

--L directory

声明该语言的解释器所在的目录。 这个目录通常是自动发现的。这个选项主要用于调试。

createlang 还接受下列命令行参数作为联接参数:

-h host
--host host

声明运行服务器的机器的主机名。 如果数值以斜杠开头,则它被用做到 Unix 域套接字的路径。

-p port
--port port

声明服务器侦听着等待连接的互联网 TCP 端口或一个本地 Unix 域套接字文件扩展(描述符)。

-U username
--username username

进行联接的用户名。

-W
--password

强制口令提示符。

环境

PGDATABASE
PGHOST
PGPORT
PGUSER

缺省连接参数。

诊断

多数错误信息是自解释的。如果没有,带着 --echo 参数运行 createlang 然后在相应的SQL命令下面检查细节。

注意

使用 droplang 删除一种语言。

例子

pltcl 语言安装到数据库 template1里:

$ createlang pltcl template1

请注意,把语言安装到 template1 将导致该语言自动被安装到随后创建的数据库中。

又见

droplang, CREATE LANGUAGE, 环境变量(Section 28.11