pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
这一节描述如何打开、关闭以及切换数据库连接。
使用以下语句连接数据库:
EXEC SQL CONNECT TOtarget[ASconnection-name] [USERuser-name];
其中,target 可以按以下方式指定:
dbname[@hostname][:port]tcp:postgresql://hostname[:port][/dbname][?options]unix:postgresql://hostname[:port][/dbname][?options]DEFAULT如果直接写出连接目标(即不通过变量引用),且未用引号括起该值,就会应用普通 SQL 的大小写不敏感规则。此时,也可以按需分别用双引号括起各个参数。实际使用中,采用单引号括起的字符串字面值或变量引用,可能更不容易出错。连接目标 DEFAULT 会以默认用户名发起到默认数据库的连接,此时不能单独指定用户名或连接名。
也有不同的方法来指定用户名:
usernameusername/passwordusername IDENTIFIED BY passwordusername 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"; const char *passwd = "secret"; EXEC SQL END DECLARE SECTION; ... EXEC SQL CONNECT TO :target USER :user USING :passwd; /* or EXEC SQL CONNECT TO :target USER :user/:passwd; */
最后一种形式使用了上面提到的字符变量引用。后续章节会说明,如何在 C 变量前加冒号,以便在 SQL 语句中使用它们。
请注意,连接目标的格式并未在 SQL 标准中规定。因此,如果你想开发可移植的应用,最好采用类似上面最后一个示例的方法,把连接目标字符串封装在某个地方。
嵌入式 SQL 程序中的 SQL 语句默认在当前连接上执行,即最近打开的连接。如果应用需要管理多个连接,可以采用两种方式。
第一种方式是显式地为每一个 SQL 语句选择一个连接,例如:
EXEC SQL AT connection-name SELECT ...;
如果应用需要以混合的顺序使用多个连接,这种方式特别合适。
如果你的应用使用多个线程执行,它们不能并发地共享一个连接。你必须显式地控制对连接的访问(使用互斥量)或者为每个线程使用一个连接。
第二种方式是执行一个语句来切换当前的连接。该语句是:
EXEC SQL SET CONNECTION connection-name;
如果有很多语句要在同一个连接上执行,这种方式尤其方便。
这里有一个管理多个数据库连接的例子程序:
#include <stdio.h>
EXEC SQL BEGIN DECLARE SECTION;
char dbname[1024];
EXEC SQL END DECLARE SECTION;
int
main()
{
EXEC SQL CONNECT TO testdb1 AS con1 USER testuser;
EXEC SQL CONNECT TO testdb2 AS con2 USER testuser;
EXEC SQL CONNECT TO testdb3 AS con3 USER testuser;
/* 这个查询将在最近打开的数据库 "testdb3" 中执行。 */
EXEC SQL SELECT current_database() INTO :dbname;
printf("current=%s (should be testdb3)\n", dbname);
/* 使用 "AT" 在 "testdb2" 中运行查询 */
EXEC SQL AT con2 SELECT current_database() INTO :dbname;
printf("current=%s (should be testdb2)\n", dbname);
/* 将当前连接切换到 "testdb1"。 */
EXEC SQL SET CONNECTION con1;
EXEC SQL SELECT current_database() INTO :dbname;
printf("current=%s (should be testdb1)\n", dbname);
EXEC SQL DISCONNECT ALL;
return 0;
}
这个例子将产生这样的输出:
current=testdb3 (should be testdb3) current=testdb2 (should be testdb2) current=testdb1 (should be testdb1)
要关闭连接,请使用以下语句:
EXEC SQL DISCONNECT [connection];
其中,connection 可以按以下方式指定:
connection-nameDEFAULTCURRENTALL如果未指定连接名,则关闭当前连接。
应用程序始终显式断开其打开的每个连接,是良好的编程习惯。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。