---
title: "SQL로 Excel 파일 쿼리, 시트마다 하나의 테이블 | DuckLocal"
description: "Excel도 데이터베이스도 없이 Excel 통합 문서에 DuckDB SQL을 실행하세요. .xlsx, .xls, .xlsb, .ods 파일의 시트가 각각 테이블이 되어 CSV, Parquet과 조인할 수 있습니다. 무료이며 모두 로컬에서."
image: https://ducklocal.app/og-image.jpg?v=2
language: ko
---

# SQL로 Excel 파일 쿼리

DuckLocal에서 통합 문서를 열면 시트가 각각 테이블이 됩니다. 시트끼리, CSV와 Parquet 파일과, 또는 DuckDB 데이터베이스와 조인해서 피벗 테이블로는 얻을 수 없는 답을 얻으세요. Excel 설치도, 데이터베이스 서버도 필요 없고, 아무것도 업로드되지 않습니다.

macOS, Windows, Linux용 무료 오픈 소스. 통합 문서는 읽기만 하고 절대 변경하지 않습니다.

- .xlsx .xls .xlsb .ods
- 시트마다 하나의 테이블
- 열 타입 자동 추론
- CSV, Parquet과 조인

## 통합 문서에서 답까지

파일을 끌어다 놓거나 메뉴에서 여세요. 계속 클릭해야 하는 가져오기 마법사는 없습니다.

1. **통합 문서 열기.** 첫 번째 시트는 파일 이름의 테이블이 됩니다. `budget.xlsx`는 `budget`이 됩니다. 나머지 시트는 `{file}_{sheet}` 형식, 예를 들어 `budget_actuals`라는 이름이 붙습니다. 빈 시트는 건너뜁니다.
2. **시트에 SQL 작성.** 스키마 사이드바에 각 시트의 열과 추론된 타입이 표시되고, 자동 완성도 이를 알고 있습니다. 조인, 윈도 함수, `PIVOT` 등 DuckDB SQL의 모든 기능을 쓸 수 있습니다.
3. **결과 보관.** 차트로 그리거나, 각 열의 분포를 보거나, 전체 결과를 스프레드시트용 CSV 또는 다른 도구용 Parquet으로 내보내세요.

## 시트, 통합 문서, 파일 조인

시트를 넘나드는 조회에 `VLOOKUP` 수식을 쓰는 대신 SQL에서는 `JOIN` 하나면 됩니다. 두 통합 문서 사이에서도, 시트와 다른 시스템에서 내보낸 CSV 사이에서도 마찬가지입니다.

[SQL 편집기](https://ducklocal.app/docs/ko/sql-editor) · [SQL로 CSV 쿼리](https://ducklocal.app/ko/use-cases/query-csv-with-sql/)

```sql
-- budget.xlsx: first sheet → budget,
-- sheet "actuals" → budget_actuals
SELECT b.department,
       b.planned,
       sum(a.amount)             AS spent,
       b.planned - sum(a.amount) AS remaining
FROM budget b
JOIN budget_actuals a USING (department)
GROUP BY b.department, b.planned
ORDER BY remaining;
```

## 시트가 테이블이 되는 방식

첫 번째 행이 헤더입니다. 각 열에는 그 열의 모든 셀을 담을 수 있는 가장 좁은 타입이 지정됩니다. 정수는 `BIGINT`, 정수와 소수가 섞이면 `DOUBLE`, 날짜는 `TIMESTAMP`, 참/거짓 값은 `BOOLEAN`입니다. 그 밖에 섞인 값은 `VARCHAR`로 남으므로 잃는 것이 없고, SQL에서 `TRY_CAST`할 수 있습니다.

[통합 문서 가져오기 자세히 보기](https://ducklocal.app/docs/ko/data-sources#supported-file-formats)

- 빈 셀은 `NULL`이 됩니다
- 빈 헤더 셀은 `column_1`, `column_2`…가 됩니다
- 중복된 헤더에는 접미사가 붙습니다: `amount`, `amount_2`
- 수식은 계산된 값으로 가져옵니다
- 통합 문서 파일에는 절대 쓰지 않습니다

## 보관할 수 있는 사본

제자리에서 읽는 CSV, Parquet과 달리 시트는 통합 문서를 열 때 테이블로 복사됩니다. Excel에서 파일을 바꿨다면 다시 열면 테이블이 교체됩니다.

테이블을 보관하려면 먼저 `.duckdb` 데이터베이스를 연 다음 통합 문서를 여세요. 시트가 그 데이터베이스에 저장되어 다음에 열 때도 그대로 있고, 어떤 DuckDB 클라이언트로도 읽을 수 있습니다.

> **워크시트에 다 들어가지 않는 행 수?** 워크시트는 최대 1,048,576행입니다. 그보다 크면 CSV나 Parquet으로 내보내고 파일을 직접 쿼리하세요. [Parquet 뷰어 보기 →](https://ducklocal.app/ko/use-cases/parquet-viewer/)

## 명령줄에서 통합 문서 다루기

`ducklocal schema`는 통합 문서와 그 시트 목록을 보여 주고, `--stats`는 첫 번째 시트를 분석합니다. 열마다 NULL, 고유값, 범위, 중앙값을 알려 줍니다. AI 에이전트는 SQL을 쓰기 전에 스프레드시트에 무엇이 있는지 파악할 수 있습니다.

스크립트나 에이전트에서 시트를 쿼리하려면 위에서 설명한 대로 앱에서 데이터베이스에 저장한 뒤, 그 파일에 대해 `ducklocal query --database`를 실행하세요.

[CLI 가이드 읽기](https://ducklocal.app/docs/ko/cli) · [AI 에이전트를 위한 SQL](https://ducklocal.app/ko/use-cases/ai-agent-sql/)

```bash
ducklocal schema budget.xlsx
ducklocal schema budget.xlsx --stats
ducklocal query --database budget.duckdb \
  --sql "SELECT department, sum(amount)
         FROM budget_actuals
         GROUP BY department"
```

## Excel과 SQL에 관한 질문

**DuckLocal은 어떤 스프레드시트 형식을 쿼리할 수 있나요?** Excel `.xlsx`, `.xls`, `.xlsb` 통합 문서와 OpenDocument `.ods` 스프레드시트입니다. 비어 있지 않은 시트는 각각 별도의 테이블로 가져옵니다.

**DuckLocal이 내 통합 문서를 변경하나요?** 아니요. 파일을 읽고 각 시트를 테이블로 복사할 뿐, 통합 문서 자체에는 절대 쓰지 않습니다. 나중에 Excel에서 편집했다면 다시 열어 변경 사항을 가져오세요.

**수식도 가져오나요?** 값을 가져옵니다. DuckLocal은 스프레드시트 앱이 파일에 저장한 계산 결과를 읽고, 그 뒤의 수식은 읽지 않습니다. 합계 열은 숫자로 들어옵니다.

**결과를 다시 스프레드시트로 내보낼 수 있나요?** 어떤 결과든 CSV(Excel을 비롯한 모든 스프레드시트 앱에서 열림)나 다른 데이터 도구용 Parquet으로 내보낼 수 있습니다. DuckLocal은 .xlsx 파일을 쓰지 않습니다.

**DuckLocal이 Excel을 대신할 수 있나요?** 분석이라면 그렇습니다. 시트와 파일을 넘나드는 조인, 집계, 그리고 워크시트의 1,048,576행 한도를 넘는 데이터를 다룰 수 있습니다. 다만 스프레드시트 편집기는 아니어서 셀에 입력하거나 수식을 쓰지는 않습니다.

관련 항목: [SQL로 CSV 쿼리](https://ducklocal.app/ko/use-cases/query-csv-with-sql/) · [SQL로 JSON 쿼리](https://ducklocal.app/ko/use-cases/query-json-with-sql/) · [로컬 데이터 분석](https://ducklocal.app/ko/use-cases/local-data-analysis/) · [DuckDB GUI](https://ducklocal.app/ko/use-cases/duckdb-gui/)

## 내 통합 문서에 SQL 실행하기

DuckLocal을 다운로드하고, 스프레드시트를 놓은 다음, 쿼리 하나로 시트를 조인하세요.

## 링크

- [DuckLocal 다운로드](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [통합 문서를 읽는 방식 보기](https://ducklocal.app/docs/ko/data-sources#supported-file-formats)
- [설치하고 첫 쿼리 실행하기](https://ducklocal.app/docs/ko/getting-started)

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