PostgreSQL 42P02: パラメーターがありません
SQL に $1 形式のプレースホルダーがありますが、パラメーター値がバインドされていません。ドライバー向けの SQL を直接実行した場合や、引用符内にプレースホルダーがある場合によく起こります。
- SQLSTATE
42P02- 名前
undefined_parameter- カテゴリ
- 構文エラーまたはアクセス規則違反
意味
PostgreSQL のプレースホルダーは $1, $2 など。バインドパラメーター付きでステートメントを準備または実行する際に値が入ります。テキストに $1 ただしステートメントがパラメーターなしで送信されたため、PostgreSQLは置き換える値を持たず、42P02で失敗します(undefined_parameter).
これは通常、アプリケーションのコードやログからコピーした SQL を手作業で実行した場合や、ドライバーがプレースホルダー付きのクエリ文字列を、バインドされない経路で送信した場合に起こります。
よくある原因
- コードやログからコピーしたパラメーター化クエリを、psqlやSQLエディターでそのまま実行する。
- 文字列内またはドル引用符で囲まれた関数本体内のプレースホルダー(ドライバーが置換しない場所)。
- A
DOブロックまたは動的 SQL を使用して$1なしEXECUTE ... USING. - ドライバーのプレースホルダー形式の混在:
?または%s1 か所で、$1タブで作っているレポートに響くことはありません。
修正方法
-
手動で実行するときは、プレースホルダーをリテラル値に置き換えるか、次を使用します
PREPAREそしてEXECUTE.PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1; EXECUTE find_order(42);
-
PL/pgSQL 内の動的 SQL では、次を使って値を渡します
USING.DO $$ DECLARE n int; BEGIN EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42; RAISE NOTICE '%', n; END; $$; -
アプリケーションコードでは、値を連結せず、ドライバーのパラメーター API を通して渡してください。
安全に再現する
SELECT $1; -- ERROR: there is no parameter $1
関連エラー
その他の構文エラーまたはアクセス規則違反のエラー
42501権限がありません42846強制変換できません42803列は GROUP BY 句に含める必要があります42830無効な外部キー42804データ型の不一致42703列が存在しません42883関数は存在しません42P01リレーションは存在しません
コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.
SQLly で PostgreSQL を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。