createlang
createlang — 定义一种新的PostgreSQL过程语言
大纲
createlang [connection-option...] langname [dbname]createlang [connection-option...] [--list] | [-l] dbname
描述
createlang是一个向PostgreSQL数据库添加新编程语言的工具。createlang只是CREATE LANGUAGE命令的一个包装。
选项
createlang 接受下列命令行参数:
langname指定要安装的过程语言的名称。
[-d]dbname[--dbname]dbname指定要向哪个数据库添加该语言。默认使用与当前系统用户同名的数据库。
-e--echo在执行 SQL 命令时把它们显示出来。
-l--list显示目标数据库中已安装语言的列表。
createlang 还接受下列用于连接参数的命令行参数:
-hhost--hosthost指定服务器所在主机的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字所在目录。
-pport--portport指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--usernameusername要用来连接的用户名。
-w--no-password绝不提示输入密码。如果服务器要求密码认证,而密码又无法通过诸如
.pgpass文件等其他方式获得,则连接尝试将失败。该选项可用于没有用户在场输入密码的批处理作业和脚本。-W--password强制 createlang 在连接数据库之前提示输入密码。
该选项绝非必需,因为如果服务器要求密码认证,createlang会自动提示输入密码。不过,createlang会浪费一次连接尝试来发现服务器需要密码。在某些情况下,输入
-W可以避免这次额外的连接尝试。
诊断
大多数错误消息都是不言自明的。如果不然,可以带 --echo 选项运行 createlang,然后查看相应的 SQL 命令了解详情。此外,libpq 前端库使用的任何默认连接设置和环境变量也都适用。
注解
使用droplang可移除一个语言。
示例
要将语言 pltcl 安装到数据库 template1 中:
$createlang pltcl template1
注意,将该语言安装到 template1 中后,之后创建的数据库中也会自动安装它。