// 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 편집기에서 실행하는 경우.
  • 문자열 안이나 달러 인용(dollar-quoted) 함수 본문 안의 플레이스홀더로, 드라이버가 치환해 주지 않는 부분입니다.
  • A DO 블록이나 다음을 사용하는 동적 SQL $1 없이 EXECUTE ... USING.
  • 드라이버 플레이스홀더 스타일 혼합: ? 또는 %s 한 곳에서는, $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 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.