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

시작과 기준선

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

파일·레이크 분석

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

분석 SQL·연동

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

성능·운영

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

부록

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

참고 자료

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

이 핸드북은 DuckDB 공식 문서와 공식 블로그를 1차 근거로 삼았습니다. 제품과 extension 변화가 빠르므로, 본문을 갱신할 때는 이 페이지의 링크와 updates.mdx를 함께 갱신합니다.

릴리스와 버전

주제링크확인한 내용
DuckDB 1.5.0Announcing DuckDB 1.5.01.5 도입 당시 기능의 역사적 근거; 현행 기준은 2.0
DuckDB 1.4 LTSAnnouncing DuckDB 1.4.0 LTS1.4 LTS 지원 기간, encryption, MERGE
Release calendarRelease Calendarupcoming release, LTS policy, EOL
Release cycleRelease Cyclesemver, minor/patch, LTS maintenance

파일·레이크

주제링크
CSVCSV Import
JSONJSON Overview
Multiple filesReading Multiple Files
ParquetReading and Writing Parquet Files
Parquet tipsParquet Tips
Hive partitioningHive Partitioning
Partitioned writesPartitioned Writes
S3/httpfsS3 API Support

성능·운영

주제링크
TuningTuning Workloads
File formatsPerformance: File Formats
IndexingPerformance: Indexing
OOMOut of Memory Errors
LimitsLimits
EXPLAIN ANALYZEEXPLAIN ANALYZE
ConcurrencyConcurrency
SecuritySecuring DuckDB
Securing extensionsSecuring Extensions

SQL·클라이언트

주제링크
Friendly SQLFriendly SQL
MacroCREATE MACRO
ASOF JOINAsOf Join
Python APIPython API
SQL on PandasSQL on Pandas
SQL on ArrowSQL on Apache Arrow
Multiple Python threadsMultiple Python Threads
IbisIntegration with Ibis

생태계

주제링크
dbt-duckdb adapterduckdb/dbt-duckdb
dbt + DuckDB local transformationFully Local Data Transformation with dbt and DuckDB
MotherDuck extensionMotherDuck Extension
MotherDuck dbt integrationdbt Core + MotherDuck Integration
Ibis DuckDB backendIbis DuckDB backend

Lakehouse와 확장

주제링크
Core extensionsCore Extensions
Installing extensionsInstalling Extensions
Extension versioningVersioning of Extensions
IcebergIceberg Extension
DeltaDelta Extension
DuckLakeDuckLake

2026-10-26 전수 점검 근거

주제공식 자료이번 반영
2.0 전체 범위새 문서 목록누락 기능과 관련 장 매핑
트리거CREATE TRIGGERtransition table, 미지원 조합
SQL pipelineWITH변경 CTE와 MATERIALIZED
변수SET VARIABLE$name, manifest 목록 전달
스키마CREATE SCHEMA중첩 schema
유사도 검색FROM/JOINNEAREST와 근사 검색
JSON 수정JSON 함수set/insert/replace/remove
배열 길이List 함수length와 list_count 구분
표본Samplesseed, thread, 입력 고정
비동기 읽기I/O지원 형식, async_threads, read-ahead
실행 계획ProfilingEXPLAIN (SQL)
확장 신뢰Extension Repositories공개키, 3단계 정책
Iceberg옵션URI, metadata, namespace, Quack
DeltaDelta extension생성/append/time travel 범위
DuckLake1.1 발표확장 업데이트와 catalog 이전 분리

current 링크는 앞으로 내용이 바뀔 수 있습니다. 2.0 고유 변경에는 /docs/2.0/ 자료를 우선 연결하고, 재검증 시 엔진 patch와 extension 버전을 함께 확인합니다.

추가로 확인한 파일·클라이언트 기능

  • Parquet reader와 schema map
  • PARTITION_PATH·ORDER_BY
  • SECURE VIEW
  • UPDATE FROM의 다중 source 매칭
  • Python Appender

이 핸드북의 주제 밖인 GeoJSON 입출력, CLI history/schema 출력, sequence·regexp 세부 추가 사항은 2.0 전체 문서 목록에서 확인할 수 있습니다.

참고 자료

  • DuckDB Documentation
  • DuckDB Blog
  • DuckDB Release Calendar

2026-10-23 추가 근거

  • DuckDB 2.0 LTS
  • 2.0 migration
  • Python migration
  • Quack
  • Agent mode

관련 문서

검증 리포트

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

업데이트 내역

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

Node.js 설치

Windows 바이브코딩 초기 세팅 · nodejs.org에서 Node.js LTS를 설치해 Next.js 실행에 필요한 최소 버전과 현재 LTS를 구분하고, node·npm 버전 확인과 함께 npm·npx의 역할까지 이해합니다.

On this page

릴리스와 버전파일·레이크성능·운영SQL·클라이언트생태계Lakehouse와 확장2026-10-26 전수 점검 근거추가로 확인한 파일·클라이언트 기능참고 자료2026-10-23 추가 근거