---
title: DuckDB SQL로 하는 로컬 데이터 분석 | DuckLocal
description: CSV, Parquet, JSON, Excel 파일을 있는 자리에서 DuckDB SQL로 분석합니다. 서버도, 업로드도, 계정도 없습니다.
image: https://ducklocal.app/og-image.jpg?v=2
language: ko
---

# DuckDB SQL로 로컬 데이터 파일을 분석하십시오

**내 파일. DuckDB SQL. 중간 파이프라인 없음.**

DuckLocal은 CSV, Parquet, JSON, Excel, DuckDB 파일을 데스크톱 작업 공간에서 바로 엽니다. 데이터를 업로드하거나 서버를 설정하지 않고 스키마를 살펴보고, SQL을 쓰고, 결과를 차트로 만들고, 내보낼 수 있습니다.

## 로컬 파일에서 쓸모 있는 결과까지

1. **파일, 폴더, 패턴을 여십시오.** 파일 하나를 끌어다 놓거나, 디렉터리를 재귀적으로 열거나, `./data/2026-0*/*.parquet` 같은 패턴을 사용하십시오.
2. **쿼리 전에 확인하십시오.** 릴레이션, 열, 추론된 타입을 확인합니다. CSV, Parquet, JSON 파일은 뷰가 되고, 스프레드시트 시트는 테이블이 됩니다.
3. **쿼리하고, 차트로 만들고, 내보내십시오.** DuckDB SQL을 실행하고, 결과를 차트로 전환하고, 열을 확인하고, 전체 결과를 CSV 또는 Parquet로 내보냅니다.

```sql
SELECT channel,
       round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

DuckDB는 원본을 로컬에서 스캔합니다. 집계는 모든 행을 브라우저나 클라우드 서비스에 적재하지 않고도 수백만 입력 행을 작은 답으로 줄일 수 있습니다.

## 지원하는 데이터 소스

- 타입을 추론하는 CSV와 TSV
- 컬럼 스캔과 메타데이터를 지원하는 Parquet
- JSON과 JSON Lines
- Excel 및 OpenDocument 통합 문서
- DuckDB 데이터베이스, 그리고 연결한 DuckDB 또는 SQLite 데이터베이스
- 재귀 폴더와 글롭 패턴
- 직접 설정한 경우에만 S3

## 프라이빗한 오프라인 데이터 분석

로컬 파일은 기존 경로에서 읽으며 DuckLocal 클라우드 서비스로 복사하지 않습니다.

- 계정도, 작업 공간 프로비저닝도 없습니다
- 텔레메트리가 없습니다
- 필수 가져오기나 파일 변환이 없습니다
- 원본 파일은 그대로입니다
- Apache-2.0 오픈 소스

오프라인에서 동작합니다. DuckLocal은 직접 켜기 전까지 스스로 네트워크 요청을 보내지 않습니다. S3 쿼리, 지도 타일, 업데이트 확인은 선택했을 때만 쓰이므로, 민감한 파일을 네트워크에 전혀 연결되지 않은 컴퓨터에서 분석할 수 있습니다.

## 완성된 데스크톱 워크플로

스키마 사이드바, SQL 편집기, 결과 그리드, 차트, 기록, 프로파일러가 한 창에 모여 있습니다. 등록한 파일과 연결한 데이터베이스는 다음 실행에서 다시 나타날 수 있습니다.

AI 에이전트는 헤드리스 CLI를 통해 같은 로컬 데이터를 사용할 수 있습니다. [AI 에이전트용 SQL](https://ducklocal.app/ko/use-cases/ai-agent-sql/)을 보십시오.

## 링크

- [DuckLocal 다운로드](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [10분 튜토리얼](https://ducklocal.app/docs/ko/tutorial)
- [데이터 소스 레퍼런스](https://ducklocal.app/docs/ko/data-sources)
- [결과와 차트](https://ducklocal.app/docs/ko/results-and-charts)
- [DuckDB GUI](https://ducklocal.app/ko/use-cases/duckdb-gui/)
- [Parquet 뷰어](https://ducklocal.app/ko/use-cases/parquet-viewer/)
- [SQL로 CSV 쿼리](https://ducklocal.app/ko/use-cases/query-csv-with-sql/)

Source: https://ducklocal.app/ko/use-cases/local-data-analysis/
