---
title: SQL로 CSV 파일 쿼리, 데이터베이스 설정 없이 | DuckLocal
description: "CSV 파일을 데이터베이스로 가져오지 않고 SQL을 실행합니다. DuckLocal은 DuckDB로 CSV를 제자리에서 읽고 조인, 집계, 차트, Parquet 내보내기를 지원합니다. 무료이며 로컬에서 동작합니다."
image: https://ducklocal.app/og-image.jpg
language: ko
---

# SQL로 CSV 파일 쿼리

CSV 파일을 DuckLocal에 끌어다 놓으면 파일 이름을 딴 테이블이 됩니다. DuckDB가 구분자와 헤더, 열 형식을 판별하므로 곧바로 `SELECT`, `JOIN`, `GROUP BY`를 실행할 수 있습니다. 가져오기 단계도, `CREATE TABLE`도 없으며, 스프레드시트로 열기에 너무 큰 파일도 쿼리 하나면 됩니다.

## CSV 파일에서 결과까지

파일은 제자리에 그대로 있습니다. DuckLocal이 그 위치에서 읽습니다.

1. **파일 끌어다 놓기.** `sales.csv`는 `sales`라는 뷰가 됩니다. 탭으로 구분된 `.tsv` 파일, `.txt` 파일, gzip으로 압축된 `.csv.gz` 파일도 같은 방식으로 동작합니다.
2. **SQL 작성하기.** 스키마 사이드바에 열과 추론된 형식이 표시되고 자동 완성도 이를 인식합니다. 조인, 윈도 함수, CTE, `PIVOT`을 포함한 DuckDB SQL 전체를 사용할 수 있습니다.
3. **답 남기기.** 결과를 차트로 만들고, 각 열의 분포를 살펴보고, 전체 결과를 CSV 또는 Parquet로 내보냅니다.

## CSV 파일을 테이블처럼 조인

`orders.csv`와 `customers.csv`를 함께 열면 각각 별도의 뷰가 됩니다. 한 문장에서 두 파일을 조인하거나, CSV 파일을 Parquet 파일, Excel 시트, DuckDB 데이터베이스의 테이블과 조인할 수 있습니다.

[SQL 편집기](https://ducklocal.app/docs/ko/sql-editor) · [결과와 차트](https://ducklocal.app/docs/ko/results-and-charts)

```sql
SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;
```

## 많은 파일, 지저분한 파일

`read_csv`로 CSV 파일 폴더 전체를 하나의 테이블로 읽습니다. `union_by_name`은 열 구성이 다른 파일도 허용합니다. 어긋난 텍스트 값 하나가 형식 감지를 방해하면 모든 값을 텍스트로 읽고 SQL에서 캐스팅하세요.

[한 번에 많은 CSV 파일 읽기](https://ducklocal.app/docs/ko/data-sources#many-csv-files-at-once)

```sql
SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);
```

## 쿼리를 둘러싼 모든 기능

쿼리 상자는 시작일 뿐입니다. 다음 요소들이 이를 워크스페이스로 만듭니다.

- `.csv .tsv .txt`: DuckDB가 구분자, 헤더, 형식을 감지
- `.csv.gz`: gzip으로 압축된 파일도 데이터로 열기
- `data/*.csv`: 패턴과 일치하는 모든 파일 열기
- `folder/`: 디렉터리의 모든 데이터 파일 열기
- `개요`: 열별 null, 고유 값, 범위, 분포
- `차트`: 결과에서 막대, 선, 산점도, 원형, 지도 차트 만들기
- `Parquet 내보내기`: CSV 데이터를 Parquet로 변환
- `ducklocal query`: 터미널에서 같은 SQL을 JSON 출력으로 실행

## CSV는 컴퓨터를 떠나지 않습니다

온라인 CSV 도구는 업로드가 필요합니다. DuckLocal은 DuckDB가 내장된 데스크톱 앱입니다. 경로에서 파일을 읽고, 복사하거나 변경하지 않으며, 계정도 필요하지 않습니다.

집계는 파일의 모든 행에 대해 실행됩니다. 그리드는 결과의 최대 100,000개 행을 표시하고, 내보내기는 전체 결과를 기록합니다.

- 업로드 없음, DuckLocal 클라우드 서비스 없음
- 설치할 데이터베이스 서버 없음
- 계정 없음, 텔레메트리 없음
- 원본 파일은 수정되지 않습니다
- Apache-2.0 오픈 소스

## 명령줄에서 CSV 쿼리

같은 바이너리가 창 없이도 실행됩니다. `ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"`는 결과를 JSON으로 출력하므로 스크립트와 AI 에이전트에서 사용할 수 있습니다.

**AI 에이전트와 함께 작업하시나요?** 출력이 제한된 JSON을 내는 헤드리스 CLI를 쓰면 에이전트가 먼저 스키마를 확인하고 그다음에 쿼리할 수 있습니다. [AI 에이전트용 SQL 보기](https://ducklocal.app/ko/use-cases/ai-agent-sql/)

## CSV와 SQL 관련 질문

**CSV 파일을 먼저 데이터베이스로 가져와야 하나요?**

아니요. DuckLocal은 파일 위에 뷰를 만들고 DuckDB가 파일을 제자리에서 읽습니다. 파일은 복사되거나 변환되거나 변경되지 않으며, 뷰를 삭제해도 원본 파일은 그대로 남습니다.

**한 쿼리에서 여러 CSV 파일을 조인할 수 있나요?**

네. 여는 모든 파일이 각각의 뷰가 되므로 두 CSV 파일 사이의 `JOIN`은 평범한 SQL입니다. CSV를 Parquet, JSON, Excel 시트, DuckDB 테이블과 조인할 수도 있습니다.

**DuckLocal은 어떤 SQL 방언을 사용하나요?**

DuckDB SQL이며 PostgreSQL에 가깝습니다. 여기에 윈도 함수, `PIVOT`, `read_csv`로 파일을 직접 읽는 기능 같은 분석 기능이 더해집니다.

**열 형식이 잘못 감지되면 어떻게 하나요?**

DuckDB는 파일의 샘플에서 형식을 추론합니다. 열을 다르게 처리해야 한다면 `read_csv(..., all_varchar = true)`로 읽고 쿼리에서 `try_cast`로 변환하세요.

**CSV 파일을 Parquet로 변환할 수 있나요?**

네. 뷰에 `SELECT * FROM`을 실행하고 Parquet 내보내기를 선택합니다. 내보내기는 쿼리를 다시 실행해 모든 행을 기록합니다.

## 링크

- [DuckLocal 다운로드](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [10분 튜토리얼 따라 하기](https://ducklocal.app/docs/ko/tutorial)
- [튜토리얼 열기](https://ducklocal.app/docs/ko/tutorial)
- [로컬 데이터 분석](https://ducklocal.app/ko/use-cases/local-data-analysis/)
- [Parquet 뷰어](https://ducklocal.app/ko/use-cases/parquet-viewer/)
- [DuckDB GUI](https://ducklocal.app/ko/use-cases/duckdb-gui/)

Source: https://ducklocal.app/ko/use-cases/query-csv-with-sql/
