데스크톱을 위한 네이티브 DuckDB GUI

.duckdb 데이터베이스나 CSV, Parquet 파일이 담긴 폴더를 DuckDB 자체를 중심으로 만든 데스크톱 클라이언트에서 여십시오. 스키마를 인식하는 SQL 편집기, 결과 그리드, 차트, 쿼리 프로파일러, 확장 기능 탭이 있습니다. 시작할 서버도, 설치할 드라이버도, 작성할 연결 문자열도 없습니다.

macOS, Windows, Linux용 무료 오픈 소스입니다. 계정도, 텔레메트리도 없습니다.

창에서 얻는 것

먼저 연결할 대상 없이 바로 쓸 수 있는 데이터베이스 클라이언트의 구성 요소입니다.

  1. 데이터베이스를 열거나 파일만 여십시오

    .duckdb 파일은 기본 데이터베이스로 열립니다. CSV, Parquet, JSON, Excel 파일은 그 옆에 뷰와 테이블로 열리며, 메모리에 두거나 연 데이터베이스 안에 둘 수 있습니다.

  2. 카탈로그를 곁에 두고 SQL을 작성하십시오

    스키마 사이드바에서 테이블과 열을 살펴보고, 거기서 SELECT를 생성하고, 자동 완성이 테이블, 열, DuckDB 함수를 제안하게 하십시오. 탭, 서식, .tables, .schema, .databases 닷 명령도 있습니다.

  3. 시간이 어디로 가는지 확인하십시오

    Explain은 문을 실행하지 않고 계획을 보여 줍니다. Profile은 문을 실행하고 각 오퍼레이터의 자체 시간과 예상 대비 실제 행 수를 보여 줍니다.

데이터베이스를 넘나들며 쿼리하기

다른 DuckDB 또는 SQLite 파일을 기본 데이터베이스 옆에 연결하고 서로 조인하십시오. 예를 들어 오늘 데이터 옆에 스냅숏을 두는 식입니다. 연결한 데이터베이스는 따로 지정하지 않으면 읽기 전용이며, 파일 이름에서 별칭을 얻고, 다음 실행에서 다시 나타납니다.

연결된 데이터베이스의 작동 방식 · SQL 편집기

-- snap-2026-10-01.duckdb attached as snap_2026_10_01
SELECT t.id,
       t.amount,
       s.amount AS amount_last_week
FROM orders t
JOIN snap_2026_10_01.orders s USING (id);

DuckDB 엔진을 중심으로 구축했습니다

DuckLocal은 DuckDB가 할 수 있는 일을 일반 데이터베이스 드라이버 뒤에 숨기지 않고 그대로 드러냅니다.

  • Explain문을 실행하지 않고 보는 쿼리 계획
  • Profile오퍼레이터별 시간, 예상 대비 실제 행 수
  • ExtensionsDuckDB 확장 기능 목록, 설치, 로드, 업데이트
  • ATTACHDuckDB와 SQLite 데이터베이스를 나란히
  • s3://httpfs를 통한 S3 및 S3 호환 스토리지
  • Storage format어떤 DuckDB 버전이 데이터베이스 파일을 읽을 수 있는지 확인
  • start_ui()같은 인스턴스에서 DuckDB UI 노트북 실행
  • .dash차트와 교차 필터링이 있는 일반 텍스트 대시보드

다른 DuckDB 클라이언트와 다른 점

duckdb 명령줄 셸은 참조 클라이언트이고, DuckDB UI는 브라우저에서 실행되는 노트북입니다. 범용 데이터베이스 도구는 드라이버와 연결 프로필을 거쳐 DuckDB에 접근합니다.

DuckLocal은 엔진을 안에 품은 단일 데스크톱 프로그램이므로 데이터베이스를 여는 일은 파일을 여는 일과 같습니다. 노트북도 원한다면 CALL start_ui()로 DuckLocal 안에서 DuckDB UI를 실행할 수 있습니다. DuckDB UI vs DuckLocal에서 둘을 자세히 비교합니다.

  • 시작하거나 중지할 서버 프로세스가 없습니다
  • JDBC 드라이버도 연결 프로필도 없습니다
  • 계정도 텔레메트리도 없습니다
  • DuckLocal이 만든 데이터베이스 파일은 DuckDB 1.x에서도 읽을 수 있습니다
  • 데이터베이스 파일이 열리지 않을 때 명확한 설명

스크립트와 AI 에이전트도 같은 엔진을 사용합니다

같은 바이너리가 창 없이도 실행됩니다. ducklocal query는 SQL 문 하나를 실행해 JSON을 출력하고, ducklocal schema는 쿼리할 수 있는 대상을 나열합니다.

DuckDB GUI 관련 질문

공식 DuckDB GUI가 있습니까?
DuckDB는 DuckDB UI를 제공합니다. 이는 브라우저에서 실행되며 CALL start_ui()로 시작하는 노트북입니다. DuckLocal은 DuckDB가 내장된 독립적인 오픈 소스 데스크톱 앱이며 DuckDB 프로젝트가 만든 것이 아닙니다. DuckDB UI는 DuckLocal 안에서도 실행할 수 있습니다.
DuckLocal은 어떤 DuckDB 버전을 사용합니까?
DuckLocal은 DuckDB 2.0을 내장합니다. DuckLocal이 만드는 데이터베이스 파일은 DuckDB 1.x도 읽을 수 있는 형식으로 기록되며, 이미 DuckDB 2.0 형식인 파일은 그 형식을 유지한 채 열립니다.
DuckLocal로 기존 .duckdb 파일을 열 수 있습니까?
예. 기본 데이터베이스로 열거나, 열어 둔 데이터베이스 옆에 연결할 수 있습니다. DuckLocal에 내장된 버전보다 최신 DuckDB가 기록한 파일이면 앱이 그 사실을 알려 주고, 읽을 수 있는 형식으로 복사하는 SQL을 제공합니다.
SQLite 데이터베이스와도 작동합니까?
예. 열기 → 데이터베이스 연결…로 SQLite 파일을 연결하면 DuckDB 테이블, 데이터 파일과 나란히 그 테이블을 쿼리할 수 있습니다.
DuckLocal은 무료입니까?
예. DuckLocal은 Apache-2.0에 따라 무료이며 오픈 소스입니다. Apple 실리콘의 macOS 12 이상, 64비트 Windows 10 이상, Linux x86_64에서 실행됩니다.

첫 데이터베이스를 여십시오

DuckLocal을 내려받아 .duckdb 파일이나 데이터 파일 폴더를 창에 떨어뜨리고 쿼리를 실행하십시오.