본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
DuckDB 고급 활용

시작과 기준선

포지셔닝과 적합한 워크로드버전·설치·런타임 기준연결·스토리지 모델실행 가능한 예제 번들

파일·레이크 분석

CSV·JSON 수집Parquet 레이크 모델링다중 파일·스키마 진화파티션 쓰기와 오브젝트 스토리지Lakehouse 포맷

분석 SQL·연동

Friendly SQL과 매크로시계열·분석 SQL중첩·반정형 데이터Python·Arrow·Polars·BIdbt·MotherDuck·Ibis 생태계Materialization·Index·통계

성능·운영

성능 프로파일링벤치마크·프로파일링 실습메모리·spill·실패 모드동시성·보안·운영보안 Hardening 체크리스트

부록

템플릿참고 자료검증 리포트업데이트 내역
핸드북›DuckDB 고급 활용›업데이트 내역

업데이트 내역

DuckDB 고급 활용 핸드북 변경 로그

2026-10-26 — 2.0 전수 조사와 실행 예제 개선

  • 전체 25개 MDX를 재검토했습니다. 2.0.0 LTS 기준과 2.0.1 예정 일정을 유지하고, 기능별 읽기 경로를 추가했습니다.
  • 트리거·변경 CTE·중첩 schema·변수·NEAREST JOIN·JSON mutation·EXPLAIN (SQL)을 보강했습니다.
  • Parquet schema map·reader 옵션, PARTITION_PATH·ORDER_BY, Python appender, SECURE VIEW를 보강했습니다.
  • 끊어진 참고 링크 2개를 현행 주소로 교체했습니다.
  • 비동기 I/O 지원 형식·별도 thread pool·read-ahead 메모리와 custom repository 신뢰 정책을 추가했습니다.
  • DuckLake 1.1 catalog migration, Iceberg 옵션, Delta 생성·append·time travel 범위를 구분했습니다.
  • Parquet 물리/SQL 타입 비교 오류, 선택 컬럼 누락 오탐, manifest 서브쿼리 인자, NULL 중복 집계, LIST 길이, seed 없는 sampling을 수정했습니다.
  • 신규 SQL 실습과 실행 검증기를 추가하고, Python API·1.5.6/2.0 파일 교차 읽기를 확인했습니다. 외부 통합은 검증 범위를 별도 표기했습니다.

근거와 결과는 참고 자료, 검증 리포트에 정리했습니다.

2026-10-23 — 2.0 LTS 전환

  • 최신 안정판·1.5 지원 연장·1.4 종료일을 구분하고, 중요 워크로드의 shadow 검증 절차를 추가했습니다.
  • 신규/기존 파일의 저장 포맷 호환성과 rollback 데이터 기준을 교체했습니다.
  • lambda·정규식·0 나누기·NULL·MERGE 변경과 Python 3.11+ 요구를 반영했습니다.
  • embedded 파일 접근과 Quack 서버 경로를 구분하고, agent mode의 출력 계약을 추가했습니다.
  • 실습 engine pin과 04-v2-migration-probes.sql을 갱신했습니다.

2.0 발표 · Migration · 지원 일정.

이전 업데이트 기록

이전 기록 기준

2026-06-13

운영 원칙

  • DuckDB 공식 문서와 release calendar를 우선 추적합니다.
  • current, LTS, preview/nightly를 한 문장에 섞지 않고 기준선을 분리합니다.
  • extension은 core/secondary/community/third-party와 versioning policy를 함께 확인합니다.
  • 성능 조언은 특정 수치보다 파일 구조, query plan, session settings 중심으로 갱신합니다.

관찰할 항목

소스확인할 것주기
DuckDB Release Calendarcurrent patch, LTS patch, EOL, upcoming major월간
DuckDB Blogmajor/minor release, performance, extension 변화릴리스 시
DuckDB DocsParquet, S3, Python, security, performance 문서 변경월간
Core extensions docsIceberg, Delta, DuckLake, httpfs 지원 범위월간
Ecosystem docsdbt-duckdb, MotherDuck, Ibis 지원 범위월간
내부 운영 경험OOM, 파일 레이아웃, BI 연결, notebook 재현성상시

변경 기록

2026-06-13

문서 구조 변경

  • 리뷰 과정에서 오타·마크다운/표기 일관성 정리 (friendly-sql-macros의 "더 덜 깨지고" → "덜 깨지고" 등)

