[DB] PostgreSQL & pgAdmin 4 설치 후 기본설정 및 외부 접속 허용 설정 가이드

https://www.postgresql.org/

PostgreSQL

PostgreSQL은 세계에서 가장 진보된 오픈 소스 데이터베이스로, 확장성과 안정성을 갖춘 강력한 기능을 제공합니다. 다양한 플랫폼에서 사용 가능하며, 데이터 일관성과 복잡한 쿼리 처리에 뛰어난 고급 기능을 지원합니다. MySQL이 속도와 단순함을, Oracle이 고급 관리 기능을 강조하는 반면, PostgreSQL은 오픈 소스임에도 엔터프라이즈급 기능과 커뮤니티 지원으로 뛰어난 확장성과 유연성을 제공합니다. 이를 통해 PostgreSQL은 다양한 환경에서 신뢰성과 성능을 모두 갖춘 최적의 데이터베이스 솔루션으로 자리 잡고 있습니다.🙂

 

1️⃣ PostgreSQL 설치

EnterpriseDB에서 PostgreSQL 설치 파일을 다운로드한 후 설치를 진행합니다. 설치 파일을 다운로드할 때, 사용할 PostgreSQL 버전을 선택해야 합니다. 프로젝트에 맞는 적절한 버전을 선택하는 것이 중요하며, 각 버전의 특징은 아래와 같습니다.

• 17 (RC1) : 최신 베타 버전, 테스트 목적에 적합하나 안정성 보장 어려움.
• 16.4 : 최신 안정 버전, 성능 및 기능 개선, 장기적 사용에 적합.
• 15.8 : 안정성과 성능 균형 잡힌 버전, 새로운 기능 필요 없는 경우 적합.
• 14.13 : 안정적인 구버전, 보수적 업그레이드 전략에 적합.

 

또한, 설치 중간에 관리자(superuser) 비밀번호를 설정해야 하며, 이 비밀번호는 나중에 데이터베이스에 접근하고 관리할 때 필수적이므로 꼭 기억해야 합니다.

 

설치가 완료된 후 pgAdmin 4를 통해 데이터베이스 관리를 할 수 있으며, 필요에 따라 Stack Builder로 추가적인 확장 기능을 설치할 수 있습니다.

01234567891011

 

2️⃣ pgAdmin 4 실행하기

pgAdmin은 PostgreSQL을 관리할 수 있는 GUI 툴로, MySQL의 워크벤치나 Oracle의 SQL Developer처럼 테이블 및 사용자 생성 등의 작업을 쉽게 수행할 수 있습니다.

 

PostgreSQL 설치 시 함께 설치되므로 시작 메뉴에서 pgAdmin 4를 검색하여 바로 실행합니다.

* 설치경로 : C:\Program Files\PostgreSQL\14\pgAdmin 4\runtime\pgAdmin4.exe

 

프로그램 실행 시, 설치 과정에서 설정한 PostgreSQL 관리자(superuser) 비밀번호를 입력해야 합니다. 이 비밀번호는 데이터베이스 관리에 필수적입니다.

0123

 

3️⃣ 사용자, 데이터베이스, 테이블 생성 및 쿼리 실행 방법

✔️ 사용자 생성

• pgAdmin 4에서 [Login/Group Roles] 우클릭 > [Create] > [Login/Group Role...]을 클릭하여 새 사용자를 생성합니다.
• General 탭 : 사용자 이름을 입력합니다.
• Definition 탭 : 사용자의 비밀번호를 입력합니다.
• Privileges 탭 : 사용자의 권한을 설정합니다.
  • Can login : 사용자가 로그인할 수 있는 권한입니다. 기본적으로 체크되어 있지 않으므로 반드시 체크해야 로그인 가능합니다.
  • Inherit : 사용자가 속한 그룹의 권한을 상속받을지 여부를 설정합니다. 기본적으로 체크되어 있습니다.
  • 기본적으로 체크되지 않은 권한들 : Superuser, Create DB, Create Role, Replication, Bypass RLS 등은 필요에 따라 수동으로 체크해야 합니다.

 

✔️ 데이터베이스 생성

• [Databases] 우클릭 > [Create] > [Database...]를 클릭하여 새 데이터베이스를 생성합니다.
• 데이터베이스 소유자를 새로 만든 사용자로 설정할 수 있습니다. 이렇게 하면 그 사용자가 해당 데이터베이스에 대해 관리할 수 있는 권한을 가지게 됩니다.

 

✔️ 테이블 생성

• 생성한 데이터베이스를 선택한 후 [Schemas] > [public] > [Tables] 우클릭 > [Create] > [Table...]을 선택합니다.
• 테이블 이름과 컬럼들을 정의한 후 Save를 클릭하여 테이블을 생성합니다.

 

✔️ 쿼리 실행

• 쿼리를 실행하려면, 생성한 데이터베이스를 선택하고 상단 메뉴에서 Query Tool 아이콘을 클릭합니다.
• 쿼리 창에 SQL 쿼리를 입력한 후 Run(F5) 버튼을 클릭하여 실행합니다.

 

01234

 

💡 윈도우 서버에서 PostgreSQL 외부 접속 허용하기

✔️ pg_hba.conf 파일 설정

• C:\Program Files\PostgreSQL\14\data\pg_hba.conf 파일을 엽니다. (메모장 등)
  (PostgreSQL의 Host-Based Authentication 설정 파일)
• "IPv4 local connections:" 섹션 아래에 다음 줄을 추가합니다. (87번 라인)
  

  host all all 0.0.0.0/0 md5

• 이 설정은 모든 IP 주소에서 모든 데이터베이스에 대해 MD5 인증을 통해 접근을 허용합니다.

 

✔️ Windows 방화벽 설정

1. "Windows Defender 방화벽"을 열고(시작메뉴 검색), 왼쪽 사이드바에서 고급 설정으로 이동합니다.
2. "인바운드 규칙"을 클릭하고 "새 규칙"을 선택합니다.
3. 규칙 유형을 "포트"로 선택한 후, TCP 및 포트 5432를 입력합니다. (PostgreSQL이 사용하는 기본 포트)
4. "연결 허용"을 선택하고, 적용할 네트워크를 선택한 뒤, 규칙 이름을 입력하고 "마침"을 클릭합니다.

 

✔️ 설정 완료 후 PostgreSQL 서버를 재시작하거나 해당 서버를 우클릭하여 Reload Configuration을 선택합니다.

 

01234

 

💡 클라이언트에서 PostgreSQL 서버에 외부 접속하기

• pgAdmin에서 Servers를 우클릭한 후 Register > Server를 선택합니다. Connection 탭에서 외부 서버의 IP 주소(또는 도메인), 포트(기본 5432), 사용자 이름, 비밀번호를 입력하고 Save를 클릭하여 서버에 연결합니다. 등록된 서버에서 데이터베이스 작업을 수행할 수 있습니다.