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

PostgreSQL 8.0.0 文書
前のページ | 巻戻し | 第 27章libpq - C ライブラリ | 早送り | 次のページ

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

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

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

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

推奨されない関数`PQrequestCancel`、`PQoidStatus`や`fe_setauthsvc`はスレッドセーフではありませんので、マルチスレッドプログラムで使用すべきではありません。 `PQrequestCancel`は`PQcancel`に、`PQoidStatus`は`PQoidValue`に置き換えることができます。 いかなる場合においても、`fe_setauthsvc`は呼び出すべきではありません。

`crypt`認証方式を使用したLibpqアプリケーションは`crypt()`オペレーティングシステム関数に依存します。 この関数はスレッドセーフではない場合が多くあります。 全てのプラットフォームでスレッドセーフな`md5`方式を使用する方が良いでしょう。

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

前のページ | ホーム | 次のページ
SSLサポート | 上に戻る | libpqプログラムの構築