SQL로 Excel 파일 쿼리

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

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

통합 문서에서 답까지

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

  1. 통합 문서 열기

    첫 번째 시트는 파일 이름의 테이블이 됩니다. budget.xlsx는 budget이 됩니다. 나머지 시트는 {file}_{sheet} 형식, 예를 들어 budget_actuals라는 이름이 붙습니다. 빈 시트는 건너뜁니다.

  2. 시트에 SQL 작성

    스키마 사이드바에 각 시트의 열과 추론된 타입이 표시되고, 자동 완성도 이를 알고 있습니다. 조인, 윈도 함수, PIVOT 등 DuckDB SQL의 모든 기능을 쓸 수 있습니다.

  3. 결과 보관

    차트로 그리거나, 각 열의 분포를 보거나, 전체 결과를 스프레드시트용 CSV 또는 다른 도구용 Parquet으로 내보내세요.

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

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

SQL 편집기 · SQL로 CSV 쿼리

-- 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할 수 있습니다.

통합 문서 가져오기 자세히 보기

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

보관할 수 있는 사본

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

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

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

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

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

CLI 가이드 읽기 · AI 에이전트를 위한 SQL

Terminal
$ 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 실행하기

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