やりたいこと

log_min_duration_statement = 0ですべてのSQLをログに出力すると、パラメータの値も記録される。 画像などの大きなデータをパラメータで渡すと、データ全体が記録され、ログファイルが大きくなる。 ログに出力するパラメータの長さを制限したい。

参考: 【PostgreSQL】log_min_duration_statementでスロークエリをログに出力する

パラメータのログ

アプリケーションがプレースホルダー($1、$2)付きのSQLを実行すると、パラメータの値はDETAIL行に出力される。 以下は、bytea型のdata列に画像のデータを入れたときのログである。

2026-11-22 15:09:07.577 UTC [166] LOG:  duration: 0.065 ms  parse <unnamed>: INSERT INTO images VALUES ($1, $2)
2026-11-22 15:09:07.577 UTC [166] LOG:  duration: 0.029 ms  bind <unnamed>: INSERT INTO images VALUES ($1, $2)
2026-11-22 15:09:07.577 UTC [166] DETAIL:  Parameters: $1 = '1', $2 = '\x89504e470d0a1a0a0000000d494844520000010000000100080600000000'
2026-11-22 15:09:07.577 UTC [166] LOG:  duration: 0.099 ms  execute <unnamed>: INSERT INTO images VALUES ($1, $2)
2026-11-22 15:09:07.577 UTC [166] DETAIL:  Parameters: $1 = '1', $2 = '\x89504e470d0a1a0a0000000d494844520000010000000100080600000000'

log_min_duration_statement = 0の場合、パラメータはbindとexecuteの2回出力される。 100KBのデータを渡すと、16進数の文字列で約200KBになり、1回のSQLで約400KBのログが出力される。

log_parameter_max_lengthを設定する

log_parameter_max_lengthは、ログに出力するパラメータの値を、指定したバイト数で切り詰める。 PostgreSQL 13で追加された設定である。

値動作
-1切り詰めない(デフォルト)
0パラメータを出力しない
1以上指定したバイト数で切り詰める

postgresql.confに設定する場合は以下のように記述する。

log_parameter_max_length = 64

稼働中のサーバーにはALTER SYSTEMでも設定できる。 設定の再読み込みで反映され、再起動は不要である。

ALTER SYSTEM SET log_parameter_max_length = 64;
SELECT pg_reload_conf();

ALTER SYSTEMを実行できるのは、スーパーユーザーとALTER SYSTEM権限を付与されたユーザーのみ。 セッション内でSETできるのは、スーパーユーザーとSET権限を付与されたユーザーのみ。

以下は、log_parameter_max_length = 16を設定したときのログである。 16バイトで切り詰められ、末尾に...が付く。

2026-11-22 15:09:08.694 UTC [173] LOG:  duration: 0.036 ms  bind <unnamed>: INSERT INTO images VALUES ($1, $2)
2026-11-22 15:09:08.694 UTC [173] DETAIL:  Parameters: $1 = '2', $2 = '\x89504e470d0a1a...'
2026-11-22 15:09:08.694 UTC [173] LOG:  duration: 0.324 ms  execute <unnamed>: INSERT INTO images VALUES ($1, $2)
2026-11-22 15:09:08.694 UTC [173] DETAIL:  Parameters: $1 = '2', $2 = '\x89504e470d0a1a...'

ログのサイズを比べる

100KBのデータをパラメータで渡すINSERTを100回実行し、出力されたログのサイズを比べた。

設定ログのサイズ
log_parameter_max_length = -1(デフォルト)約40MB
log_parameter_max_length = 64約62KB

パラメータを切り詰めても、SQLの形と実行時間はログに残る。 pgbadger でスロークエリを集計する用途なら、パラメータの全体は不要である。

SQLに値を直接書いた場合は切り詰められない

log_parameter_max_lengthが切り詰めるのは、DETAIL行に出力されるパラメータだけである。 SQLの文字列に値を直接書いた場合は、statement行にSQL全体が出力される。

2026-11-22 15:09:08.695 UTC [173] LOG:  duration: 0.262 ms  statement: INSERT INTO images VALUES (3, '\x89504e470d0a1a0a0000000d494844520000010000000100080600000000');

log_parameter_max_length = 64で、100KBのデータを直接書いたINSERTを100回実行すると、ログは約20MBになった。 ドライバーによっては、デフォルトで値をSQLに埋め込んでから送信する。 値を埋め込んだSQLを送るドライバーの場合も、同様に切り詰められない。

エラー時のパラメータの長さ

エラーになったSQLのパラメータは、log_parameter_max_length_on_errorで制御する。 デフォルトは0で、エラー時にパラメータを出力しない。 log_parameter_max_length_on_errorは一般ユーザーも変更できる。 0以外を設定すると、エラーに備えて実行のたびにパラメータを文字列として保持するため、オーバーヘッドが増える。

log_parameter_max_length_on_error = 16を設定すると、エラーのCONTEXT行に16バイトまでのパラメータが出力される。

2026-11-22 15:12:35.747 UTC [194] ERROR:  duplicate key value violates unique constraint "images_pkey"
2026-11-22 15:12:35.747 UTC [194] DETAIL:  Key (id)=(1) already exists.
2026-11-22 15:12:35.747 UTC [194] CONTEXT:  unnamed portal with parameters: $1 = '1', $2 = '\x89504e470d0a1a...'
2026-11-22 15:12:35.747 UTC [194] STATEMENT:  INSERT INTO images VALUES ($1, $2)

動作確認した環境

PostgreSQL 17.10のDockerコンテナで動作を確認した。 パラメータ付きのSQLは、psqlの\bind(psql 16以降)で実行した。

INSERT INTO images VALUES ($1, $2) \bind 1 '\\x89504e470d0a1a0a0000000d494844520000010000000100080600000000' \g

参考