BuildWork
AI 인사이트 목록으로

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

  1. Windows용 duckdb_cli-windows-amd64.zip 파일을 다운로드
  2. 압축을 풀고 duckdb.exe가 있는 폴더를 PATH에 추가
  3. 새 터미널에서 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

참고 자료

목록으로 돌아가기