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
中的语言将自动安装到随后创建的其他数据库中。