---
title: Mac, Windows, Linux용 Parquet 뷰어 | DuckLocal
description: "무료 데스크톱 뷰어에서 Parquet 파일을 열어 열, 형식, 행을 확인하고 DuckDB SQL로 쿼리하고 CSV로 내보냅니다. macOS에서는 Quick Look 미리보기를 지원합니다. 업로드가 없습니다."
image: https://ducklocal.app/og-image.jpg
language: ko
---

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

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

## .parquet 파일에서 답까지

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

1. **파일 열기.** 파일을 창에 끌어다 놓거나, 폴더 전체를 열거나, `./data/2026-0*/*.parquet` 같은 패턴을 사용합니다. Mac에서는 Finder에서 파일을 더블클릭합니다. 각 파일은 해당 파일 이름을 딴 뷰가 됩니다.
2. **내용 살펴보기.** 스키마 사이드바에 모든 열과 그 형식이 표시됩니다. 개요 탭은 결과의 각 열을 요약합니다. null, 고유 값 수, 범위, 분포입니다.
3. **쿼리, 차트, 내보내기.** DuckDB SQL로 필터링하고 집계한 뒤 결과를 차트로 전환하고, 전체 결과를 CSV 또는 Parquet로 내보냅니다.

## 파일 자체를 검사하기

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

[데이터 소스](https://ducklocal.app/docs/ko/data-sources) · [결과, 개요, 차트](https://ducklocal.app/docs/ko/results-and-charts)

```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 미리보기 자세히 보기](https://ducklocal.app/docs/ko/data-sources#quick-look)

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

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

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

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

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

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

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

**스크립트나 AI 에이전트에서도 같은 작업이 필요하신가요?** `ducklocal query`는 창을 열지 않고 Parquet 파일에서 SQL 문 하나를 실행해 JSON을 출력합니다. [AI 에이전트용 SQL 보기](https://ducklocal.app/ko/use-cases/ai-agent-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가 내장된 데스크톱 앱입니다. 컴퓨터의 경로에서 파일을 읽고, 계정이 필요 없으며, 텔레메트리를 전송하지 않습니다.

## 링크

- [DuckLocal 다운로드](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [350만 행 예제 보기](https://ducklocal.app/docs/ko/example-nyc-taxi)
- [DuckLocal 설치](https://ducklocal.app/docs/ko/getting-started)
- [로컬 데이터 분석](https://ducklocal.app/ko/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/ko/use-cases/duckdb-gui/)
- [CSV를 SQL로 쿼리](https://ducklocal.app/ko/use-cases/query-csv-with-sql/)

Source: https://ducklocal.app/ko/use-cases/parquet-viewer/
