대부분의 데이터 접근 계층이 데이터베이스의 실제 동작을 모델링하지 못해 연결 정책을 애플리케이션에 떠넘기는 문제

Context

Entity Framework Core, NHibernate, Dapper 등 주요 데이터 접근 라이브러리는 서버형 데이터베이스(SQL Server, PostgreSQL)의 동작을 기준으로 설계됐다. SQLite, DuckDB 같은 임베디드 데이터베이스나 LocalDB 같은 특수 환경에서는 연결 정책, 동시성 제어, 유휴 언로드 같은 데이터베이스 고유의 제약을 반영하지 못한다. 결과적으로 개발자가 조건 분기, 함수 플래그, 재시도 로직으로 이를 보완해야 하며 프로덕션 장애까지 이어진다.

Technical Solution

• DbMode를 통한 데이터베이스 동작 모델링: SingleWriter, Best 같은 설정값으로 데이터베이스별 제약을 라이브러리 수준에서 처리하도록 구조화
• 임베디드 데이터베이스 연결 수명 관리: SQLite :memory: 모드에서 각 연결이 독립적인 데이터베이스임을 인식하고 연결을 장시간 유지하도록 강제
• 파일 기반 SQLite의 단일 쓰기 제약 처리: 엔진 수준의 단일 쓰기 요구사항을 라이브러리가 인식하고 쓰기 충돌 대신 대기열 처리로 변환
• LocalDB 유휴 언로드 방지: 센티널 연결(쿼리 실행 없이 연결만 유지)을 자동으로 관리하여 유휴 언로드 발생 차단
• 풀 거버넌스 통합: Turnstile 기반 읽기/쓰기 제어로 풀 용량 도달 시 순차 대기열 구현, 실패 대신 예측 가능한 성능 저하

Key Takeaway

데이터 접근 라이브러리는 SQL 생성 품질보다 데이터베이스의 연결 정책, 동시성 규칙, 아이덴티티 관리 같은 운영 모델을 먼저 정확하게 모델링해야 한다. 이를 애플리케이션에 위임하면 복잡성이 코드에 흩어져 테스트와 유지보수가 어려워진다.