DuckDB 2.0 LTS "Cinnamon Teal" — 새 파서가 기본, VARIANT 타입, 비동기 I/O, 그리고 2.0 파일은 1.x가 못 읽는다

8월 20일에 예고를 다뤘던 DuckDB 2.0이 나왔습니다. 코드명 "Cinnamon Teal"(계피색 쇠오리)입니다.

호환이 깨지는 것

스토리지 포맷. 2.0은 기존 파일을 읽고 쓸 수 있고 그 파일은 1.x에서도 열립니다. 그러나 2.0이 새로 만든 파일은 1.x가 읽지 못합니다. 파일을 주고받는 파이프라인에서 생산자만 먼저 올리면 소비자가 깨집니다.

SQL 파서. PEG 기반 새 파서가 기본입니다. SET enable_legacy_parser = true;로 돌릴 수 있고, 의도적으로 바뀐 동작은 마이그레이션 가이드에 있습니다.

람다. 단일 화살표 x -> x + 1이 기본 비활성·deprecated, 2.1에서 제거됩니다.

MERGE / UPDATE ... FROM. 여러 행이 매칭될 때의 의미가 명확히 정의됐습니다. 전에 모호하게 돌던 쿼리의 결과가 바뀔 수 있습니다.

빌드. C++17 필요, 릴리스 빌드 기본 컴파일러 Clang, ICU 라이브러리 제거(icu 확장이 직접 구현). amalgamation 빌드와 macOS x86_64는 deprecated, 2.1에서 중단.

C API v2. 새로 제공되지만 아직 안정화 전입니다.

새 기능

• VARIANT 타입 — 반구조 데이터를 1급으로. 샤딩(shredding) 지원, variant_* 함수.
• 비동기 I/O — Parquet, CSV, 네이티브 스토리지. s3:// 같은 원격 읽기의 병렬성이 올라갑니다. 정량 수치 없이 네트워크 처리량 그래프만 있습니다.
• Quack 프로토콜 — 클라이언트-서버 실행. CONNECT 문, CLI의 -serve / -connect. 임베디드 전용이던 DuckDB가 서버로도 돕니다.
• 에이전트 모드 -agent — 자체 TPC-H 실험에서 LLM이 읽어야 하는 출력량을 59% 줄였다고 합니다.
• 트리거 CREATE TRIGGER.
• SQL: $variable 축약, 데이터 수정 CTE, NEAREST 조인, 중첩 스키마, JSON 변경 함수, FETCH FIRST, GROUP BY의 UNNEST.
• 확장 저장소 등록, DuckLake 1.1, Iceberg·Delta 확장 갱신.

지원 정책

버전	지원
2.0 LTS	최소 2027년 10월
1.4	2026년 11월 17일까지
1.5	2027년 3월까지 (전환용, 사실상 LTS)

글에 없는 것

1.0~1.3의 지원 정책, 성능 개선의 전체 벤치마크, C API v2 외 API 호환 깨짐의 세부 목록. 업그레이드 절차는 마이그레이션 가이드로 넘깁니다.

실무에서 할 일

공식 권고가 분명합니다. 섀도 시스템에서 먼저 돌리고, 미션 크리티컬이면 11월 첫 패치를 기다리세요. 순서는 이렇습니다.

1. 파일을 읽는 쪽부터 2.0으로 올립니다. 쓰는 쪽을 먼저 올리면 읽는 쪽이 깨집니다.
2. 기존 쿼리를 새 파서로 돌려 결과를 비교합니다. 다르면 enable_legacy_parser로 되돌려 원인을 좁힙니다.
3. -> 람다를 lambda 구문으로 바꿉니다. 2.1에서 사라집니다.
4. 1.4를 쓰고 있다면 11월 17일까지 1.5나 2.0으로 가야 합니다.