createlang

Name

createlang -- 安装一个PostgreSQL过程语言

Synopsis

createlang [_connection-option_...] _langname_ [_dbname_]

createlang [_connection-option_...] --list | -l [_dbname_]

描述

createlang是一个用于向 PostgreSQL数据库中增加编程语言的工具。

createlang仅是对SQL命令 CREATE EXTENSION的封装。

Caution
createlang是一个废弃了的可能在未来 PostgreSQL版本中删除的命令。 建议直接使用CREATE EXTENSION命令。

选项

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.14)。

诊断

大多数错误信息都是自解释的。如果不是,使用--echo 选项运行createlang然后查看相应的SQL命令的详细信息。 此外,前端库libpq中的所有缺省连接设置和环境变量都将适用。

注意

使用droplang删除一种语言。

示例

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

<samp class="literal">$</samp> <kbd class="literal">createlang pltcl template1</kbd>

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

另请参阅

droplang, CREATE EXTENSION, CREATE LANGUAGE