// PostgreSQL エラーリファレンス

PostgreSQL 42P02: パラメーターがありません

SQL に $1 形式のプレースホルダーがありますが、パラメーター値がバインドされていません。ドライバー向けの SQL を直接実行した場合や、引用符内にプレースホルダーがある場合によく起こります。

SQLSTATE
42P02
名前
undefined_parameter
カテゴリ
構文エラーまたはアクセス規則違反
エラーメッセージ
there is no parameter $1

意味

PostgreSQL のプレースホルダーは $1, $2 など。バインドパラメーター付きでステートメントを準備または実行する際に値が入ります。テキストに $1 ただしステートメントがパラメーターなしで送信されたため、PostgreSQLは置き換える値を持たず、42P02で失敗します(undefined_parameter).

これは通常、アプリケーションのコードやログからコピーした SQL を手作業で実行した場合や、ドライバーがプレースホルダー付きのクエリ文字列を、バインドされない経路で送信した場合に起こります。

よくある原因

  • コードやログからコピーしたパラメーター化クエリを、psqlやSQLエディターでそのまま実行する。
  • 文字列内またはドル引用符で囲まれた関数本体内のプレースホルダー(ドライバーが置換しない場所)。
  • A DO ブロックまたは動的 SQL を使用して $1 なし EXECUTE ... USING.
  • ドライバーのプレースホルダー形式の混在: ? または %s 1 か所で、 $1 タブで作っているレポートに響くことはありません。

修正方法

  1. 手動で実行するときは、プレースホルダーをリテラル値に置き換えるか、次を使用します PREPARE そして EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. 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;
    $$;
  3. アプリケーションコードでは、値を連結せず、ドライバーのパラメーター API を通して渡してください。

安全に再現する

SELECT $1;  -- ERROR: there is no parameter $1

関連エラー

その他の構文エラーまたはアクセス規則違反のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。