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 手册。
&reftitle.parameters;
filename
写入追踪日志的文件完整路径和文件名,与 fopen 一致。
mode
可选的文件访问模式,同 fopen。
connection
&pgsql.parameter.connection-with-nullable-default;
trace_mode
可选的 trace 模式,使用下列常量 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 现在可为 null。
&reftitle.examples;
pg_trace 示例
]]>
&reftitle.seealso;
fopen
pg_untrace