통합 문서에서 답까지
파일을 끌어다 놓거나 메뉴에서 여세요. 계속 클릭해야 하는 가져오기 마법사는 없습니다.
통합 문서 열기
첫 번째 시트는 파일 이름의 테이블이 됩니다.
budget.xlsx는budget이 됩니다. 나머지 시트는{file}_{sheet}형식, 예를 들어budget_actuals라는 이름이 붙습니다. 빈 시트는 건너뜁니다.시트에 SQL 작성
스키마 사이드바에 각 시트의 열과 추론된 타입이 표시되고, 자동 완성도 이를 알고 있습니다. 조인, 윈도 함수,
PIVOT등 DuckDB SQL의 모든 기능을 쓸 수 있습니다.결과 보관
차트로 그리거나, 각 열의 분포를 보거나, 전체 결과를 스프레드시트용 CSV 또는 다른 도구용 Parquet으로 내보내세요.
시트, 통합 문서, 파일 조인
시트를 넘나드는 조회에 VLOOKUP 수식을 쓰는 대신 SQL에서는 JOIN 하나면 됩니다. 두 통합 문서 사이에서도, 시트와 다른 시스템에서 내보낸 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를 실행하세요.
$ 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 쿼리 · SQL로 JSON 쿼리 · 로컬 데이터 분석 · DuckDB GUI