로컬 데이터 플레이그라운드
로컬 CSV, JSON, JSONL, Parquet 파일을 가져와 브라우저에서 DuckDB SQL로 조회합니다.
입력 내용과 파일은 브라우저 밖으로 전송되지 않습니다
로컬 데이터 가져오기
데이터 파일을 여기에 놓으세요
CSV, TSV, JSON, JSONL, NDJSON 또는 Parquet. 여러 파일을 가져와 테이블을 JOIN할 수 있습니다.
생성 예제는 이름을 인용하므로 공백과 비라틴 문자도 지원합니다.
파일은 이 기기에만 남습니다. DuckDB는 자체 호스팅 Web Worker에서 실행되며 SQL은 URL이나 다른 파일을 읽을 수 없습니다.
제한: 입력당 1 GiB, 텍스트 변환 128 MiB, DuckDB 메모리 512 MiB, 미리보기 100,000행, 페이지당 500행, 대체 다운로드 또는 Parquet 512 MiB. JSON/JSONL은 청크가 아니라 평면 레코드 전체를 메모리에서 디코딩합니다. 취소하면 모든 테이블이 해제됩니다.
가져온 테이블
아직 가져온 테이블이 없습니다.
SQL 쿼리
Ctrl 또는 Cmd + Enter로 실행합니다. 로컬 읽기 전용 SELECT 또는 WITH 한 문장만 허용됩니다.
테이블을 가져오고 쿼리를 실행해 결과를 확인하세요.
전체 결과 내보내기
CSV, JSON, JSONL은 선택한 파일에 청크로 기록됩니다. Parquet은 하나의 제한된 버퍼로 생성됩니다. 대체 다운로드는 512 MiB로 제한됩니다.
이 페이지에서
로컬 데이터 플레이그라운드는 브라우저에서 DuckDB-WASM을 실행해 업로드 없이 CSV, JSON, JSONL, Parquet을 조회합니다. 파일마다 SQL 테이블 이름을 지정하고 여러 파일을 JOIN할 수 있습니다.
상세 기능
DuckDB와 Web Worker는 MyDevTools에서 제공되며 첫 가져오기 때만 로드됩니다. SharedArrayBuffer, 교차 출처 격리, 서버, 외부 CDN이 필요 없습니다. 외부 접근, 확장 설치, URL 리더, 데이터베이스 변경 SQL은 비활성화됩니다.
편집기는 SELECT와 WITH, 필터, 그룹, 집계, 정렬, JOIN을 지원합니다. 미리보기는 명시적으로 100,000행으로 제한되고 가상 테이블은 한 번에 최대 500행만 요청합니다. 정수와 소수는 JavaScript Number로 변환하지 않습니다.
CSV, JSON, JSONL은 백프레셔를 적용해 청크로 내보냅니다. Parquet은 단일 버퍼로 생성됩니다. 대체 다운로드와 Parquet은 512 MiB로 제한됩니다.
실용적인 예제
SELECT: orders.csv를 orders로 가져와 SELECT * FROM "orders" LIMIT 100을 실행합니다.
WHERE: 상태로 로컬 필터링합니다.
GROUP BY: 국가별로 그룹화해 금액을 합산합니다.
JOIN: customers.parquet을 추가해 공통 키로 결합합니다.
이 도구 사용 방법
파일 가져오기
형식, 테이블 이름, CSV 옵션을 선택합니다.
로컬 SQL 작성
SELECT, WHERE, GROUP BY, JOIN 예제를 편집하고 Ctrl/Cmd + Enter를 누릅니다.
결과 탐색
가상 테이블은 작은 페이지만 전송하고 렌더링합니다.
내보내기 또는 재시작
CSV, JSON, JSONL, Parquet으로 내보냅니다. 취소나 재시작은 worker와 데이터를 해제합니다.
팁 및 모범 사례
- 테이블과 열 이름을 큰따옴표로 인용하세요.
- 큰 파일에는 LIMIT와 선택적인 WHERE를 사용하세요.
- CSV 형식 추론은 앞자리 0이 있는 식별자를 숫자로 바꿀 수 있습니다. 텍스트 보존은 데이터 형식 변환기를 사용하세요.
- BIGINT와 DECIMAL은 Number를 거쳐 반올림되지 않습니다.
- 취소 후에는 파일을 다시 가져와야 합니다.
- CSV/JSON/JSONL은 스트리밍 가능하며 Parquet은 최대 512 MiB를 버퍼링합니다.