개발 도구 및 환경 (Tools & Environment)

PostgreSQL 서버 켜기부터 기초 동작까지 (CMD 기준)

코린이ch 2025. 1. 6. 23:25

PostgreSQL은 강력한 오픈 소스 데이터베이스 관리 시스템(DBMS)입니다.

이번 포스팅에서는 Windows CMD를 활용하여 PostgreSQL 서버를 실행하고, 기본적인 데이터베이스 작업을 수행하는 방법을 단계별로 설명하겠습니다.


1. PostgreSQL 설치 확인

PostgreSQL이 설치되어 있는지 확인하려면 CMD에서 다음 명령어를 실행하세요.

psql --version
  • PostgreSQL 버전이 출력되면 설치가 완료된 상태입니다.
  • 출력 예:
    psql (PostgreSQL) 15.3
    

2. PostgreSQL 서버 시작

Windows에서 PostgreSQL 서버를 수동으로 시작하려면 다음 단계를 따릅니다.

  1. PostgreSQL이 설치된 경로로 이동
    PostgreSQL의 기본 설치 경로는 일반적으로 C:\Program Files\PostgreSQL\<버전>\bin 입니다.
  2. PostgreSQL 서버 실행
    PostgreSQL 서버를 시작하려면 pg_ctl 명령어를 사용합니다. 데이터 디렉토리를 지정하여 서버를 시작합니다.
    • 성공 메시지:
      server starting
      
      pg_ctl -D "C:\Program Files\PostgreSQL\<버전>\data" start
  3. 서버 상태 확인
    서버가 정상적으로 실행 중인지 확인하려면 : pg_ctl -D "C:\Program Files\PostgreSQL\<버전>\data" status
  4. 서버 중지
    서버를 중지하려면: pg_ctl -D "C:\Program Files\PostgreSQL\<버전>\data" stop

3. psql로 PostgreSQL 접속하기

PostgreSQL 클라이언트 도구인 psql을 사용하여 데이터베이스에 접속합니다.

  1. PostgreSQL 접속
    PostgreSQL에 접속하려면 CMD에서 다음 명령어를 입력합니다.
    • -U postgres: 기본 관리자 계정으로 접속.
    • 암호를 요청받으면 설치 시 설정한 암호를 입력하세요.
    • psql -U postgres
  2. 데이터베이스 목록 확인
    PostgreSQL에 접속한 후, 현재 데이터베이스 목록을 확인하려면 : \l
  3. 데이터베이스 선택
    데이터베이스를 선택하려면:
    • 예: \c mydb (\c 데이터베이스명)
  4. 테이블 목록 확인
    선택한 데이터베이스 내 테이블 목록을 확인하려면 : \dt

4. 기초 SQL 명령어

PostgreSQL에서 기본적으로 사용할 수 있는 몇 가지 SQL 명령어입니다.

  1. 새로운 데이터베이스 생성 CREATE DATABASE testdb;
  2. 테이블 생성 CREATE TABLE users ( id SERIAL PRIMARY KEY, name VARCHAR(50), email VARCHAR(50) );
  3. 데이터 삽입 INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');
  4. 데이터 조회 SELECT * FROM users;
  5. 데이터베이스 삭제 데이터베이스를 삭제하려면 PostgreSQL 접속 후 : DROP DATABASE testdb;

5. PostgreSQL 종료

작업이 끝난 후 PostgreSQL 서버를 중지하려면:

pg_ctl -D "C:\Program Files\PostgreSQL\<버전>\data" stop

6. 문제 해결

PostgreSQL 사용 중 흔히 발생할 수 있는 문제와 해결 방법입니다.

  1. 포트 충돌
    PostgreSQL 기본 포트(5432)가 이미 사용 중이라면 다른 포트를 사용하도록 설정합니다.  pg_ctl -D "C:\Program Files\PostgreSQL\<버전>\data" start -o "-p 5433"
  2. psql 명령어가 인식되지 않음
    CMD에서 psql 명령어를 사용할 수 없다면 환경 변수에 PostgreSQL bin 경로를 추가하세요:
    • 경로: C:\Program Files\PostgreSQL\<버전>\bin

마무리

이번 포스팅에서는 PostgreSQL 서버를 Windows CMD를 통해 시작하고, 기본적으로 사용할 수 있는 명령어들을 소개했습니다. 다음 포스팅에서는 PostgreSQL의 고급 기능과 GUI 도구를 사용하는 방법을 다룰 예정입니다.