QLook Parquet

Parquet 파일을 선택하고 스페이스바를 누르면 내용을 바로 확인할 수 있습니다.

QLook Parquet은 Finder의 훑어보기(Quick Look)에 Apache Parquet 미리보기를 더합니다. 노트북을 열거나 쿼리를 작성하거나 앱을 실행하지 않아도 스키마·행·메타데이터가 한 화면에 나타납니다.

스페이스바 한 번, 두 가지 보기

• 표 — 왼쪽에 스키마, 오른쪽에 행. 보고 싶은 필드를 체크하면 그대로 표의 열이 됩니다.
• JSON — 파일 푸터를 읽기 쉬운 JSON 문서 하나로, 행은 JSON Lines(행마다 객체 하나)로 나란히 보여 줍니다.

실제 데이터 파일을 위해

• 필요한 만큼 미리보기 — 파일 전체를 메모리에 올리지 않고, 제한된 행 창으로 대용량 파일을 탐색합니다.
• 모든 타입 — 정수, 소수, 날짜, 타임스탬프(UTC 지정 여부 반영), 바이너리, INT96 등을 파일이 정의한 그대로 표시합니다.
• 중첩 데이터 — list·map·struct는 간결한 배지로 표시되며, 클릭하면 그 자리에서 모든 항목을 펼쳐 봅니다. 다른 셀을 더블클릭하면 값을 자세히 볼 수 있습니다.
• 행 그룹 — 도구 막대에서 행 그룹 사이를 이동합니다.
• 주요 압축 코덱 — Snappy, GZIP, ZSTD, LZ4, Brotli. .parquet과 .parq 모두 지원합니다.

보이는 그대로 활용

• 열 고르기 — 필드 체크·해제, 드래그로 순서 바꾸기, 너비 조절·자동 맞춤, 필요 없는 열 숨기기.
• 원하는 형식으로 복사 — 선택한 셀을 탭 구분 텍스트(열 이름 포함 가능), JSON, SQL 리터럴로 복사합니다. JSON 보기에서는 행 전체를 JSON으로 복사합니다. 열 머리글을 클릭하면 열 전체가 선택됩니다. 표에서 오래 걸리는 복사는 진행률을 보여 주며, 복사 버튼을 다시 클릭하면 취소됩니다.
• 푸터 살펴보기 — 작성 도구, 압축, 형식 버전, 행 그룹, 열 통계, 키-값 메타데이터를 JSON으로 보고 복사합니다.
• 원하는 표시 방식 — 누락된 값을 NULL·대시·공백으로, 타임스탬프를 저장된 그대로·UTC·현지 시간으로, 행 번호 표시 여부까지 설정합니다.
• 분명한 안내 — 손상된 열의 오류는 해당 열 안에서만 표시됩니다. 암호화 등으로 파일을 읽을 수 없으면 이유를 알려 줍니다.
• 라이트·다크 — 시스템 화면 모드를 그대로 따릅니다.

개인정보를 처음부터 고려한 설계

모든 처리는 Mac 안에서만 이루어집니다. QLook Parquet에는 네트워크 접근 권한이 전혀 없으며, 샌드박스가 이를 강제합니다. 파일은 읽기 전용으로 열려 절대 수정되지 않고, 파일과 같은 위치에 추가 파일을 만들지 않습니다. 계정도, 분석 도구도, 추적도 없습니다.

네이티브로 빠르게

Apache Arrow의 Rust Parquet 리더를 앱에 내장하고 Swift로 작성했습니다. Universal 앱으로 Apple Silicon과 Intel Mac 모두에서 네이티브로 동작합니다. macOS 14 이상이 필요합니다.

시작하기: QLook Parquet을 한 번 실행하고 필요한 경우 Quick Look 확장을 켜세요. Finder에서 .parquet 또는 .parq 파일을 선택한 뒤 스페이스바를 누르면 됩니다. 샘플 파일이 포함되어 있습니다. 암호화된 Parquet 파일은 지원하지 않습니다.