4-12. PostgreSQL

About 2 min

4-12. PostgreSQL 관련

pahkey/sbb3 - 4-12

앞서 얘기했듯이 H2 데이터베이스는 개발 단계에서는 유용하지만 운영 환경에서 사용하기에는 많이 부족한 데이터베이스이다. 따라서 본격적으로 시스템을 운영하기로 마음을 먹었다면 H2 보다 성능이 좋은 데이터베이스를 고려해야 한다. 오라클과 같은 상용 데이터베이스도 있지만 작은 규모의 서비스들은 대체로 PostgreSQL이나 MySQL 등의 무료 데이터베이스를 주로 사용한다.

이번 장에서는 PostgreSQL 데이터베이스를 사용하는 방법에 대해서 알아보자.

PostgreSQL 설치

PostgreSQL 데이터베이스를 사용하는 방법에는 두 가지가 있다. 하나는 AWS 서버에 직접 PostgreSQL을 설치하여 사용하는 것이고 다른 하나는 AWS가 제공하는 데이터베이스 인스턴스를 사용하는 방법이다. 하지만 데이터베이스를 공부할 목적이 아니라면 PostgreSQL을 직접 설치하는 것은 권장하고 싶지 않다. 데이터베이스를 직접 설치하고 상황에 맞게 환경을 설정하는 것이 결코 쉬운 일이 아니기 때문이다.

우리는 두번째 방법으로 PostgreSQL을 사용해 보자.

AWS 라이트세일을 이용하여 PostgreSQL 데이터베이스를 운영하려면 한달에 약 15달러의 추가 비용이 발생한다. (첫 세달은 무료로 사용가능하다.)

먼저 AWS에 로그인한 후 웹브라우저로 다음 URL에 접속하자.

https://lightsail.aws.amazon.com

<FontIcon icon="iconfont icon-select"/> 탭을 선택하고 <FontIcon icon="iconfont icon-select"/> 버튼을 클릭한다. — `["데이터베이스"]` 탭을 선택하고 `["데이터베이스 생성"]` 버튼을 클릭한다.

<FontIcon icon="iconfont icon-select"/>을 선택한다. — `["AWS 리전 및 가용 영역 변경"]`을 선택한다.

이 책을 작성하는 시점의 PostgreSQL 최신 버전은 12.10이다.

플랜을 선택한다. ( 플랜은 첫 세달은 무료로 사용할 수 있다.) — `$15` 플랜을 선택한다. (`$15` 플랜은 첫 세달은 무료로 사용할 수 있다.)

리소스 이름에 "Database-1"을 입력하고 <FontIcon icon="iconfont icon-select"/> 버튼을 클릭한다. — 리소스 이름에 "Database-1"을 입력하고 `["데이터베이스 생성"]` 버튼을 클릭한다.

그러면 다음 화면처럼 데이터베이스가 생성된다. 하지만 상태는 "생성 중"으로 아직 사용할 수 없는 상태이다.

한참을 기다리면 다음처럼 데이터베이스의 상태가 "사용 가능"으로 변경된다.

※ 데이터베이스 생성에는 대략 10~15분 정도의 시간이 소요되었다.

그리고 이 화면에서 "Database-1"을 선택하자.

그러면 다음과 같은 "연결 세부 정보"를 확인할 수 있는 화면이 나타난다.

연결 세부 정보에서는 중요한 정보 3가지를 확인할 수 있다.

사용자 이름: dbmasteruser를 확인할 수 있음
암호: <표시>를 누르면 암호를 볼 수 있음
데이터베이스 주소: "엔드포인트"로 데이터베이스의 도메인 주소가 적혀 있음

이 정보는 SBB에서 PostgreSQL에 접속할 때 필요하므로 반드시 기억해 두어야 한다.

데이터베이스 생성

AWS의 PostgreSQL 인스턴스를 생성하였다. 이제 생성된 PostgreSQL 인스턴스에 SBB 시스템이 사용할 "sbb" 데이터베이스를 생성해 보자.

PostgreSQL 클라이언트 설치

PostgreSQL에 접속하기 위해서는 다음처럼 PostgreSQL 클라이언트를 먼저 설치해야 한다.

sudo apt install postgresql-client

postgresql-client 패키지를 설치하였다. 이 패키지를 설치하면 createdb나 psql등의 명령어를 사용할 수 있게 된다.

sbb 데이터베이스 생성

이제 다음처럼 createdb 명령을 실행하여 sbb 데이터베이스를 생성하자.

createdb sbb --username=dbmasteruser -h <데이터베이스주소>

<데이터베이스주소>는 위에서 기억해 둔 "엔드포인트"에 해당되는 데이터베이스 주소이다. (<, > 기호는 빼고 입력해야 한다.)

사용예

createdb sbb --username=dbmasteruser -h ls-be78fd2c2exxxxxxxxxxxxxxxx2c9.cqlcyugj7ibs.ap-northeast-2.rds.amazonaws.com

createdb 명령을 실행하면 암호를 물어보는데 위에서 기억해 둔 암호를 입력하면 된다.

데이터베이스에 접속

이제 우리가 만든 SBB 서비스에서 sbb 데이터베이스에 접속하는 방법에 대해서 알아보자.

PostgreSQL 라이브러리 설치

SBB에서 PostgreSQL 서버에 접속하려면 PostgreSQL 라이브러리가 필요하다. 다음과 같이 build.gradle 파일을 수정하여 PostgreSQL 라이브러리를 설치하자.

// (... 생략 ...)

dependencies {
    // (... 생략 ...)
    runtimeOnly 'org.postgresql:postgresql'
}

// (... 생략 ...)

위와 같이 수정 후 ["Refresh Gradle Project"]를 실행하자.

데이터베이스 설정

로컬 서버는 기존의 H2 데이터베이스를 그대로 사용하고 서버만 PostgreSQL 데이터베이스를 사용해야 하므로 application-prod.properties 파일만 다음처럼 수정하자.

파일명: /sbb/src/main/resources/application-prod.properties

# DATABASE
spring.datasource.url=jdbc:postgresql://<데이터베이스주소>:5432/sbb
spring.datasource.driverClassName=org.postgresql.Driver
spring.datasource.username=dbmasteruser
spring.datasource.password=<암호>

# JPA
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.show_sql=true

# logging
// (... 생략 ...)

<데이터베이스주소>와 <암호>는 위에서 기억해 둔 값을 입력한다. (<, > 기호는 빼고 입력해야 한다.)

데이터베이스 변경 확인

위의 과정을 잘 진행했다면 새로운 배포파일을 생성하여 서버에 적용하고 stop.sh, start.sh 을 실행하여 SBB 서비스를 재시작하자. 데이터베이스가 변경되었으므로 기존의 데이터는 보이지 않을 것이다.

spring.jpa.hibernate.ddl-auto

현재 application-prod.properties 파일의 spring.jpa.hibernate.ddl-auto 값은 update로 되어 있다. update의 경우 엔티티가 변경될 때마다 테이블 변경 쿼리문(DDL 문)이 자동으로 실행된다. 하지만 운영 환경에서는 조금 위험한 방법이다. 운영환경에서는 테이블 변경 쿼리를 자동으로 실행하지 않고 수동으로 실행하는 것이 안전하다. 따라서 위의 항목도 update 대신 none 또는 validate로 설정하기를 추천한다.