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

PostgreSQL配布物からの構築時のconfigureコマンドラインオプションに--enable-thread-safetyが使用されていた場合、libpqは再入可能、かつ、スレッドセーフです。 更に、アプリケーションコードをコンパイルする時にコンパイラのコマンドラインオプションに追加する必要があるかもしれません。 スレッドを有効にしたアプリケーションの構築方法についての情報は、使用するシステムの文書を参照してください。 また、PTHREAD_CFLAGSPTHREAD_LIBSに関してsrc/Makefile.globalも一読してください。 以下の関数により、libpqのスレッド安全性状態を確認することができます。

PQisthreadsafe

libpqライブラリのスレッド安全性状態を返します。

int PQisthreadsafe();

libpqがスレッドセーフの場合1が、さもなくば0が返ります。

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

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

推奨されない関数、PQrequestCancelPQoidStatus はスレッドセーフではありませんので、マルチスレッドプログラムでは使用すべきではありません。 PQrequestCancelPQcancel に、PQoidStatusPQoidValue に置き換えることが出来ます。

もしアプリケーション中で Kerberos (更にlibpqの内部で) を利用していたら、Kerberos 関数がスレッドセーフではないので Kerberos 呼び出し付近をロックする必要があるでしょう。 libpq とアプリケーション間のロックを協力する方法としてlibpqのソースコードのPQregisterThreadLock関数を参照してください。

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