31.18. スレッド化プログラムの振舞い

デフォルトでlibpqは再入可能、かつ、スレッドセーフです。 アプリケーションコードをコンパイルする時にコンパイラの特殊なコマンドラインオプションに追加する必要があるかもしれません。 スレッドを有効にしたアプリケーションの構築方法についての情報は、使用するシステムの文書を参照してください。 また、PTHREAD_CFLAGSとPTHREAD_LIBSに関してsrc/Makefile.globalも一読してください。 以下の関数により、libpqのスレッドセーフ状態を確認することができます。

スレッドに関する1つの制限として、異なるスレッドから同時に同一のPGconnオブジェクトを操作することはできません。 具体的には、異なるスレッドから同一接続オブジェクトを介してコマンドを同時に発行することができません。 (コマンドの同時実行が必要な場合、接続を複数使用してください。)

PGresultオブジェクトは生成後、読み込み専用となります。 従って、スレッド間を自由に渡ることができます。

非推奨の関数、PQrequestCancelやPQoidStatusはスレッドセーフではありませんので、マルチスレッドプログラムでは使用してはなりません。 PQrequestCancelはPQcancelに、PQoidStatusはPQoidValueに置き換えることができます。

(libpqの内部に加えて)アプリケーション中でKerberosを利用している場合、Kerberos関数はスレッドセーフではありませんのでKerberos呼び出しの前後をロックする必要があるでしょう。 libpqとアプリケーション間のロック処理を協調させる方法としてlibpqのソースコードのPQregisterThreadLock関数を参照してください。

スレッドアプリケーションで問題が起きた場合、src/tools/thread内のプログラムを実行して、プラットフォームがスレッドセーフではない関数を持っていないかどうか確認してください。 このプログラムはconfigureより実行されますが、バイナリ配布物の場合は、バイナリ構築時のライブラリとシステムのライブラリが一致しない可能性があります。