选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

不受支持的版本: 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.1 已于 2016 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页

createlang

createlang — install a PostgreSQL procedural language

大纲

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

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

描述

createlang 是一个向 PostgreSQL 数据库中添加过程语言的工具。

createlang 只是对 CREATE EXTENSION SQL 命令的一个包装。

小心

createlang 已被弃用,在未来的 PostgreSQL 版本中可能会被移除。建议直接使用 CREATE EXTENSION 命令。

选项

createlang accepts the following command-line arguments:

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 支持的环境变量(参见第 31.13 节)。

诊断

大多数错误消息都是不言自明的。如果不然,可以带 --echo 选项运行 createlang,然后查看相应的 SQL 命令了解详情。此外,libpq 前端库使用的任何默认连接设置和环境变量也都适用。

注解

使用 droplang 可移除一个语言。

示例

要将语言 pltcl 安装到数据库 template1 中:

$ createlang pltcl template1

注意,将该语言安装到 template1 中后,之后创建的数据库中也会自动安装它。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。