Supabase 데이터베이스

EC2에 올릴 애플리케이션이 쓸 데이터베이스를 준비한다. 관리형 PostgreSQL 서비스인 Supabase를 사용한다.

#1. 왜 Supabase인가

DB 서버를 직접 운영하면 설치·백업·장애 복구·버전 업그레이드를 전부 떠안아야 한다. 관리형 데이터베이스는 그 운영 부담을 서비스 제공자가 대신 진다.

AWS에도 RDS라는 관리형 데이터베이스가 있다. 이 교안이 Supabase를 쓰는 이유는 이렇다.

실습에서 배우고 싶은 것은 "애플리케이션이 외부 데이터베이스에 붙어서 동작한다" 는 구조이지, VPC 서브넷 설계가 아니다. 네트워크 설정에 시간을 쓰지 않고 본질에 집중하려고 Supabase를 골랐다.

#2. 프로젝트 생성

supabase.com 에 GitHub 계정으로 로그인한다. 조직 화면 오른쪽 위의 New project 를 누른다.

조직 화면 오른쪽 위의 [New project]

프로젝트 생성 폼 — 리전을 EC2와 맞춘다

입력할 것은 세 가지다.

리전 목록 — Northeast Asia (Seoul) / ap-northeast-2

#2-1. Security — 기본값을 그대로 두지 않는다

폼 아래쪽에 체크박스 세 개가 있다.

Security — [Automatically expose new tables]를 끈다

Automatically expose new tables 는 새로 만든 테이블을 REST API 역할에 자동으로 열어 주는 설정이다. Supabase 자신이 화면에서 "We recommend disabling this to control access manually" 라고 끄기를 권한다.

우리 애플리케이션은 JDBC로 직접 붙으므로 REST API가 필요 없다. 꺼두면 EC2에 Docker로 배포하기에서 Hibernate가 만들 visit_count 테이블이 인터넷에 노출되지 않는다.

Advanced Configuration 을 펼치면 Postgres 종류를 고를 수 있다. 기본값 Postgres 를 그대로 둔다. 옆의 OrioleDB는 아직 알파다. 이 선택은 프로젝트를 만든 뒤에는 바꿀 수 없다.

Advanced Configuration — Postgres (DEFAULT) 를 그대로 둔다

화면에도 These settings cannot be changed after the project is created 라고 적혀 있다. OrioleDB 는 ALPHA 딱지가 붙어 있고 Supabase 스스로 Not recommended for production workloads 라고 표시한다.

설정을 마쳤으면 폼 맨 아래의 Create new project 를 누른다.

폼 맨 아래의 [Create new project]

프로젝트가 준비되는 데 1~2분 걸린다. STATUS 가 Healthy 가 되면 준비된 것이다.

프로젝트 대시보드 — STATUS가 Healthy가 되면 준비 완료

#3. 연결 문자열 — 이 장에서 가장 중요한 부분

화면 맨 위 브레드크럼(조직 / 프로젝트 / 브랜치) 오른쪽의 초록색 Connect 버튼을 누른다.

브레드크럼 오른쪽의 [Connect] 버튼

모달이 열리면 위쪽 탭에서 Direct — Connection string 을 고른다. 나머지 탭(Framework·Server·ORM·MCP)은 클라이언트 라이브러리를 쓸 때 보는 것이다.

Connect 모달 — Direct 탭의 세 가지 연결 방식

Connection Method 에 세 가지 방식이 제시되는데, 아무거나 고르면 안 된다.

표에 나오는 <프로젝트REF> 는 프로젝트마다 다른 20자짜리 식별자다. Connect 모달의 연결 문자열에서 db. 와 .supabase.co 사이, 또는 사용자명 postgres. 뒤에 붙어 있는 부분이 그것이다. 대시보드 첫 화면의 프로젝트 URL https://<프로젝트REF>.supabase.co 에서도 보인다.

풀러 호스트는 aws-<번호>-<리전>.pooler.supabase.com 꼴이다.

직접 연결은 IPv6가 기본이라고 화면이 직접 알려준다

