정정지용
기술스택 목록
데이터베이스

PostgreSQL

프로젝트 12개에서 사용했습니다. 각 프로젝트에서 어떤 역할로 썼는지 아래에 정리했습니다.

이 기술은 무엇인가요?

관계형 데이터를 안정적으로 저장·조회하는 오픈소스 객체-관계형 데이터베이스

PostgreSQL은 SQL 표준을 폭넓게 지원하는 오픈소스 관계형 데이터베이스 관리 시스템(RDBMS)이다. 트랜잭션 무결성과 동시성 제어를 보장하면서도, JSON, 배열, 사용자 정의 타입 등 비정형 데이터까지 다룰 수 있도록 확장성을 갖춘 것이 특징이다. 단순 CRUD 저장소를 넘어 LISTEN/NOTIFY 같은 메시징 기능, materialized view 같은 분석 도구, 제약 조건 기반 정합성 보장까지 하나의 엔진 안에서 제공하려는 목적으로 발전해왔다. 그 결과 트랜잭션 처리, 분석 쿼리, 이벤트 기반 워커의 상태 저장소 등 다양한 용도로 널리 쓰인다.

이럴 때 사용합니다

  • 트랜잭션 무결성과 제약 조건으로 데이터 정합성을 엄격히 지켜야 할 때
  • 이벤트 처리 진행 상태(offset, cursor)를 안전하게 영속화해야 할 때
  • 집계·분석성 쿼리와 materialized view로 리포팅을 함께 처리하고 싶을 때
  • LISTEN/NOTIFY로 별도 메시지 브로커 없이 가벼운 이벤트 알림을 구현하고 싶을 때

핵심 개념

ACID Transaction
여러 작업을 하나의 논리적 단위로 묶어 원자성과 일관성을 보장하며, 중간에 실패하면 전체를 되돌린다.
Constraint
UNIQUE, FOREIGN KEY, CHECK 등으로 데이터의 무결성 규칙을 DB 레벨에서 강제해 애플리케이션 버그로부터 데이터를 보호한다.
MVCC (Multi-Version Concurrency Control)
읽기와 쓰기가 서로 잠금 없이 동시에 진행되도록 여러 버전의 행을 관리하는 동시성 제어 방식이다.
LISTEN/NOTIFY
특정 채널에 이벤트를 발행(NOTIFY)하고 구독 중인 클라이언트(LISTEN)가 이를 실시간으로 수신하는 경량 pub/sub 메커니즘이다.
Materialized View
쿼리 결과를 실제 테이블처럼 저장해두고 필요할 때 갱신하는 뷰로, 반복되는 집계·분석 쿼리의 응답 속도를 높인다.
Index
특정 컬럼에 대한 조회 속도를 높이기 위한 별도 자료구조로, B-tree 외에도 GIN, GiST 등 다양한 종류를 지원한다.

UNIQUE 제약으로 중복 지급 방지하기

UNIQUE 제약과 ON CONFLICT 구문을 활용해 동일 이벤트에 대한 중복 처리를 DB 레벨에서 막는 예시이다.

SQL
-- 보상 지급 결과를 저장하는 테이블
CREATE TABLE reward_payouts (
  id BIGSERIAL PRIMARY KEY,
  round_id BIGINT NOT NULL,
  user_id BIGINT NOT NULL,
  amount NUMERIC NOT NULL,
  paid_at TIMESTAMPTZ DEFAULT now(),
  UNIQUE (round_id, user_id)
);

-- 동일 라운드에 같은 유저가 두 번 지급되면 에러 발생
INSERT INTO reward_payouts (round_id, user_id, amount)
VALUES (1001, 55, 250)
ON CONFLICT (round_id, user_id) DO NOTHING;

처음 쓸 때 흔한 함정

  • 커넥션을 매번 새로 열면 오버헤드가 크므로 커넥션 풀링 없이 사용하면 병목이 생긴다
  • 인덱스를 무분별하게 추가하면 조회는 빨라져도 쓰기 성능이 저하될 수 있다
  • 긴 트랜잭션이나 유휴 커넥션이 오래 남으면 VACUUM이 지연되어 성능이 저하될 수 있다

위 개요는 기술 학습을 돕기 위해 자동 생성된 일반 설명입니다. 정확한 사양과 최신 정보는 공식 문서를 확인하세요.

프로젝트별 활용 방식

위 개념이 실제 프로젝트에서 어떻게 쓰였는지 보여줍니다.

  2. 02백엔드
    2026년 7월

    KYB 기업심사 REST API

    Go + Echo 기반 멀티테넌트 KYB(Know Your Business) 심사 플랫폼. 기업 등록부터 3단계 심사, WLF 스크리닝, 재제출 워크플로까지 지원.

    이 프로젝트에서의 PostgreSQL 활용

    메인 데이터베이스, 멀티테넌트 스키마 분리

    kyb-api프로젝트 자세히 보기 →
  4. 04백엔드
    2026년 7월

    화재 감지 시스템 온프레미스 백엔드

    실내 화재/연기를 카메라 + AI(YOLO, VLM)로 감지하여 이벤트·알림·웹훅을 관리하는 Spring Boot 3.2 기반 온프레미스 백엔드

    이 프로젝트에서의 PostgreSQL 활용

    메인 데이터베이스 (이벤트·카메라·사용자·감사 로그 저장)

    firescout-3.0-onpremise-backend프로젝트 자세히 보기 →

함께 사용한 기술

위 프로젝트들에서 같이 쓰인 다른 기술입니다.

Docker7Flyway5Java5Spring Boot5Spring Security5ArgoCD4AWS S34Jenkins4Kubernetes4Kustomize4Prometheus4Spring Data JPA4