32.19. 在线程化程序中的行为
libpq默认是可再入的并且是线程安全的。你可能需要使用特殊的编译器命令行选项来编译你的应用代码。参考你的系统文档来了解如何编译启用线程的应用,或者在src/makefile.global中查找PTHREAD_CFLAGS和PTHREAD_LIBS。这个函数允许查询libpq的线程安全状态:
-
PQisthreadsafe
-
返回libpq库的线程安全状态。
int PQisthreadsafe();
如果libpq是线程安全的则返回 1,否则返回 0。
一个线程限制是不允许两个线程同时尝试操纵同一个PGconn对象。特别是你不能从不同的线程通过同一个连接对象发出并发的命令(如果你需要运行并发命令,请使用多个连接)。
PGresult对象在创建后通常是只读的,并且因此可以在线程之间自由地被传递。但是,如果你使用任何第 32.11 节或第 32.13 节中描述的PGresult修改函数,你需要负责避免在同一个PGresult上的并发操作。
被废弃的函数PQrequestCancel
以及PQoidStatus
不时线程安全的并且不应当在多线程程序中使用。PQrequestCancel
可以被替换为PQcancel
。PQoidStatus
可以被替换为PQoidValue
。
如果你在应用中使用 Kerberos (除了在libpq中之外),你将需要对 Kerberos 调用加锁,因为 Kerberos 函数不是线程安全的。参考libpq源代码中的PQregisterThreadLock
函数,那里有在libpq和应用之间做合作锁定的方法。
如果你在线程化应用中碰到问题,将该程序运行在src/tools/thread来查看是否你的平台有线程不安全的函数。这个程序会被configure运行,但是对于二进制发布,你的库可能不匹配用来编译二进制的库。