#직접 눈으로 확인하기

교안을 믿지 말고 DNS를 조회해 본다. 명령 한 줄이면 끝난다.

nslookup -type=A    db.<프로젝트REF>.supabase.co
nslookup -type=AAAA db.<프로젝트REF>.supabase.co

직접 연결 주소는 A 레코드(IPv4)가 없고 AAAA 레코드(IPv6)만 나온다.

# -type=A  → 주소 줄이 아예 없다

# -type=AAAA
Address:  2406:da12:5ca:b702:...

풀러는 반대다.

# 아래 주소는 예시다. 자기 프로젝트의 풀러 호스트로 바꿔서 조회한다
nslookup -type=A aws-<번호>-ap-northeast-2.pooler.supabase.com

이름:       pool-tcp-ap-northeast-2-....elb.ap-northeast-2.amazonaws.com
Addresses:  15.164.120.176
            15.165.245.138
            13.124.111.232
Aliases:    aws-<번호>-ap-northeast-2.pooler.supabase.com

IPv4 주소가 여러 개 나온다. 뒤에 AWS 로드 밸런서가 서 있다는 것까지 보인다. IPv4만 가진 EC2가 붙을 수 있는 쪽은 이쪽이다.

#왜 Session pooler인가

풀러(pooler)는 애플리케이션과 데이터베이스 사이에 서서 연결을 중개한다. Supabase의 풀러는 IPv4로도 접속할 수 있어서 위 문제가 해결된다.

풀러에는 두 가지 모드가 있다.

• Session mode (5432) — 클라이언트가 연결을 끊을 때까지 DB 연결 하나를 붙잡고 있다. 일반적인 DB 접속과 동작이 같다.

• Transaction mode (6543) — 트랜잭션 단위로 연결을 빌려주고 반납한다. 연결을 아낄 수 있지만 제약이 따른다.

우리 애플리케이션은 컨테이너로 계속 떠 있고 HikariCP가 커넥션 풀을 유지한다. 이런 구조에는 Session mode가 맞다.

FATAL: (EMAXCONNSESSION) max clients reached in session mode
       - max clients are limited to pool_size: 15

Unable to determine Dialect without JDBC metadata
(please set 'jakarta.persistence.jdbc.url' ...)

Type 드롭다운에서 JDBC 를 고르면 Java용 연결 문자열을 바로 얻을 수 있다.

Type 드롭다운에서 JDBC를 고를 수 있다

Session pooler — 사용자명이 postgres. 다

대시보드가 주는 JDBC 문자열은 이렇게 생겼다.

jdbc:postgresql://<풀러호스트>:5432/postgres?user=postgres.<프로젝트REF>&password=<비밀번호>

이 형태를 그대로 쓰지는 않는다. 비밀번호가 URL 안에 들어가면 로그·프로세스 목록·오류 메시지에 그대로 찍힌다. 다음 절에서는 주소와 계정 정보를 분리해 환경 변수로 나눠 넣는다.

#4. 애플리케이션을 PostgreSQL로 전환

Docker Compose 장에서 만든 방문자 카운터 애플리케이션을 그대로 쓴다. 데이터베이스만 MySQL에서 PostgreSQL로 바꾼다.

#4-1. 드라이버 교체

build.gradle

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-actuator'

    // MySQL 드라이버를 PostgreSQL 드라이버로 교체한다
    runtimeOnly 'org.postgresql:postgresql'
}

#4-2. 접속 설정

src/main/resources/application.yml

spring:
  datasource:
    url: ${SPRING_DATASOURCE_URL}
    username: ${SPRING_DATASOURCE_USERNAME}
    password: ${SPRING_DATASOURCE_PASSWORD}
    hikari:
      # 블루·그린 배포 중에는 컨테이너 두 개가 잠시 동시에 뜬다.
      # 그만큼 커넥션도 두 배가 되므로 넉넉하게 잡지 않는다.
      maximum-pool-size: 5
  jpa:
    hibernate:
      ddl-auto: update

