pg_traceEnable tracing a PostgreSQL connection
&reftitle.description;
boolpg_tracestringfilenamestringmode"w"PgSql\Connectionnullconnection&null;inttrace_mode0pg_trace enables tracing of the PostgreSQL
frontend/backend communication to a file. To fully understand the results,
one needs to be familiar with the internals of PostgreSQL
communication protocol.
For those who are not, it can still be
useful for tracing errors in queries sent to the server, you
could do for example grep '^To backend'
trace.log and see what queries actually were sent to the
PostgreSQL server. For more information, refer to the
PostgreSQL Documentation.
&reftitle.parameters;
filename
The full path and file name of the file in which to write the
trace log. Same as in fopen.
mode
An optional file access mode, same as for fopen.
connection
&pgsql.parameter.connection-with-nullable-default;
trace_mode
An optional trace mode with the following constants
PGSQL_TRACE_SUPPRESS_TIMESTAMPS and
PGSQL_TRACE_REGRESS_MODE
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&Version;&Description;8.3.0trace_mode has been added.
&pgsql.changelog.connection-object;
8.0.0connection is now nullable.
&reftitle.examples;
pg_trace example
]]>
&reftitle.seealso;
fopenpg_untrace