데스크톱에서 Parquet 파일을 열고 쿼리합니다

Parquet는 바이너리 열 형식이므로 텍스트 편집기나 스프레드시트에서는 내용을 볼 수 없습니다. DuckLocal은 .parquet 파일을 테이블로 열어 탐색하고, 필터링하고, SQL로 쿼리하고, 내보낼 수 있습니다. 모든 작업은 사용자의 컴퓨터에서 실행되며 파일은 온라인 뷰어로 업로드되지 않습니다.

macOS, Windows, Linux용 무료 오픈 소스. 계정 없음. 텔레메트리 없음.

.parquet 파일에서 답까지

파일 내부를 확인하는 데 Python 환경도, 노트북도, 클러스터도 필요하지 않습니다.

  1. 파일 열기

    파일을 창에 끌어다 놓거나, 폴더 전체를 열거나, ./data/2026-0*/*.parquet 같은 패턴을 사용합니다. Mac에서는 Finder에서 파일을 더블클릭합니다. 각 파일은 해당 파일 이름을 딴 뷰가 됩니다.

  2. 내용 살펴보기

    스키마 사이드바에 모든 열과 그 형식이 표시됩니다. 개요 탭은 결과의 각 열을 요약합니다. null, 고유 값 수, 범위, 분포입니다.

  3. 쿼리, 차트, 내보내기

    DuckDB SQL로 필터링하고 집계한 뒤 결과를 차트로 전환하고, 전체 결과를 CSV 또는 Parquet로 내보냅니다.

파일 자체를 검사하기

Parquet 파일은 스키마, 행 그룹, 압축, 열 통계를 자체 푸터에 담고 있습니다. DuckDB는 이를 일반 SQL로 읽으므로, 한 행도 스캔하기 전에 파일이 어떻게 작성되었는지 확인할 수 있습니다.

데이터 소스 · 결과, 개요, 차트

-- columns and types
DESCRIBE SELECT * FROM 'trips.parquet';

-- row groups, compression and statistics
SELECT * FROM parquet_metadata('trips.parquet');

아무것도 열지 않고 미리 보기

macOS에서는 Finder에서 Parquet 파일을 선택하고 스페이스 바를 누릅니다. Quick Look 미리보기는 열과 그 형식, 처음 50개 행을 보여 주고, 푸터에서 행 수, 행 그룹, 압축, 작성 도구를 보여 줍니다.

미리보기는 DuckLocal.app에 포함되어 있습니다. 파일 전체를 스캔하지 않고 아무것도 다운로드하지 않습니다. Quick Look 미리보기 자세히 보기

  • 파일은 있는 위치에서 읽히고 업로드되지 않습니다
  • 쿼리는 필요한 열만 읽습니다
  • 원본 파일은 변경되지 않습니다
  • 계정 없음, 텔레메트리 없음
  • Apache-2.0 오픈 소스

하나의 파일, 또는 수천 개의 파일

Parquet 데이터는 단일 파일로 오는 경우가 드뭅니다. 저장된 형태 그대로 여세요.

  • *.parquet패턴과 일치하는 모든 파일 열기
  • folder/디렉터리를 재귀적으로 탐색
  • read_parquet()여러 파일을 하나의 테이블로 SQL에서 읽기
  • https://HTTPS로 원격 Parquet 파일 쿼리
  • s3://설정하면 버킷과 S3 호환 스토리지도 사용
  • CSV 내보내기쿼리 결과를 CSV로 변환
  • Parquet 내보내기CSV, JSON, Excel 데이터를 Parquet로 쓰기
  • JOINParquet를 CSV, JSON, Excel, DuckDB 테이블과 결합

스프레드시트로 열 수 없는 파일을 위해

결과 그리드는 결과의 최대 100,000개 행을 표시하고, 표시를 멈춘 지점에서 그 사실을 알려 줍니다. 집계, 필터, 조인은 여전히 파일 전체에 대해 실행되며, 내보내기는 쿼리를 다시 실행해 모든 행을 기록합니다.

그래서 일반적인 흐름은 수백만 행을 스크롤하는 대신 SQL로 필요한 답까지 줄이는 것입니다.

Parquet 뷰어 관련 질문

Mac에서 Parquet 파일을 어떻게 여나요?
DuckLocal을 설치하고 Finder에서 .parquet 파일을 더블클릭하거나 DuckLocal 창에 끌어다 놓습니다. 열지 않고 내용을 확인하려면 파일을 선택하고 스페이스 바를 누르면 Quick Look 미리보기가 열립니다. DuckLocal은 Apple silicon에서 macOS 12 이상이 필요합니다.
Windows나 Linux에서 Parquet 파일을 어떻게 여나요?
DuckLocal을 실행하고 파일을 창에 끌어다 놓거나 열기 메뉴에서 선택합니다. 터미널에서는 ducklocal ./file.parquet로 바로 열 수 있습니다.
Parquet를 CSV로 변환할 수 있나요?
네. 파일을 쿼리하고 CSV 내보내기를 선택하면 내보내기가 쿼리를 다시 실행해 결과 전체를 기록합니다. 반대 방향도 됩니다. CSV 파일을 열어 Parquet로 내보낼 수 있습니다.
DuckLocal은 얼마나 큰 Parquet 파일을 열 수 있나요?
DuckDB는 Parquet를 열 단위로 읽고 쿼리에 필요한 부분만 읽으므로 수백만 행이 넘는 파일도 노트북에서 실용적으로 다룰 수 있습니다. 그리드는 결과의 최대 100,000개 행을 표시하고, 집계는 파일 전체에 대해 실행됩니다.
Parquet 파일이 어딘가로 업로드되나요?
아니요. DuckLocal은 DuckDB가 내장된 데스크톱 앱입니다. 컴퓨터의 경로에서 파일을 읽고, 계정이 필요 없으며, 텔레메트리를 전송하지 않습니다.

첫 Parquet 파일을 열어 보세요

DuckLocal을 다운로드하고 .parquet 파일을 창에 끌어다 놓으세요. SQL을 작성하기 전에 열이 나타납니다.