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

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

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.0 已于 2015 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

33.2. 连接到数据库服务器 #

使用以下语句连接数据库:

EXEC SQL CONNECT TO target [AS connection-name] [USER user-name];

其中,target 可以按以下方式指定:

  • dbname[@hostname][:port]
  • tcp:postgresql://hostname[:port][/dbname][?options]
  • unix:postgresql://hostname[:port][/dbname][?options]
  • 包含上述某种形式的 SQL 字符串常量
  • 对包含上述某种形式的字符变量的引用(见示例)
  • DEFAULT

如果直接写出连接目标(即不通过变量引用),且未用引号括起该值,就会应用普通 SQL 的大小写不敏感规则。此时,也可以按需分别用双引号括起各个参数。实际使用中,采用单引号括起的字符串字面值或变量引用,可能更不容易出错。连接目标 DEFAULT 会以默认用户名发起到默认数据库的连接,此时不能单独指定用户名或连接名。

也有不同的方法来指定用户名:

  • username
  • username/password
  • username IDENTIFIED BY password
  • username USING password

如上所述,参数username以及password可以是一个 SQL 标识符、一个 SQL 字符串常量或者一个对字符变量的引用。

connection-name被用来在一个程序中处理多个连接。如果一个程序只使用一个连接,则可以省略它。最近被打开的连接将成为当前连接,当一个 SQL 语句要被执行时,将默认使用它(见这一章稍后的部分)。

以下是一些 CONNECT 语句的示例:

EXEC SQL CONNECT TO mydb@sql.mydomain.com;

EXEC SQL CONNECT TO unix:postgresql://sql.mydomain.com/mydb AS myconnection USER john;

EXEC SQL BEGIN DECLARE SECTION;
const char *target = "mydb@sql.mydomain.com";
const char *user = "john";
EXEC SQL END DECLARE SECTION;
 ...
EXEC SQL CONNECT TO :target USER :user;

最后一种形式使用了上面提到的字符变量引用。后续章节会说明,如何在 C 变量前加冒号,以便在 SQL 语句中使用它们。

请注意,连接目标的格式并未在 SQL 标准中规定。因此,如果你想开发可移植的应用,最好采用类似上面最后一个示例的方法,把连接目标字符串封装在某个地方。

提交更正

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