어떤 폴더든 다음으로 변환하세요 SQL 테이블 최신 상태를 유지하는
13개의 폴더 커넥터, 하나의 아이디어: Query Streams Agent를 네트워크상의 폴더에 연결하면 에이전트가 테이블을 생성하고, 각 행에 해당 행이 어디에서 왔는지 태그를 지정하며, 파일이 추가되거나 변경되거나 삭제될 때마다 테이블을 최신 상태로 유지합니다. Excel, Google Sheets, Nova, Claude 또는 REST API를 통해 해당 테이블을 쿼리할 수 있습니다. 업로드, 변환 또는 편집 과정은 전혀 필요하지 않습니다.
파일에 맞는 가이드를 선택하세요
아래 각 카드는 하나의 커넥터와 하나의 가이드입니다. 모든 가이드는 에이전트 설치, 폴더 지정, 빌드될 항목 확인, 스캔 빈도 선택, 테이블 분석 등 동일한 5단계를 거친 후, 해당 파일 형식에 특화된 테이블, 쿼리 및 주의 사항을 보여줍니다. 어떤 것이 적합한지 잘 모르시겠나요? 포털에서 선택하세요. 폴더 안의 파일들에이전트가 폴더를 샘플링하여 해당 카드를 열어줍니다.
모든 폴더 커넥터의 작동 방식
데이터베이스 커넥터는 이미 테이블이 있는 서버를 가리킵니다. 폴더 커넥터는 에이전트 컴퓨터의 폴더를 가리킵니다. 에이전트는 파일을 읽고 최대 64개의 샘플에서 레이아웃을 고정한 다음 암호화된 로컬 캐시(DuckDB 스키마 하나, 이름은 )에 테이블을 구축합니다. 파일셋) 사용자가 선택한 일정에 따라 파일을 새로 고칩니다. 레이아웃에 맞지 않는 파일은 따로 분류되어 보고되며, 자동으로 삭제되거나 형식이 변경되지 않습니다. 하나의 커넥터는 하나의 파일 형식만 읽습니다. CSV 파일과 Parquet 파일이 있는 폴더는 동일한 폴더에 두 개의 커넥터가 필요합니다.
모든 폴더 커넥터는 동일한 회계 테이블을 제공하며, 모든 기능은 여기에 있습니다. 파일셋 개요:
| 테이블 | 그것이 담고 있는 것 |
|---|---|
파일 | 폴더에 현재 있는 모든 파일의 경로, 이름, 확장자, 크기, 생성 및 수정 시간, 최초 및 마지막 확인 시간 정보를 한눈에 볼 수 있습니다. 파일_현재또한 사라진 파일도 보관합니다. |
파일_이벤트 | 변경 내역: 파일당 한 행씩 나타났다, 였다 수정됨, 사라졌다, 따로 떼어 놓았습니다.경향) 또는 ~였다 거부됨시간과 함께 이벤트_at어떻게 그것이 발견되었는지 감지됨_ 그리고 그 이유는 다음과 같습니다. 세부 사항. |
디렉토리, 디렉토리 스냅샷, 볼륨 | 폴더 개수 및 크기, 증가 추세, 그리고 루트 폴더가 위치한 디스크 또는 공유 폴더 정보입니다. |
_소스_파일, _row_id | 각 데이터 행에는 두 개의 열이 있습니다. 하나는 행이 가져온 파일이고, 다른 하나는 해당 파일 내의 고정된 행 ID입니다. 그룹화 기준은 다음과 같습니다. _소스_파일 파일을 비교하기 위해. |
필요한 것
Query Streams 계정
폴더 연결 기능은 무료 플랜을 포함한 모든 플랜에서 사용할 수 있습니다. 무료 플랜은 체험 기간이 만료되는 것이 아니라 계속 사용할 수 있는 플랜입니다. 폴더에 저장할 수 있는 파일 수에는 제한이 없습니다.
에이전트, 버전 2.6.0 이상
폴더를 열 수 있는 컴퓨터(파일 서버 자체, 사무실 컴퓨터 또는 파일이 저장된 컴퓨터)에 설치해야 합니다. 이전 버전의 에이전트는 폴더 카드가 회색으로 표시됩니다. 에이전트 2.6.0+ 배지. Windows, Mac 또는 Linux.
에이전트가 인식하는 폴더 경로
로컬 경로 또는 네트워크 공유는 다음과 같이 작성됩니다. \\서버\공유\폴더. The Agent runs as a service, so it cannot see drives you mapped at your login (Z: and friends). On Windows it can sign in to a share with a login you store; on Linux or a Mac, mount the share first (Linux under /mnt 또는 /메디아, a Mac under /Volumes).
작업은 어디에서 이루어지나요? 에이전트가 실행되는 컴퓨터에서 해당 폴더를 스캔하고, 행을 암호화된 로컬 캐시(하나의 스키마, 이름은 지정됨)에 복사합니다. 파일셋) 그리고 모든 쿼리를 해당 캐시에 대해 실행합니다. 파일은 읽기만 하며, 수정, 이동 또는 업로드되지 않습니다.
Reaching a file on a network share
The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.
If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.
Folders on a share? On Windows, one login covers every folder you add from the same server. 폴더 변경 사항 감시 works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
새로 생성되거나 변경되거나 삭제된 파일이 표시되는 방식
새 파일 및 변경된 파일
모든 것에서 스캔 간격 (또는 몇 초 이내에) 감시 폴더 레이아웃에 맞는 새 파일이 있으면 해당 파일의 행이 추가되고, 나타났다 이벤트. 변경된 파일은 하나의 트랜잭션으로 다시 읽힙니다. 이전 행은 삭제되고 새 행이 추가되며, 파일은 새로운 행을 갖게 됩니다. 수정됨 이벤트.
삭제된 파일
파일이 사라지면 기본적으로 행이 삭제되거나, 삭제됨 표시 옵션을 선택한 경우 삭제된 것으로 표시된 상태로 유지됩니다. 사라졌다 이벤트 발생 시 파일의 절반 이상이 한 번에 사라지면 검사가 거부되고 이전 인벤토리가 유지됩니다. 오프라인 공유는 바로 그런 상태입니다.
파일들을 따로 보관해 두세요
레이아웃에 맞지 않거나, 열 수 없거나, 용량 제한을 초과하는 파일은 전체가 따로 분리되어 어떤 행도 로드되지 않습니다. 파일_이벤트 얻다 경향 파일 이름과 열 이름을 행에 입력합니다. 파일을 수정하고 저장하면 다음 검사에서 다시 시도합니다.
내가 보고 있는 것이 얼마나 신선한 걸까?
쿼리 결과는 마지막 스캔에서 가져온 것입니다. '다시 스캔'이나 '지금 동기화' 버튼은 없으며, 스캔 간격, 폴더 감시 기능 등이 있습니다. 질문에 답변하기 전에 새로고침하세요. 세 가지 제어 장치가 있습니다. MAX(last_seen_utc) 부터 파일_현재 요원이 마지막으로 확인한 시간을 알려줍니다.
따로 보관해둔 파일들
점검 단계와 매니페스트 탭에 세 단어가 나타납니다. 이 단어들은 서로 다른 의미를 지닙니다.
- (주차된) 자리를 비워 두세요
- 해당 파일은 고정된 레이아웃과 일치하지 않거나, 읽을 수 없거나, 찢어졌거나, 잠겨 있거나, 덮개로 가려져 있습니다. 파일별로 모든 행이 처리되거나 전혀 처리되지 않습니다. 파킹된 파일은 행을 전혀 처리하지 않습니다.
파일_이벤트기록하다경향줄세부 사항파일 이름과 열 이름을 지정합니다. 파일의 크기와 수정 시간이 변하지 않으면 해당 파일은 건너뛰고, 변경되는 즉시 다시 시도합니다. - 읽을 수 없음
- 에이전트가 해당 파일의 형식을 인식하지 못해 파일을 열거나 구문 분석할 수 없습니다. 실제 통합 문서가 아니거나, 다른 프로그램에 의해 잠겨 있거나, 클라우드 자리 표시자이거나, 디코딩할 수 없는 바이트 형식일 수 있습니다. 에이전트는 자동으로 대기 상태에 들어가고 폴더의 나머지 파일은 계속 처리됩니다. 읽을 수 있는 파일이 하나도 없는 폴더만 전체 파일 처리를 거부합니다.
- 거부됨
- 에이전트가 레이아웃을 전혀 고정할 수 없습니다. 예를 들어 파일 간에 열 유형이 일치하지 않기 때문입니다. 데이터 테이블이 아직 존재하지 않습니다.
파일_이벤트얻다거부됨이유가 있는 줄세부 사항에이전트는 레이아웃이 고정될 때까지 모든 스캔에서 다시 시도합니다. 해당 파일을 수정하거나 제외하면 메시지가 사라집니다.
찾아보실 곳: 황색 배너 확인하다 (어떤 파일인지, 그리고 그 이유는 무엇인지 보여주세요.), 커넥터의 명백한 그 후에 탭을 누르세요. SQL에서는 다음과 같습니다. SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.
어디에서든 테이블을 활용하세요
커넥터는 쿼리 스트림의 다른 데이터 소스와 마찬가지입니다. 쿼리는 한 번만 저장하면 됩니다. 쿼리 빌더 (DuckDB 방언입니다) 다음에서 사용하세요:
Claude, Cursor 및 기타 AI 클라이언트
클로드는 Query Streams MCP 서버를 통해 폴더 모델을 알고 있습니다. _소스_파일 그리고 파일_이벤트. MCP를 통해 Claude와 함께 CSV 폴더를 관리하세요..
Nova
비즈니스 플랜에 대해 쉬운 말로 질문해 보세요. Nova는 내장된 설명 덕분에 모든 폴더, 테이블, 열을 알고 있습니다.
폴더 테이블은 다른 커넥터와도 조인할 수 있습니다. 연합 쿼리는 일치시킬 수 있습니다. _소스_파일 CSV 파일 폴더에 있는 이름 또는 주문 ID를 동일한 에이전트의 데이터베이스와 비교합니다.
알아두면 유용한 한계점
폴더 수나 파일 수에는 플랜 제한이 없습니다. 행 수는 다른 커넥터와 마찬가지로 데이터 영역에 포함됩니다. 커넥터에서 기본값을 높이거나 낮출 수 있습니다.
| 환경 | 기본 | 이 제품의 기능은 무엇인가요? |
|---|---|---|
| 최대 깊이 | 8 | 각 루트 아래의 몇 단계 폴더를 스캔할 것인가(1~64). |
| 스캔당 최대 파일 수 | 100,000 | 파일을 한 번에 검토합니다. |
| 해시할 최대 파일 크기 | 32 MiB | 오직 ~에만 중요합니다 해시 파일 내용 에. |
| 이벤트 로그 보존 | 30일 | 얼마나 걸려요 파일_이벤트 행은 유지됩니다. |
| 루트별 스캔 병렬 처리 | 2 | 루트 폴더별로 한 번에 하나의 폴더를 읽습니다. |
파일 내용을 자르지 않고 저장하는 콘텐츠 제한은 파일당 200만 행(512MiB), 스캔당 1,000만 행(2GiB)입니다. 폴더에는 최대 25개의 서로 다른 레이아웃을 저장할 수 있습니다. 레이아웃당 테이블 하나 방법.
사람들이 묻는 질문
내 파일들이 어디에 업로드되었나요?
아니요. 에이전트는 자체 컴퓨터에서 파일을 읽어 암호화된 로컬 캐시에 행을 저장합니다. 쿼리는 해당 캐시를 대상으로 실행되며, 쿼리가 반환하는 행만 하나의 아웃바운드 연결을 통해 컴퓨터 밖으로 전송됩니다. 파일은 절대 수정, 이동 또는 변환되지 않습니다.
포트를 열어야 하나요, 아니면 VPN을 실행해야 하나요?
아니요. 에이전트는 443번 포트로 하나의 아웃바운드 연결을 생성하며, 모든 요청과 행은 해당 포트를 통해 전송됩니다. 아웃바운드 HTTPS 연결이 정상적으로 작동한다면, 이 방식도 정상적으로 작동합니다.
해당 폴더가 네트워크 공유 폴더나 OneDrive 또는 Dropbox에 있을 수 있나요?
Yes. Type a share as \\서버\공유\폴더, because the Agent runs as a service and cannot see drives mapped at your login. On Windows, store a login for the server if the share lets in only named people; without one the Agent reads as its own service account. On Linux or a Mac, mount the share first. A synced OneDrive or Dropbox folder works when its files are stored on the computer: set the folder to 이 기기를 항상 켜 두세요에이전트는 클라우드 전용 파일을 다운로드하지 않습니다.
폴더에는 여러 종류의 파일이 있습니다. 커넥터는 하나인가요, 두 개인가요?
커넥터 하나는 한 가지 파일 형식만 읽습니다. CSV 파일과 Parquet 파일이 있는 폴더는 동일한 루트에 두 개의 커넥터(각 형식별로 하나씩)가 필요합니다. 포함 패턴과 일치하지 않는 파일은 무시되며, 따로 분류되지 않습니다.
재스캔 버튼이 있나요?
아니요. 에이전트가 스캔합니다. 스캔 간격변화에 반응할 때 감시 폴더 이 기능이 켜져 있으면 쿼리에 응답하기 전에 다시 스캔할 수 있습니다. 커넥터를 편집하여 세 가지 설정 중 하나를 변경할 수 있습니다.
무료 플랜으로 이 모든 기능을 이용할 수 있나요?
네. 무료 플랜은 만료되는 체험판이 아니라 계속 사용할 수 있는 플랜입니다. 폴더 커넥터 자체에는 파일 수 제한이 없으며, 다른 커넥터와 마찬가지로 행 수가 데이터 영역에 포함됩니다. 각 플랜에 포함된 내용은 다음에서 확인하세요. 가격 페이지.
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish