createlang

Name

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

Synopsis

createlang [connection-options...] langname [dbname]
createlang [connection-options...] --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/IP 端口或一个本地 Unix 域套接字文件扩展(描述符).

-U username
--username username

进行联接的用户名。

-W
--password

强制口令提示符。

环境

PGDATABASE
PGHOST
PGPORT
PGUSER

缺省连接参数。

诊断

多数错误信息是自解释的。如果没有,带着 --echo参数运行 createlang 然后在相应的SQL命令下面检查细节。还可以参考 psql 获取更多可能输出。

注意

使用 droplang 删除一种语言。

createlang 是一个 shell 脚本, 它调用了若干次 psql.如果你做了 安排输入口令进行联接,那么它可能提示你输入好几次口令.

例子

pltcl 安装到数据库 template1里:

$ createlang pltcl template1

又见

droplang, CREATE LANGUAGE