BuildWork
강의자료 목록으로

duckdb 설치

duckdb 설치

DuckDB GUI 설치 가이드

개요

  • DuckDB GUI는 별도 데스크톱 프로그램을 설치하는 방식이 아니라, DuckDB CLI에 포함된 ui 확장을 통해 로컬 웹 브라우저에서 실행하는 방식
  • DuckDB 1.2.1부터 로컬 UI를 사용할 수 있으며, 현재 공식 문서에서는 duckdb -ui 또는 CALL start_ui();로 실행 가능
  • DuckDB UI는 로컬 DuckDB 프로세스에 연결됨. 기본적으로 쿼리와 데이터는 로컬 컴퓨터에서 처리

    • 1. Windows에서 DuckDB CLI 설치

    방법 A: winget 사용 권장

    PowerShell 또는 명령 프롬프트에서 실행한다.

    powershell
    winget install DuckDB.cli

    설치 후 새 터미널을 열고 버전을 확인한다.

    powershell
    duckdb --version

    방법 B: 공식 ZIP 다운로드

    https://duckdb.org/install/?platform=windows&environment=cli

  • Windows용 duckdb_cli-windows-amd64.zip 파일을 다운로드
  • 압축을 풀고 duckdb.exe가 있는 폴더를 PATH에 추가
  • 새 터미널에서 duckdb --version을 실행해 확인

    • Windows 필수 구성 요소

  • Windows 환경에서는 Microsoft Visual C++ Redistributable이 필요할 수 있음
  • duckdb 실행 시 DLL 관련 오류가 나오면 Visual C++ Redistributable을 먼저 설치 필요

    • 2. DuckDB UI 실행

    DuckDB 셸 안에서 실행

    본문 이미지

    먼저 DuckDB 셸을 연다.

    powershell
    duckdb

    DuckDB 프롬프트에서 다음 SQL을 실행한다.

    sql
    CALL start_ui();

    4. CSV 파일을 바로 열면서 UI 실행

    CSV를 뷰로 등록한 뒤 UI를 실행 가능

    powershell
    duckdb -cmd "CREATE VIEW view_name AS FROM 'filename.csv';" -ui

    UI 안에서는 다음처럼 조회한다.

    sql
    SELECT * FROM view_name;

    5. 설치 및 실행 확인 체크리스트

  • duckdb --version이 정상 출력되는가?
  • duckdb -ui 실행 시 브라우저가 열리는가?
  • 브라우저 주소가 localhost:4213 또는 설정한 포트인가?
  • Windows에서 DLL 오류가 있다면 Visual C++ Redistributable을 설치했는가?

    • 6. 자주 쓰는 실행 명령 모음

    powershell
    # 버전 확인
duckdb --version

# 빈 DuckDB UI 실행
call start_ui();

# DB 파일을 열면서 UI 실행
duckdb my_database.duckdb -ui

# CSV를 view_name 뷰로 등록하면서 UI 실행
duckdb -cmd "CREATE VIEW view_name AS FROM 'filename.csv';" -ui

    참고 자료

  • DuckDB Installation: https://duckdb.org/install/
  • DuckDB UI Extension: https://duckdb.org/docs/current/core_extensions/ui
  • DuckDB Local UI announcement: https://duckdb.org/2025/03/12/duckdb-ui
  • https://zzsza.github.io/data-engineering/2024/10/25/duckdb/
    • 목록으로 돌아가기