해석 변경

  • 내용 해석 변경 없음

최신화

  • verification의 예제 SQL smoke test 기준을 특정 CLI 버전(v1.2.2)에서 "DuckDB CLI(1.4 LTS 이상)"으로 일반화

영향 챕터

  • friendly-sql-macros
  • verification

근거 링크

  • 내부 리뷰·최신화 라운드 (2026-06-13)

2026-05-15

문서 구조 변경

  • 각 장 제목과 표지 목차 카드에서 Ch1., Ch2. 같은 챕터 번호 접두사를 제거

해석 변경

  • 내용 해석 변경 없음

영향 챕터

  • index.mdx
  • positioning-and-fit부터 security-hardening-checklists까지 본문 장 title frontmatter

근거 링크

  • 내부 편집 규칙 변경

2026-05-14

문서 구조 변경

  • duckdb-advanced 독립 핸드북 초판 생성
  • 시작과 기준선, 파일·레이크 분석, 분석 SQL·연동, 성능·운영, 부록 구조로 목차 구성
  • current 1.5와 1.4 LTS를 동시에 고려하는 버전 기준선 추가
  • Parquet, S3, Iceberg, Delta, DuckLake, Python/Arrow/Polars, memory spill, extension security 장을 포함
  • 실행 가능한 examples/ 번들, 벤치마크 실습, dbt/MotherDuck/Ibis 생태계, 보안 hardening 체크리스트 추가

해석 변경

  • DuckDB를 "작은 OLTP DB"가 아니라 embedded OLAP 분석 엔진으로 정의
  • 파일 레이크를 SQL로 탐색·검증·mart화하는 운영 도구로 포지셔닝
  • 시니어 DBA 독자를 위해 concurrency, WAL/checkpoint, OOM, extension 공급망, untrusted SQL 경계를 명시
  • 고급 활용의 범위를 core SQL에서 멈추지 않고, 팀 운영에 필요한 dbt-duckdb·MotherDuck·Ibis 연동까지 확장

영향 챕터

  • 전체 신규 핸드북
  • hands-on-examples
  • benchmark-profiling-lab
  • ecosystem-dbt-motherduck-ibis
  • security-hardening-checklists

근거 링크

  • https://duckdb.org/2026/03/09/announcing-duckdb-150
  • https://duckdb.org/2025/09/16/announcing-duckdb-140.html
  • https://duckdb.org/release_calendar
  • https://duckdb.org/docs/current/clients/python/overview.html
  • https://duckdb.org/docs/current/data/parquet/overview.html
  • https://duckdb.org/docs/current/guides/performance/how_to_tune_workloads.html
  • https://duckdb.org/docs/current/core_extensions/httpfs/s3api.html
  • https://duckdb.org/docs/current/connect/concurrency.html
  • https://duckdb.org/docs/current/operations_manual/securing_duckdb/overview.html
  • https://github.com/duckdb/dbt-duckdb
  • https://duckdb.org/docs/current/core_extensions/motherduck.html
  • https://duckdb.org/docs/current/guides/python/ibis.html

기록 템플릿

YYYY-MM-DD

문서 구조 변경

  • ...

해석 변경

  • 이전 해석:
  • 새 해석:
  • 변경 이유:

영향 챕터

  • ...

근거 링크

  • ...

참고 자료

  • Release Calendar
  • DuckDB Blog
  • DuckDB Documentation

관련 문서

참고 자료

DuckDB 고급 활용 핸드북의 공식 문서·릴리스 근거 모음

검증 리포트

DuckDB 고급 활용 핸드북의 구조·링크·공식 근거·버전 기준 검증 결과

업데이트 내역

LLMOps·AgentOps 프로덕션 · LLMOps·AgentOps 프로덕션 핸드북 변경 로그

업데이트 내역

하네스 엔지니어링 · 하네스 엔지니어링 핸드북 변경 로그

검증 리포트

Claude Code 고급 활용 · Claude Code 고급 활용 핸드북의 용어·링크·예제 정합성 검증 결과

On this page

2026-10-26 — 2.0 전수 조사와 실행 예제 개선2026-10-23 — 2.0 LTS 전환이전 업데이트 기록운영 원칙관찰할 항목변경 기록2026-06-132026-05-152026-05-14기록 템플릿YYYY-MM-DD참고 자료