CSV 파일에서 결과까지
파일은 제자리에 그대로 있습니다. DuckLocal이 그 위치에서 읽습니다.
파일 끌어다 놓기
sales.csv는sales라는 뷰가 됩니다. 탭으로 구분된.tsv파일,.txt파일, gzip으로 압축된.csv.gz파일도 같은 방식으로 동작합니다.SQL 작성하기
스키마 사이드바에 열과 추론된 형식이 표시되고 자동 완성도 이를 인식합니다. 조인, 윈도 함수, CTE,
PIVOT을 포함한 DuckDB SQL 전체를 사용할 수 있습니다.답 남기기
결과를 차트로 만들고, 각 열의 분포를 살펴보고, 전체 결과를 CSV 또는 Parquet로 내보냅니다.
CSV 파일을 테이블처럼 조인
orders.csv와 customers.csv를 함께 열면 각각 별도의 뷰가 됩니다. 한 문장에서 두 파일을 조인하거나, CSV 파일을 Parquet 파일, Excel 시트, DuckDB 데이터베이스의 테이블과 조인할 수 있습니다.
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에서 캐스팅하세요.
SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount FROM read_csv('data/*.csv', union_by_name = true, all_varchar = true);
쿼리를 둘러싼 모든 기능
쿼리 상자는 시작일 뿐입니다. 다음 요소들이 이를 워크스페이스로 만듭니다.
- .csv .tsv .txtDuckDB가 구분자, 헤더, 형식을 감지
- .csv.gzgzip으로 압축된 파일도 데이터로 열기
- 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 에이전트에서 사용할 수 있습니다.
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 내보내기를 선택합니다. 내보내기는 쿼리를 다시 실행해 모든 행을 기록합니다.
관련: 로컬 데이터 분석 · Parquet 뷰어 · DuckDB GUI · SQL로 Excel 쿼리 · SQL로 JSON 쿼리
내 CSV에서 SQL을 실행하세요
DuckLocal을 다운로드하고 샘플 CSV로 튜토리얼을 따라 해 보세요. 파일에서 차트까지 약 10분이면 됩니다.