pg_trace
PostgreSQL 接続のトレースを有効にする
&reftitle.description;
boolpg_trace
stringfilename
stringmode"w"
PgSql\Connectionnullconnection&null;
inttrace_mode0
pg_trace は、PostgreSQL フロントエンド/
バックエンド間の通信をデバック用のファイルにトレースすることを有効にします。
このトレース結果を完全に理解するためには、PostgreSQL 通信プロトコルの詳細に
精通している必要があります。
そうでない人にとっても、サーバーに送られたクエリのエラーを
トレースすることは有用です。試しに grep '^To backend'
trace.log を実行し、実際に PostgreSQL サーバーに送信される
クエリを見てみるとよいでしょう。詳細な情報は
PostgreSQL Documentation を
参照ください。
&reftitle.parameters;
filename
トレースログを書き込むファイルの名前(フルパスを含む)。
fopen と同じ。
mode
オプションのファイルアクセスモード。fopen
と同じです。
connection
&pgsql.parameter.connection-with-nullable-default;
trace_mode
オプションのトレースモード。
定数 PGSQL_TRACE_SUPPRESS_TIMESTAMPS と
PGSQL_TRACE_REGRESS_MODE を指定します。
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;
&Description;
8.3.0
trace_mode が追加されました。
&pgsql.changelog.connection-object;
8.0.0
connection は、nullable になりました。
&reftitle.examples;
pg_trace の例
]]>
&reftitle.seealso;
fopen
pg_untrace