createlang

Name

createlang -- 定义一个新过程语言

Synopsis

createlang [connection-option...] langname [dbname]

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

描述

createlang是一个用于向数据库中增加新编程语言的工具。 createlang只是一个CREATE LANGUAGE命令的封装。

选项

createlang接受下列命令行参数:

langname

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

[-d] dbname
[--dbname] dbname

指定要向哪个数据库增加该语言。缺省使用和当前系统用户同名的数据库。

-e
--echo

显示所执行的 SQL 命令。

-l
--list

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

-V
--version

输出createlang版本并推出。

-?
--help

显示关于createlang命令行参数的帮助并且推出。

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

-h host
--host host

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

-p port
--port port

指定服务器侦听的TCP端口或一个本地Unix域套接字文件的扩展(描述符)。

-U username
--username username

进行连接的用户名。

-w
--no-password

不发布密码提示。若服务器请求密码认证并且一个密码不能通过像 .pgpass文件这样的其他方式来获得,连接 尝试将失败。该选项在批量作业和脚本中是有效的,在目前没有用 户输入密码的地方。

-W
--password

强制createlang在连接到数据库之前提示密码。

该选项从不是最重要的,尽管若服务器请求密码认证 createlang会自动提示密码。然而, createlang将浪费一个连接尝试来发现服务器想 要一个密码。在一些情况下,输入-W来避免额外的连接尝试。

环境变量

PGDATABASE
PGHOST
PGPORT
PGUSER

缺省连接参数。

这个实用程序,跟大多数其他PostgreSQL实用程序一样,也试用 libpq支持的环境变量。(参阅Section 31.13)。

诊断

多数错误信息都是自解释的。如果不是, 使用--echo选项运行createlang 然后针对相应的SQL命令检查细节。

注意

使用droplang删除一种语言。

例子

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

$ createlang pltcl template1

注意,安装到template1中的语言将自动安装到随后创建的其他数据库中。

又见

droplang, CREATE LANGUAGE