やりたいこと
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