접속 정보는 코드에 적지 않고 환경 변수로 주입한다. 소스에 비밀번호를 적으면 Git에 올라가고, 이미지에 구우면 이미지를 받을 수 있는 사람이 모두 보게 된다.

주입할 값은 이렇게 생겼다.

SPRING_DATASOURCE_URL=jdbc:postgresql://<풀러호스트>:5432/postgres
SPRING_DATASOURCE_USERNAME=postgres.<프로젝트REF>
SPRING_DATASOURCE_PASSWORD=<2단계에서 저장한 비밀번호>

#5. 로컬에서 접속 확인

EC2에 올리기 전에 로컬에서 먼저 확인한다. 문제가 생겼을 때 원인이 애플리케이션인지 서버인지 나눠서 볼 수 있다.

이미지를 만들어 컨테이너로 띄운다. 이렇게 하면 로컬에 JDK나 Gradle을 깔지 않아도 된다 — Docker 기본 명령어 장에서 확인한 성질 그대로다.

docker build -t visit-counter:pg .

docker run --rm --name visit-counter-local -p 8080:8080 \
  -e SPRING_DATASOURCE_URL='jdbc:postgresql://<풀러호스트>:5432/postgres' \
  -e SPRING_DATASOURCE_USERNAME='postgres.<프로젝트REF>' \
  -e SPRING_DATASOURCE_PASSWORD='<비밀번호>' \
  visit-counter:pg

# Windows PowerShell — 줄 잇기는 \ 가 아니라 백틱(`)이다
docker run --rm --name visit-counter-local -p 8080:8080 `
  -e SPRING_DATASOURCE_URL='jdbc:postgresql://<풀러호스트>:5432/postgres' `
  -e SPRING_DATASOURCE_USERNAME='postgres.<프로젝트REF>' `
  -e SPRING_DATASOURCE_PASSWORD='<비밀번호>' `
  visit-counter:pg

기동되면 다른 터미널에서 curl 로 확인한다.

curl http://localhost:8080
# 방문 횟수: 1

curl http://localhost:8080/actuator/health
# {"groups":["liveness","readiness"],"status":"UP"}

ddl-auto: update 설정 덕분에 애플리케이션이 뜰 때 visit_count 테이블이 자동으로 만들어진다. Supabase 대시보드의 Table Editor 에서 확인할 수 있다.

Table Editor — visit_count 테이블에 행이 생겼다

SQL Editor 에서 직접 조회해도 된다.

select * from visit_count;

SQL Editor — 조회할 때마다 count 가 올라간다

요청할 때마다 count 가 올라가고 updated_at 이 갱신되면 애플리케이션과 데이터베이스가 제대로 연결된 것이다.

#6. 무료 플랜에서 주의할 것

정지된 프로젝트를 열면 이 화면이 나온다. Resume project 를 누르고 확인 창에서 한 번 더 Resume 을 누른다.

일시 정지된 프로젝트 — 데이터는 그대로 남아 있고 [Resume project] 로 되살린다

이 교안을 쓰며 한 달 쉰 프로젝트를 재개해 보니 이랬다.

재개에 몇 분이 걸리므로 수업 시작 직전에 누르면 늦는다. 화면에는 재개 가능 기한(약 1년)도 함께 나온다. 그 뒤로는 재개할 수 없고 데이터 백업 파일만 내려받을 수 있다.

그 밖의 제약은 다음과 같다.

실습용 방문자 카운터는 행이 하나뿐이라 용량은 문제되지 않는다. 정지만 신경 쓰면 된다.

#7. 실습 정리

Supabase 무료 플랜은 켜둬도 요금이 나가지 않으므로 프로젝트를 지우지 않아도 된다. Part 4 의 남은 장에서 계속 쓴다.

다만 비밀번호와 연결 문자열은 EC2에 Docker로 배포하기부터 계속 필요하다. 아래 세 가지를 손이 닿는 곳에 정리해 둔다.

• 풀러 호스트 주소 (Session pooler, 5432)

• 사용자명 postgres.<프로젝트REF>

• 데이터베이스 비밀번호

다음 장 — EC2에 Docker로 배포하기