[프로젝트/DB] PostgreSQL intelliJ에 등록하기

 

※ 해당 포스팅은 PostgreSQL이 설치되어있다는 가정 하에 만들었다.

https://www.postgresql.org/

PostgreSQL

 
 
intelliJ 최우측에 보면 Database 탭이 있다.
해당 탭을 누르면 아래와 같은 이미지가 나오는데,

Database 탭

 
여기서 + 모양을 눌러서 내가 추가하고자 하는 PostgreSQL 을 찾는다.

 
로컬이면 localhost, 다른 환경에 있는 DB면 해당 서버 IP와 포트번호를 적어 넣는다.
 

 
이렇게 입력하고 TestConnection을 누르면?
 
아래와 같이 에러가 뜬다.
 

PostgreSQL DB Datasource & Driver 추가

 
위와 같이 오류가 떴다면 연결하는데 에러가 발생한 상황.
abcd 계정이 있는지, abcd의 비밀번호가 맞는지, 인코딩이 잘못된건 아닌지 확인해봐야 한다.
 
무슨 글자가 막 깨져있는데, 당황하지 말고 글 첫 마디에 "2BP01" 이라는 힌트가 주어져있다.
 
SQLSTATE 28P01 – invalid_password
 
찾아보니 해당 코드는 사용자의 이름과 비밀번호가 잘못되었다고 나와있다.
 

2BP01 의 발생 가능한 원인

🔧 자주 발생하는 원인

원인                                 설명

✅ 비밀번호 오타	입력한 비밀번호가 틀렸거나 공백이 포함됨
✅ 사용자 이름 오타	PostgreSQL은 사용자명을 구분하므로 철자 정확히 입력해야 함
✅ 인증 방식 문제	PostgreSQL 설정 파일 pg_hba.conf에서 MD5, scram-sha-256 등 인증 방식과의 충돌 가능성
⚠️ 인코딩 문제	IntelliJ에서 비밀번호를 입력할 때 문자 인코딩이 맞지 않아 올바르게 전달되지 않을 수 있음
⚠️ 특수 문자 포함	비밀번호에 특수문자 (#, $, % 등)가 있으면 일부 IDE나 URL 연결 시 인코딩 문제가 생김

 
근데 나는 abcd 계정을 만든 적이 없다.... 당연히 유효하지 않은 ID와 비밀번호임이 틀림없다.
 
그래서 intelliJ에 Datasource 나 Driver를 등록하기 위해서는 PostgreSQL에 사용자와 DB가 있어야 한다.
 
나는 DBeaver라는 편집 툴을 이용해서 데이터베이스 작업을 한다.
https://dbeaver.io/

DBeaver Community | Free Universal Database Tool

 
새로운 DB와 사용자를 만들기 위해서는 PostgreSQL 에서 기본적으로 제공하는 postgre  계정을 이용해야한다.
 
먼저 기존에 사용했던 postgre 로 로그인 후,
 

CREATE USER abcd WITH PASSWORD 'abcd';
GRANT ALL PRIVILEGES ON DATABASE postgres TO abcd;
CREATE DATABASE abcd OWNER abcd;

 
위 같은 쿼리를 순차적으로 수행한다.
 
성공해서 Test Connection을 누르면 아래와 같이 나온다.

postgreSQL 등록 성공

 
이제 이 이후로는 intellJ 에디터로도 PostgreSQL 을 작성하고  sql 문을 실행 및 저장이 가능하다.
 
 

※ postgre 

✅ 기본 제공 정보

항목                                                                                    기본 값

기본 사용자	postgres
기본 데이터베이스	postgres
기본 템플릿 DB	template0, template1

---

🔸 postgres 사용자

• PostgreSQL 설치 시 자동 생성되는 **슈퍼유저(superuser)**이다다.
• 시스템 초기 설정, 다른 사용자/DB 생성 등을 이 사용자로 처리한다.
• 비밀번호는 설치 시 직접 지정하거나, 나중에 ALTER USER로 설정할 수 있다.

🔸 postgres 데이터베이스

• 기본적으로 생성되는 데이터베이스이다.
• 일반적인 접속 시 이 DB를 통해 관리 작업을 수행하게 된다.
• 많은 툴(DBeaver, IntelliJ 등)에서 이 DB를 기본 접속 대상으로 삼는다.