32.20. Поведение в многопоточных программах #
Начиная с 17-й версии, библиотека libpq всегда поддерживает повторные вызовы и многопоточность. Однако эта реализация не лишена ограничений: два потока не должны пытаться одновременно работать с одним объектом PGconn. В частности, не допускается параллельное выполнение команд из разных потоков через один объект соединения. (Если вам нужно выполнять команды одновременно, используйте несколько соединений.)
Объекты PGresult после создания обычно доступны только для чтения, и поэтому их можно свободно передавать между потоками. Однако если вы используете какую-либо из функций, изменяющих PGresult, описанных в Разделе 32.12 или Разделе 32.14, вы должны также избегать одновременных обращений к одному объекту PGresult.
В ранних версиях библиотеку libpq можно было собрать с поддержкой многопоточности или без неё, в зависимости от параметров компилятора. Эта функция позволяет узнать, поддерживает ли libpq многопоточность:
PQisthreadsafe#Возвращает состояние потокобезопасности в библиотеке libpq.
int PQisthreadsafe();
Возвращает 1, если библиотека libpq потокобезопасная, или 0 в противном случае. Начиная с версии 17, всегда возвращает 1.
Устаревшие функции PQrequestCancel и PQoidStatus не являются потокобезопасными и не должны применяться в многопоточных программах. Вместо PQrequestCancel можно использовать PQcancelBlocking, а вместо PQoidStatus — PQoidValue.
Если вы применяете Kerberos в своём приложении (помимо возможного использования внутри libpq), вы должны обеспечить блокировку вокруг вызовов Kerberos, так как функции Kerberos не являются потокобезопасными. Обратите внимание на функцию PQregisterThreadLock в исходном коде libpq, позволяющую организовать совместные блокировки между libpq и вашим приложением.