# createlang ## Name createlang -- 安装一个PostgreSQL过程语言 ## Synopsis `createlang` [`_connection-option_`...] `_langname_` [`_dbname_`] `createlang` [`_connection-option_`...] `--list` | `-l` [`_dbname_`] ## 描述 createlang是一个用于向 PostgreSQL数据库中增加编程语言的工具。 createlang仅是对SQL命令 [CREATE EXTENSION](#calibre_link-572)的封装。 | **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](#calibre_link-39))。 ## 诊断 大多数错误信息都是自解释的。如果不是，使用`--echo` 选项运行createlang然后查看相应的SQL命令的详细信息。 此外，前端库libpq中的所有缺省连接设置和环境变量都将适用。 ## 注意 使用[droplang](#calibre_link-37)删除一种语言。 ## 示例 把`pltcl`语言安装到数据库 `template1`里： ``` <samp class="literal">$</samp> <kbd class="literal">createlang pltcl template1</kbd> ``` 注意，安装到`template1` 中的语言将自动安装到随后创建的其他数据库中。 ## 另请参阅 [droplang](#calibre_link-37), [CREATE EXTENSION](#calibre_link-572), [CREATE LANGUAGE](#calibre_link-605)