// PostgreSQL 오류 참조

PostgreSQL 42P01: 릴레이션이 존재하지 않음

PostgreSQL이 테이블, 뷰 또는 시퀀스를 찾지 못합니다. 보통은 search_path에 없는 스키마, 따옴표로 묶은 대소문자 혼용 이름, 아니면 잘못된 데이터베이스가 원인입니다.

SQLSTATE
42P01
이름
undefined_table
카테고리
구문 오류 또는 접근 규칙 위반
오류 메시지
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

의미

PostgreSQL에서 릴레이션은 테이블, 뷰, 구체화된 뷰, 시퀀스, 인덱스, 외래 테이블 같은 테이블 형태의 객체 전부를 가리킵니다. 42P01은 사용한 이름이 어느 것으로도 해석되지 않는다는 뜻이며, 그 스키마들은 여러분의 search_path (또는 명시적으로 이름을 지정한 스키마에서).

PostgreSQL은 따옴표 없이 쓴 이름을 소문자로 바꿉니다. 다음과 같이 만든 테이블은 "Orders" (따옴표로 묶은 대문자 O)는 다음으로만 참조할 수 있습니다 "Orders", 그래서 SELECT * FROM Orders 다음을 찾습니다 orders 그리고 실패합니다.

일반적인 원인

  • 테이블이 다음에 속하지 않는 스키마에 있습니다 search_path, 예를 들어 sales.orders 경로가 다음인 동안 "$user", public.
  • 테이블이 따옴표로 묶인 대소문자 혼합 이름으로 생성되었고(ORM이나 GUI 도구에서 흔함) 쿼리에서는 이를 따옴표로 묶지 않았습니다.
  • 테이블이 있는 데이터베이스가 아닌 다른 데이터베이스에 연결되어 있습니다. PostgreSQL은 일반 이름으로는 데이터베이스를 넘나들며 조회할 수 없습니다.
  • 테이블이 아직 생성되지 않았거나, 마이그레이션이 실패했거나 다른 데이터베이스에서 실행되었습니다.
  • 테이블 이름에 오타가 있습니다.

해결 방법

  1. 자신이 어디에 있는지와 검색 경로가 무엇인지 확인하세요.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. 스키마나 대소문자와 상관없이 테이블을 찾으세요.

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. 이름 앞에 스키마를 붙이거나 search_path에 스키마를 추가하세요.

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. 테이블이 대문자로 생성되었다면 정확히 동일하게 따옴표를 사용하거나, 한 번만 소문자로 이름을 바꿔서 다시는 따옴표가 필요 없도록 하세요.

    SELECT * FROM "Orders";
    ALTER TABLE "Orders" RENAME TO orders;

안전하게 재현하세요

SELECT * FROM table_that_does_not_exist;  -- ERROR: relation "table_that_does_not_exist" does not exist

질문

테이블이 존재하는데 왜 PostgreSQL은 릴레이션(relation)이 존재하지 않는다고 말하나요?

거의 항상 스키마나 대소문자가 원인입니다. 테이블의 스키마가 search_path에 없거나, 테이블이 따옴표로 묶인 대소문자 혼합 이름으로 만들어져 같은 방식으로 묶어 쿼리해야 합니다. lower(table_name)으로 information_schema.tables를 조회하면 실제 스키마와 철자를 확인할 수 있습니다.

다른 데이터베이스의 테이블에서 SELECT할 수 있나요?

아니요, 바로 그렇게는 안 됩니다. PostgreSQL 연결 하나는 데이터베이스 하나에만 붙습니다. postgres_fdw나 dblink 확장을 쓰거나, 다른 데이터베이스에 직접 연결하세요.

관련 오류

그 밖의 구문 오류 및 접근 규칙 위반 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

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