Quack: DuckDB 클라이언트-서버 프로토콜

Context

DuckDB의 In-process 아키텍처로 인한 다중 프로세스 간 상태 동기화 및 동시 수정 제약 발생. 기존 Arrow Flight SQL 및 PostgreSQL 기반 우회 방식의 높은 오버헤드와 프로토콜 왕복 횟수로 인한 성능 병목 존재.

Technical Solution

• HTTP 기반 요청-응답 패턴 채택을 통한 표준 네트워크 스택 활용 및 DuckDB-Wasm의 네이티브 연결성 확보
• application/duckdb 전용 MIME 타입 도입 및 검증된 WAL 내부 직렬화 프리미티브 활용을 통한 데이터 전송 최적화
• 단일 왕복(Single Round-trip) 구조 설계를 통한 쿼리 실행 및 결과 fetch 지연 시간 최소화
• 사용자 정의 SQL 매크로 기반의 인증 콜백 및 권한 부여 함수 설계를 통한 유연한 보안 모델 구축
• 리버스 프록시(Nginx)를 통한 SSL 종료 구조 권장으로 핵심 로직의 의존성 제거 및 성능 유지
• 외부 표준 형식(Arrow) 대신 자체 직렬화를 선택하여 신규 데이터 타입 배포 속도와 제어권 확보