// PostgreSQL 오류 참조

PostgreSQL 3D000: 데이터베이스가 존재하지 않음

연결이 이 서버에 없는 데이터베이스를 가리킵니다. 흔한 원인은 오타, 대소문자 불일치, 또는 클라이언트가 데이터베이스 이름의 기본값을 사용자 이름으로 채우는 것입니다.

SQLSTATE
3D000
이름
invalid_catalog_name
카테고리
잘못된 카탈로그 이름
오류 메시지
database "shop" does not exist

의미

PostgreSQL 연결은 연결 문자열에 지정한 데이터베이스 하나로만 이루어집니다. 접속한 서버에 그 이름의 데이터베이스가 없으면 로그인이 3D000으로 실패합니다.

데이터베이스 이름은 따옴표를 붙여 만들면 대소문자를 구분하며, 많은 클라이언트가 기본값을 채워 넣습니다: psql 및 libpq는 데이터베이스 이름이 주어지지 않으면 사용자 이름을 데이터베이스 이름으로 쓰므로, psql -U app 는 데이터베이스를 열려고 하는데, 그 이름은 app.

일반적인 원인

  • 오타이거나, 다음과 같이 따옴표로 묶은 대소문자 혼합 이름으로 생성된 데이터베이스 "Shop".
  • 데이터베이스가 지정되지 않아 클라이언트가 사용자 이름을 데이터베이스 이름으로 사용했습니다.
  • 데이터베이스가 생성되지 않은 다른 서버나 포트(다른 인스턴스, 다른 컨테이너)에 연결하는 경우.
  • 데이터베이스가 삭제되었거나, 설정 스크립트가 아직 만들지 않은 상태입니다.

해결 방법

  1. 항상 존재하는 데이터베이스에 연결합니다. 예를 들어 postgres, 그리고 데이터베이스를 나열합니다.

    -- psql -h db -U app -d postgres
    SELECT datname FROM pg_database ORDER BY datname;
  2. 데이터베이스가 없으면 새로 만듭니다.

    CREATE DATABASE shop OWNER app;
  3. 연결 문자열에 데이터베이스 이름을 명시적으로 지정합니다. 예를 들어 postgresql://app@db:5432/shop 또는 psql -d shop.

  4. 대문자로 생성되었다면 정확한 이름을 사용합니다. URL이나 -d 옵션에서는 따옴표가 필요하지 않습니다: psql -d Shop.

질문

사용자 이름만 적었을 뿐인데 psql이 데이터베이스가 존재하지 않는다고 나오는 이유는 무엇인가요?

데이터베이스를 지정하지 않으면 psql은 사용자 이름과 같은 이름의 데이터베이스에 연결합니다. -d postgres 또는 원하는 데이터베이스를 지정하세요.

관련 오류

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

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

SQLly에서 PostgreSQL 작업하기

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