컬럼형 파일 새로운
쿼리 마루 폴더 SQL을 활용한 Excel, Google Sheets, AI 및 REST 사용
Parquet 파일로 구성된 폴더를 하나의 테이블로 쿼리합니다. Parquet은 자체적인 열 데이터 형식을 가지고 있으므로, 소수점은 소수점으로, 타임스탬프는 타임스탬프로 유지됩니다.
하나의 연결, 모든 표면
Parquet 폴더 데이터가 저장될 수 있는 위치
- 1 발신 연결
- 0 입국항
- 읽기 전용 · 파일은 제자리에 유지됩니다
실행 중
- 귀사 팀, 협력업체 및 파트너 여러분께
-
Excel 추가 기능 · 필요에 따라 새로 고침
-
Google 스프레드시트 추가 기능 · 필요에 따라 새로 고침
-
Nova AI 쉬운 말로 질문해 주세요 · 텍스트를 SQL로 변환
-
데이터 뷰어 실시간 결과 공유 · 팀, 협력업체, 파트너 · 모든 기기에서
- 앱 및 시스템용
-
REST API JSON 엔드포인트 · OpenAPI 3.1
-
파워 BI 파워 쿼리 M
-
예약된 동기화 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- AI 도구의 경우
-
AI 비서 클로드 · 커서 · MCP 서버
- 사람들에게 전달됨
-
알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
Query Streams는 Parquet 파일 폴더를 Microsoft Excel, Google Sheets, MCP를 통한 AI 비서, REST API 및 Power BI에서 읽을 수 있는 하나의 실시간 SQL 테이블로 변환합니다. Parquet은 자체 열 형식을 가지고 있으므로 자체 호스팅 에이전트는 행을 샘플링하는 대신 각 파일의 바닥글에서 스키마를 읽어옵니다. 따라서 소수점은 소수점으로, 타임스탬프는 타임스탬프로 유지되며 샘플링 오류가 발생할 가능성이 없습니다. 파일은 사용자의 컴퓨터에 저장되고, 쿼리 결과만 네트워크를 통해 전송됩니다.
하나의 폴더 엔진에 있는 9개의 파일 세트 드라이버 중 하나 - 인벤토리 테이블, 변경 내역 및 거부 규칙 기능 가족 구성원들이 공유합니다. 마루 폴더 파일 시스템 CSV 폴더 엑셀 폴더 SQLite 폴더 JSONL 폴더 다중 레코드 CSV 기계 로그 웹 서버 로그
- 귀사 팀, 협력업체 및 파트너 여러분께
-
파케트 폴더를 엑셀로 변환 마이크로소프트 엑셀 · 엑셀 추가 기능
Parquet 폴더의 실시간 결과를 워크시트로 바로 가져오고 필요에 따라 새로 고칠 수 있습니다. (데스크톱 Excel, Excel Online, Microsoft 365 지원)
엑셀 작동 방식 -
Parquet 폴더를 Google Sheets로 스프레드시트 추가 기능
사이드바에서 저장된 Parquet 폴더 쿼리를 실행하고 결과를 시트에 드래그 앤 드롭하세요. 공유 공동 작업자는 직접 시트를 새로 고칠 수 있습니다.
Google Sheets 작동 방식 -
노바에게 파케 폴더에 대해 문의하세요 Nova AI · 텍스트를 SQL로 변환
쉬운 영어로 질문하세요. Nova는 이미 Parquet 폴더의 테이블을 알고 있으므로 SQL을 작성하고 실행한 다음 답변을 설명하고 차트로 보여줍니다. 쿼리를 작성할 필요도 없고 자격 증명을 제공할 필요도 없습니다.
Nova는 어떻게 작동하나요? -
Parquet 폴더를 데이터 뷰어로 보기 결과 공유 · 팀, 협력업체, 파트너 · 휴대폰, 태블릿, 데스크톱
Parquet 폴더의 실시간 결과를 동료, 협력업체, 파트너 등 누구와도 북마크 가능한 그리드 형식으로 공유할 수 있습니다. 휴대폰, 태블릿, 데스크톱 등 어떤 기기에서든 열 때마다 결과가 새로고침되어 표시됩니다. 상대방은 결과만 볼 뿐 SQL 쿼리나 파일은 볼 수 없습니다.
데이터 뷰어 작동 방식 - 앱 및 시스템용
-
Parquet 폴더 REST API HTTP 엔드포인트
인증된 JSON 엔드포인트로 Parquet 폴더 쿼리를 게시하여 모든 애플리케이션에서 호출할 수 있도록 합니다. OpenAPI 3.1 사양을 지원하며 Postman, Insomnia, Hoppscotch 컬렉션이 이미 준비되어 있습니다. 데이터베이스 포트는 열지 않습니다.
REST API 작동 방식 -
Parquet 폴더를 Power BI로 파워 쿼리 M
생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서가 HTTPS를 통해 Parquet 폴더의 결과를 실시간으로 읽어옵니다. ODBC 드라이버나 데이터베이스 포트를 열 필요가 없습니다.
Power BI 작동 방식 -
Parquet 폴더를 Airtable로 자동화 플랫폼
Parquet 폴더의 행을 예약된 시간에 Airtable 데이터베이스에 동기화하거나, Airtable 자동화 스크립트 내에서 행을 가져올 수 있습니다.
Airtable 작동 방식 -
파케 폴더를 베이스로우로 자동화 플랫폼
Parquet 폴더에서 Baserow 테이블을 REST 엔드포인트(자체 호스팅 또는 Baserow 클라우드)를 통해 제공합니다.
Baserow의 작동 방식 -
파케트 폴더를 SeaTable로 자동화 플랫폼
파일을 내보내거나 데이터베이스를 노출하지 않고도 Parquet 폴더 데이터를 사용하여 SeaTable 기본 정보를 최신 상태로 유지하세요.
SeaTable 작동 방식 -
Parquet 폴더를 Smartsheet로 자동화 플랫폼
Parquet 폴더의 결과를 Smartsheet 그리드에 삽입하여 계획 및 보고서가 지난주에 내보낸 파일이 아닌 원본 시스템에서 읽어오도록 합니다.
Smartsheet 작동 방식 -
파케트 폴더를 앤빌로 앤빌 웍스 · 앱 플랫폼
Anvil Python 앱을 Parquet 폴더를 사용하여 백업할 때 앱에 데이터베이스 자격 증명을 직접 포함하는 대신 REST 엔드포인트를 사용하는 방법입니다.
Anvil의 작동 방식 - AI 도구의 경우
-
Parquet 폴더 MCP 서버 Claude, Cursor 및 MCP 고객
AI 비서에게 올바른 SQL 쿼리를 작성하는 데 필요한 스키마가 포함된 Parquet 폴더에 대한 읽기 전용 액세스 권한을 부여하세요. 채팅창에 자격 증명을 입력할 필요는 없습니다.
MCP 작동 방식 - 사람들에게 전달됨
-
Parquet 폴더 알림 및 보고서 슬랙 · 디스코드 · 이메일 · 웹훅
Parquet 폴더 쿼리를 예약 실행하고 결과를 Slack, Discord, 이메일 또는 서명된 웹훅으로 전송하거나, 설정한 행 수, 임계값 또는 백분율 변화 기준치를 초과할 때까지 메시지 전송을 보류할 수 있습니다.
알림 및 보고서 작동 방식
작동 방식
5단계, 인바운드 방화벽 변경 없음
네트워크 에이전트를 폴더를 볼 수 있는 위치(예: 내보내기 디렉터리, 소규모 데이터 레이크, 공급업체 드롭)에 설치하십시오.
커넥터를 폴더 또는 전체 트리에 연결하면 모든 .parquet 파일이 일치합니다.
Parquet은 각 파일 내부에 스키마를 저장하므로 에이전트는 행을 샘플링하는 대신 해당 설명을 읽습니다. 텍스트에서 유형을 추론할 필요가 없으며 샘플링 오류가 발생할 가능성도 없습니다.
파일들은 하나의 테이블에 쌓인 형태로 로드되며, 각 행에는 해당 파일 이름을 나타내는 _source_file 열이 있습니다.
데이터베이스와 동일한 SQL 쿼리를 사용하고, 동일한 명령문으로 데이터베이스와 조인하세요.
기능 심층 분석
Parquet Folder가 제공하는 기능
이것이 정확한 이유
- 형식은 파일 자체에서 가져옵니다. 소수, 타임스탬프 및 정수는 현재 상태 그대로 전달됩니다.
- 컬럼 유니언 — 일부 파일에 다른 파일에는 없는 열이 있는 경우, 해당 파일에서는 열을 비워두는 것으로 처리하고 전체 집합을 분리하지 않습니다.
- 두 파일의 열 유형이 실제로 일치하지 않는 경우, 커넥터는 두 열 모두 텍스트로 병합하는 대신 고정하지 않습니다. 어떤 파일의 어떤 열에 문제가 있는지 알려줍니다.
-- 내보내기 파일별 행 수 및 수익 SELECT _source_file, COUNT(*) AS rows, SUM(amount) AS total FROM data GROUP BY _source_file
첫 번째 동기화 후
열을 추가하거나, 고정된 열을 삭제하거나, 데이터 유형을 변경하는 후속 파일은 보류되고 파일 이름으로 files_events에 기록됩니다. 나머지 폴더는 계속 로드되므로 잘못된 내보내기 파일 하나 때문에 테이블이 오프라인 상태가 되는 일은 없습니다. 읽기 작업은 비용이 적게 듭니다. 실제로 변경된 파일만 다시 읽습니다.
파일 세트 제품군 전체에서 공유됩니다.
모든 폴더 커넥터는 또한 다음을 제공합니다.
- 파일_현재 — 실시간 인벤토리: 커넥터가 현재 볼 수 있는 모든 파일의 경로, 크기 및 수정 날짜가 표시됩니다.
- 파일_이벤트 — 감사 추적: 무엇이 나타났고, 무엇이 변경되었고, 무엇이 사라졌으며, 보류된 모든 항목과 파일 이름 및 사유가 기록됩니다.
- 디렉터리 및 볼륨 — 폴더별 총 용량, 일별 증가 내역, 드라이브에 남은 공간 등을 확인할 수 있습니다.
- 동기화할 때마다 실제로 변경된 파일만 다시 읽히므로, 새 내보내기 파일 하나가 추가되었다고 해서 5만 개의 파일이 있는 폴더가 다시 분석되지는 않습니다.
알아두면 좋겠네요.
- 읽기 전용, 강제 적용됨 — 한 번에 하나의 명령문만 실행 가능하며, SELECT 및 관련 명령만 사용할 수 있습니다. 파일은 절대 기록되거나 이동되거나 이름이 변경되지 않습니다.
- 아무것도 업로드되지 않았습니다 — 데이터는 에이전트 옆에 있는 사용자 컴퓨터에 암호화되어 캐시됩니다. 쿼리 결과만 네트워크를 벗어납니다.
- 합리적인 기본 설정 최대 25만 개의 파일, 16개 폴더 깊이, 파일당 512MB 크기까지 저장 가능하며, 모든 설정은 조정 가능합니다. 휴지통, .git 및 node_modules 폴더는 항상 건너뜁니다.
- SQL 방언은 DuckDB입니다. — 다른 커넥터에 대해 작성하는 것과 동일한 SQL 문을 사용합니다.
크로스 소스 SQL
Parquet 폴더를 나머지 데이터에 결합하세요
파일 폴더는 다른 SQL 테이블과 마찬가지로 SQL 테이블 집합이므로 하나의 명령으로 데이터베이스와 API에 동시에 연결할 수 있습니다. 각 소스는 자신이 처리할 수 있는 부분만 실행하고 결과를 스트리밍 방식으로 반환하며, 조인은 중앙에서 이루어집니다. 소스들은 서로 통신하지 않으며 어떤 데이터도 복사되지 않습니다.
3개의 연결 · 3명의 에이전트
한 가지 진술
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택 c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM 파케트 호수.파일셋.데이터1 f
JOIN pg_crm.공개.고객2 c ON c.id = f.customer_id
JOIN 청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 c.지역
주문 기준 청구서 발행 DESC;
세 가지 요소는 연결, 스키마, 테이블이며, 연결 이름은 사용자가 지정한 대로 지정할 수 있습니다. 열은 예시일 뿐이며, 테이블은 실제 테이블이어야 합니다. 모든 부분은 읽기 전용으로 적용됩니다. SELECT, WITH, EXPLAIN만 사용할 수 있으며, 단일 쿼리에 대해 특정 소스에서 제공할 수 있는 데이터의 양에는 제한이 있습니다. 연합 쿼리의 작동 방식
연결 정보
Parquet Folder에 필요한 것
- 접는 사람
- One or more roots — local disk or a network share typed as \\server\share (never a mapped drive letter; on Linux or a Mac, mounted first); every .parquet file is matched, subfolders included
- 스키마
- 각 파일의 Parquet 푸터에서 직접 읽어옵니다. 샘플링이나 추론, 텍스트에서 타입을 계산하는 과정은 일절 없습니다.
- 컬럼 유니언
- 일부 파일에만 있는 열은 다른 파일에서는 빈 값으로 읽히므로 집합을 분리하지 않습니다.
- 타입 충돌
- 두 파일의 열 유형이 실제로 일치하지 않는 경우, 커넥터는 해당 열을 고정하지 않고 두 파일 모두 텍스트로 변환하는 대신 파일 이름과 열 이름을 지정합니다.
- 테이블
- 하나의 테이블에 모든 파일이 쌓여 있고, 각 행에는 해당 파일의 이름을 나타내는 _source_file 열이 있습니다.
- 제한
- 최대 25만 개의 파일, 16단계 폴더 구조, 파일당 512MB 용량 지원 - 모든 설정은 조정 가능합니다.
- 자격 증명
- 없음 — 서버가 없습니다. 에이전트가 파일을 제자리에서 읽습니다.
- SQL 방언
- DuckDB는 표준 SQL을 사용하므로 폴더별 학습 내용이 없습니다.
이 그림에는 데이터베이스 서버가 없습니다. 에이전트는 .parquet 파일을 원래 위치에서 읽어들이고, 동일한 머신의 암호화된 DuckDB 저장소에 행을 캐시한 다음, 실제로 변경된 파일만 다시 읽습니다. 즉, 새 내보내기 파일 하나가 추가되었다고 해서 5만 개의 파일이 있는 폴더를 다시 분석하지는 않습니다. 쿼리 스트림에는 아무것도 업로드되지 않으며, 네트워크를 벗어나는 유일한 데이터는 쿼리 결과뿐입니다.
Parquet은 이 제품군에서 추론이 필요 없는 유일한 형식입니다. 다른 모든 폴더 커넥터는 값을 보고 열의 유형을 파악하지만, Parquet은 이미 유형을 알고 있으므로 에이전트는 데이터가 아닌 설명을 읽습니다. 덕분에 매우 큰 폴더에서도 설정 비용이 저렴합니다. 바닥글만 검사하면 되기 때문입니다. 또한 처음 1,000행까지는 숫자처럼 보이다가 나중에는 숫자가 아닌 것으로 판명되는 문제를 완전히 해결합니다.
공급업체 문서: 파켓.아파치.org
자주 묻는 질문
파케 폴더에 대한 질문
쿼리 스트림을 통해 Parquet 폴더 데이터를 읽을 수 있는 도구는 무엇입니까?
Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, 예약 알림 및 보고서 등 모든 것을 하나의 연결로 이용할 수 있습니다. 폴더를 한 번만 연결하면 모든 플랫폼에서 동일한 읽기 전용 연결을 사용하므로 도구별 설정이나 데이터 복사본 생성이 필요 없습니다.
내 파일이 쿼리 스트림에 업로드되나요?
아니요. 네트워크 에이전트는 파일을 제자리에서 읽어 동일한 시스템의 암호화된 저장소에 행을 캐시합니다. 파일 자체는 네트워크를 벗어나지 않으며, 쿼리 결과 행만 방화벽 포트를 통한 인바운드 연결 없이 단일 아웃바운드 암호화 연결을 통해 전송됩니다.
Query Streams는 내 파일을 변경, 이동 또는 이름 변경할 수 있습니까?
아니요. 파일은 엄격하게 읽기 전용으로 열리며 쓰기, 이동 또는 이름 변경은 절대 이루어지지 않습니다. 쿼리는 실행 시점에 읽기 전용으로만 실행되며, 한 번에 하나의 문장만 실행되고 SELECT 및 그 유사 문만 사용됩니다.
Query Streams가 Parquet 폴더에 연결하려면 무엇이 필요합니까?
A folder path the agent machine can see — no server, no credentials, no drivers to install. Folder: One or more roots — local disk or a network share typed as \\server\share (never a mapped drive letter; on Linux or a Mac, mounted first); every .parquet file is matched, subfolders included. Schema: Read from each file's own Parquet footer — no sampling, no inference, no type worked out from text. Column union: A column only some files carry reads as empty in the others rather than breaking the set. Type conflicts: If two files genuinely disagree on a column's type the connector refuses to pin and names the file and the column, instead of flattening both to text.
하나의 쿼리로 파일이 담긴 폴더를 데이터베이스에 연결할 수 있나요?
네, 맞습니다. 연합 쿼리입니다. 하나의 문장으로 Parquet 폴더와 다른 연결들을 동시에 참조할 수 있으며, 연결 정보는 connection.schema.table 형식으로 작성됩니다. 각 소스는 실행 가능한 부분만 실행하고 결과를 다시 스트리밍합니다. 조인은 중앙에서 이루어지므로 소스들이 서로 직접 연결되지 않고, 데이터 복사나 예약 실행도 없습니다. 읽기 전용은 SELECT, WITH, EXPLAIN 절에만 적용되며, 단일 쿼리에 대해 각 소스가 제공할 수 있는 데이터 양에는 제한이 있습니다. 연합 쿼리는 실행 계획 기능이며, 연합 쿼리 페이지에서 현재 소스와 크기 제한을 확인할 수 있습니다.

