폴더 커넥터 · JSONL 폴더

JSON 라인 파일이 담긴 폴더를 다음으로 변환합니다. SQL 테이블 어디서든 조회할 수 있습니다

쿼리 스트림 에이전트를 해당 폴더로 지정하세요. 에이전트는 자체 컴퓨터에서 파일을 읽고 로컬 캐시에 테이블을 구축한 다음 파일이 추가, 변경 또는 삭제될 때마다 최신 상태로 유지합니다. Excel, Google Sheets, Nova, Claude 또는 REST API를 통해 해당 테이블을 쿼리할 수 있습니다. 파일이 업로드되거나 변환 또는 편집되는 일은 없습니다.

약 15분 코딩이 필요 없습니다 파일은 네트워크에 저장됩니다. 무료 플랜에서 해당 내용을 다룹니다.

진행 과정에서 막히는 부분이 있나요? 언제든지 저희에게 문의하세요. 열려 있는 지원 쿼리 스트림(오른쪽 상단 메뉴 → 지원)에서 메시지를 보내주세요. 담당자가 직접 확인하며, "이 화면에서 무엇을 묻는지 모르겠습니다"라는 질문은 전혀 문제없습니다.

당신이 최종적으로 얻게 될 것

결과적으로 사용자가 지정한 이름의 SQL 테이블 하나가 생성되며, 이 테이블에는 폴더에 있는 모든 JSONL 파일의 모든 줄이 저장됩니다. 만약 그 테이블의 이름을 그렇게 짓는다면... 이벤트질문합니다 파일셋.이벤트중첩된 객체는 사용자가 선택한 깊이까지 열로 평면화되고, 더 깊은 값들은 JSON 텍스트로 유지되며, 모든 행에는 다음 내용이 포함됩니다. _소스_파일 어떤 파일에서 가져온 것인지 알 수 있습니다. 폴더에 다양한 형식의 파일이 섞여 있는 경우, 형식별로 테이블을 하나씩 만들 수 있습니다. 에이전트는 자체 컴퓨터에서 폴더를 읽고 암호화된 로컬 저장소에 행을 캐시한 다음, Excel, Google Sheets, 쿼리 빌더 또는 기타 클라이언트에 SQL 형식으로 제공합니다. 파일은 네트워크에 저장됩니다.

폴더

시간이 지남에 따라 도착하는 파일

sales_2026_07.jsonl

sales_2026_08.jsonl

sales_2026_09.jsonl

파일셋.이벤트

각 파일의 행, 하나의 테이블

_소스_파일	행 개수	첫 번째 행 ID
sales_2026_07.jsonl	…	…
sales_2026_08.jsonl	…	…
sales_2026_09.jsonl	…	…

모든 테이블은 하나의 스키마에 있습니다. 파일셋. 와 함께 고정된 레이아웃 하나기본 설정으로, 해당 이름으로 된 테이블 하나가 생성됩니다. 테이블 이름 예를 들어, 당신이 입력하는 것은 파일셋.이벤트일치하는 모든 파일의 행을 저장합니다. 중첩된 객체는 아래로 내려갈수록 열이 됩니다. 깊이를 평평하게기본값은 2이고, 그보다 작은 값은 JSON 텍스트로 저장됩니다. 각 행에는 다음 내용이 포함됩니다. _소스_파일 그리고 안정적인 _row_id.

와 함께 레이아웃당 테이블 하나각각의 고유한 모양은 최대 25개의 개별 테이블이 되며, 파일 이름의 공통 부분에서 끝자리 숫자를 제거한 이름으로 지정됩니다. orders_2026_01.jsonl 에게 orders_2026_03.jsonl ~이 되다 파일세트.주문만약 사용 가능한 요소가 남아 있지 않으면 테이블 이름이 사용됩니다. 레이아웃이 고정되어 있는 동안에는 이름이 변경되지 않으며, 레이아웃을 자동으로 쌓아 올리는 보기 기능은 없습니다.

모든 폴더 커넥터는 회계 테이블도 제공합니다. 파일, 파일_이벤트, 디렉토리, 디렉토리 스냅샷 그리고 볼륨.

에이전트는 자체 컴퓨터에서 폴더를 읽고, 해당 행들을 암호화된 로컬 캐시에 저장한 후, 모든 쿼리를 해당 캐시를 대상으로 실행합니다. 쿼리에서 반환된 행들만 하나의 아웃바운드 연결을 통해 외부로 전송됩니다. 포트를 열 필요도 없고, VPN도 필요 없으며, 업로드도 필요하지 않습니다.

생계를 유지하는 곳:

필요한 것

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).

작업은 어디에서 이루어지나요? 에이전트가 실행되는 컴퓨터에서 해당 폴더를 스캔하고, 행을 암호화된 로컬 캐시(하나의 스키마, 이름은 지정됨)에 복사합니다. 파일셋) 그리고 모든 쿼리를 해당 캐시에 대해 실행합니다. 파일은 읽기만 하며, 수정, 이동 또는 업로드되지 않습니다.

5단계로 설정하세요

해당 폴더를 열 수 있는 컴퓨터에 에이전트를 설치하세요.
로그인, 열기 다운로드JSON 라인 파일이 저장된 폴더를 열 수 있는 컴퓨터(파일 서버 또는 공유 폴더에 접근할 수 있는 항상 켜져 있는 컴퓨터)에 시스템용 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다. 버전 2.6.0 이상이 필요하며, 다운로드 페이지에서 항상 최신 버전을 확인할 수 있습니다.
드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux에 한 번만 설치하면 됩니다(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘습니다). 에이전트는 Query Streams에 대한 암호화된 아웃바운드 연결을 하나만 생성하며, 필요한 네트워크 경로는 이것뿐입니다. 인바운드 포트를 열거나 VPN을 사용할 필요가 없습니다. 에이전트는 설치된 폴더에서 데이터를 읽기 때문에 파일은 제자리에 유지되고, 쿼리 결과가 반환된 행만 인터넷을 통해 사용자의 추가 기능, 브라우저 또는 AI 클라이언트로 전송됩니다.
다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 컴퓨터에서 하는 작업은 그게 전부입니다. 나머지 모든 작업은 브라우저에서 이루어집니다.
자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.
JSON 라인 파일이 있는 폴더를 지정하세요.

브라우저를 다시 열어주세요 데이터 → 데이터 에이전트방금 설치한 에이전트를 찾아서 클릭하세요. 커넥터 추가 버튼을 누르세요. 열기 파일 및 폴더 약을 고르세요 JSONL 폴더 카드. 어떤 카드가 맞는지 모르시겠나요? 선택하세요 폴더 안의 파일들 대신 에이전트가 폴더를 샘플링하고 "찾은 내용" 페이지에 폴더 안의 내용을 표시한 다음 미리 채워진 해당 카드를 열어줍니다.
마법사가 달린다 폴더 → 확인 → 설정 → Realm → 검토. 에 폴더:
루트 폴더
One path per line, as the Agent’s computer sees it. Each folder shows a status (reachable, denied, missing, unreachable, credentials invalid or not mounted) as soon as you add it. On a Windows Agent a share that needs a login gets one from the folder’s Credential column, stored once per server; on Linux or a Mac, mount the share first.
하위 폴더 스캔, 최대 깊이
기본적으로 켜져 있고 8단계로 설정되어 있습니다.
패턴 포함, 패턴 제외
어떤 파일이 포함되는지 알아봅니다. 포함 패턴은 이 카드에 맞는 글로브 패턴으로 시작합니다. 하나의 커넥터는 하나의 파일 형식, 즉 CSV 파일이 있는 폴더를 읽습니다. 그리고 Parquet 파일은 동일 폴더에 파일 형식별로 하나씩, 총 두 개의 커넥터로 구성됩니다.
심볼릭 링크와 접합점을 따라가세요
기본적으로 비활성화되어 있습니다. 이 기능을 활성화하지 않으면 에이전트는 바로 가기나 클라우드 자리 표시자를 따라가지 않습니다.
해당 폴더를 열 수 있는 컴퓨터에 쿼리 스트림 에이전트를 설치하십시오. 에이전트 버전 2.6.0 이상이 필요합니다. 해당 에이전트에서 커넥터 추가 버튼, 열기 파일 및 폴더 그리고 선택하세요 JSONL 폴더 카드.
- 루트 폴더에이전트 컴퓨터에서 검사할 폴더를 한 줄에 하나씩 입력합니다. 예를 들어, '네트워크 공유'와 같이 입력합니다. \\서버\공유\폴더매핑된 드라이브 문자가 아닙니다.
- 패턴을 포함하세요 시작하다 **/*.jsonl파일 확장자가 다른 경우 패턴을 추가하세요.
- 테이블 이름 필수 입력 사항입니다. 다음과 같은 이름을 입력하세요. 이벤트.
- 깊이를 평평하게중첩된 객체의 몇 단계가 열로 표현될지 지정합니다. 기본값은 2이며, 범위는 1에서 8까지입니다. 더 깊은 단계의 값은 JSON 텍스트로 표시됩니다.
- 테이블 레이아웃: 떠나다 고정된 레이아웃 1개(기본값) 반복 내보내기와 같이 모든 파일이 하나의 레이아웃을 공유하는 경우. 선택하세요 레이아웃당 테이블 하나 사람들이 손으로 조립하는 폴더의 경우, 각기 다른 레이아웃마다 최대 25개의 표가 따로 있습니다.
무엇이 생성될지 확인해 보세요

~에 확인하다 에이전트는 최대 64개의 파일 샘플을 읽고 빌드할 내용을 보여줍니다. 아직 아무것도 생성되지 않았습니다. 버튼에는 다음과 같이 표시됩니다. 테스트 연결 판결이 나올 때까지, 다음; 다시 테스트해 보세요 변경 사항을 적용하면 샘플을 다시 실행합니다. 다음 네 가지 제목 중 하나가 표시됩니다.
만들 준비가 되었습니다
샘플링된 모든 파일이 들어맞습니다. 그 아래 칩에는 접근 가능한 폴더 수, 파일 및 행 수, 그리고 존재할 테이블의 정보가 표시됩니다.
준비 완료, 메모 포함
일부 파일은 보류되거나 레이아웃 스니프가 거부될 수 있습니다. 어떤 파일인지 정확히 알려주는 주황색 배너가 표시됩니다. "{m}개 파일 중 {n}개가 보류됩니다." 어떤 파일인지, 그리고 그 이유는 무엇인지 보여주세요. 목록에는 "그래도 생성할 수 있습니다. 커넥터가 계속 재확인하고 매니페스트 탭에 이유를 보고합니다."라고 표시됩니다.
주의가 필요합니다
에이전트가 오프라인 상태이거나 폴더가 누락되었습니다. 계속 진행하기 전에 문제를 해결하세요. 에이전트가 오프라인 상태인 경우에도 페이지에 오프라인이라고 표시되고 계속 진행할 수 있습니다.
“이 폴더에는 {n}개의 서로 다른 파일 레이아웃이 있습니다.” 하늘색 패널은 샘플링된 파일들이 모두 동일한 열 집합을 공유하지 않음을 의미합니다. 테이블 레이아웃 기본값은 고정된 레이아웃 하나모든 파일이 일치할 것으로 예상합니다. 클릭하세요. 레이아웃당 테이블 하나로 전환 그리고 각 레이아웃은 (최대 25개까지) 자체 테이블이 됩니다.
거절이나 보류 파일은 절대 당신을 막지 않습니다. 클릭하세요. 다음마법사를 완료하고 나중에 문제가 있는 파일을 수정하세요. 에이전트가 오프라인 상태이거나 폴더가 누락된 경우에만 마법사가 중지됩니다.

~에 확인하다에이전트는 최대 64개의 파일 샘플을 읽고 파일 수, 크기, 행 수 예상치 및 생성될 테이블을 표시합니다. 아직 아무것도 생성되지 않았습니다. 이 소스에서 가장 자주 보고되는 내용은 혼합된 형태입니다. 샘플에 여러 레이아웃이 포함되어 있는 경우 테이블 레이아웃 여전히 고정되어 있고 파란색 패널에 "이 폴더에는 3개의 다른 파일 레이아웃이 있습니다"라고 표시되며, 고정된 레이아웃은 모든 파일이 하나의 레이아웃을 공유해야 한다고 설명합니다. 클릭하세요. 레이아웃당 테이블 하나로 전환 각 도형은 자체 테이블이 됩니다. 에이전트가 JSONL 형식으로 읽을 수 없는 파일은 아래에 표시됩니다. 어떤 파일인지, 그리고 그 이유는 무엇인지 보여주세요. 일부는 따로 분리해 두고 나머지는 계속 로드합니다. 커넥터는 어떤 방식으로든 생성할 수 있으며, 지속적으로 재확인하고 그 이유를 보고합니다. 명백한 꼬리표.
스캔 빈도를 선택한 다음 생성하세요.

기본 설정 설정 하루에 몇 개의 파일만 받는 폴더에 적합합니다. 변경하고 싶은 네 가지 사항은 다음과 같습니다.
스캔 간격
매시간 기본 설정은 5분 간격부터 매일까지 다양합니다. 각 스캔은 파일 크기와 수정 시간을 비교하여 새로 생성되거나 변경되었거나 사라진 파일을 찾습니다.
폴더 변경 사항을 실시간으로 감시합니다.
기본적으로 비활성화되어 있습니다. 활성화하면 에이전트가 로컬 디스크에서는 몇 초 내에 반응하고, 네트워크 공유에서는 최선을 다해 반응하며 예약된 검사가 가장 확실한 반응을 보장합니다. 조용한 기간 (15초) 파일 쓰기가 완료될 때까지 기다립니다.
질문에 답변하기 전에 새로고침하세요.
기본적으로 비활성화되어 있습니다. 활성화하면 마지막 스캔이 설정된 시간보다 오래되었을 때 쿼리가 먼저 다시 스캔합니다. 정체 창 (60초), 최대 대기 시간 쿼리 대기 제한 (5초). 이는 알림 폴링이 아닌 사람 및 추가 기능에 적용됩니다.
파일이 사라졌을 때
행을 내려놓으세요 기본적으로 또는 행은 유지하고 삭제된 항목은 표시(묘비 표시)합니다.그. 바니쉬 가드 비율 (0.5) 한 번에 절반 이상의 파일을 손실하는 스캔을 거부하고 이전 인벤토리를 유지합니다. 이것이 오프라인 공유의 모습입니다.
그런 다음 선택하세요 데이터 영역 행 수를 세어보세요. 검토 클릭하고 클릭하세요 커넥터를 생성합니다.첫 번째 스캔은 즉시 시작됩니다. 커넥터의 명백한 탭에는 빌드된 내용과 따로 저장해 둔 파일이 표시됩니다.

테이블을 보세요

커넥터를 여세요: 명백한 탭에는 생성된 테이블 목록이 표시됩니다. 쿼리 빌더 같은 테이블들이 그 아래에 놓여 있습니다. 파일셋 스키마. 첫날부터 작동하는 세 가지 쿼리:

JSONL 파일당 행 수

SELECT _source_file, COUNT(*) AS row_count FROM fileset.events GROUP BY _source_file ORDER BY row_count DESC LIMIT 100

파일당 한 줄씩 표시되므로 각 JSONL 파일이 몇 줄을 차지했는지 확인할 수 있습니다.

지난 하루 동안 변경된 파일

SELECT relative_path, size_bytes, modified_utc FROM fileset.files WHERE modified_utc >= now() - INTERVAL 1 DAY ORDER BY modified_utc DESC LIMIT 100

요원이 확인한 파일은 어제와 달라졌으며, 최신 파일부터 표시됩니다.

보류되거나 거부된 파일 및 그 이유

SELECT relative_path, event_type, detected_by, detail, event_at FROM fileset.files_events WHERE event_type IN ('refused', 'drift') ORDER BY event_at DESC LIMIT 20

누락된 줄이 있는 모든 파일과 그 이유를 자세히 설명하고, 새로운 형태로 변경된 파일도 포함합니다.

모든 폴더 커넥터는 동일한 회계 테이블을 제공하며, 모든 기능은 여기에 있습니다. 파일셋 개요:

테이블	그것이 담고 있는 것
`파일`	폴더에 현재 있는 모든 파일의 경로, 이름, 확장자, 크기, 생성 및 수정 시간, 최초 및 마지막 확인 시간 정보를 한눈에 볼 수 있습니다. `파일_현재`또한 사라진 파일도 보관합니다.
`파일_이벤트`	변경 내역: 파일당 한 행씩 `나타났다`, 였다 `수정됨`, `사라졌다`, 따로 떼어 놓았습니다.`경향`) 또는 ~였다 `거부됨`시간과 함께 `이벤트_at`어떻게 그것이 발견되었는지 `감지됨_` 그리고 그 이유는 다음과 같습니다. `세부 사항`.
`디렉토리`, `디렉토리 스냅샷`, `볼륨`	폴더 개수 및 크기, 증가 추세, 그리고 루트 폴더가 위치한 디스크 또는 공유 폴더 정보입니다.
`_소스_파일`, `_row_id`	각 데이터 행에는 두 개의 열이 있습니다. 하나는 행이 가져온 파일이고, 다른 하나는 해당 파일 내의 고정된 행 ID입니다. 그룹화 기준은 다음과 같습니다. `_소스_파일` 파일을 비교하기 위해.

그게 다예요. 폴더에 새 파일을 넣으면 다음 스캔 후에 해당 파일이 표에 나타납니다. 파일은 원래 있던 컴퓨터를 벗어나지 않습니다.

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.

Every folder on the 폴더 step shows a status as soon as you add it. Hover the status to read the Agent’s own message; its first words say which case it is.

Status or message	그것이 의미하는 바는	어떻게 해야 할까요?
denied	The share did not let the Agent in. With no login stored, a Windows Agent reads as its service account, which a company domain sees as the computer itself.	Windows: click Service identity in the folder’s Credential column and store a login that can read the share, or ask whoever runs the server to give the stored one read access. Linux or Mac: the share is mounted, but its permissions keep the Agent out; check how it is mounted (리눅스, 스코틀랜드 사람).
credentials invalid, 또는 The stored credentials for \\server were refused	The server rejected the stored login: a typo, the wrong domain or a changed password. The Agent waits a minute before it tries that login again, so the account is not locked out.	Click the account name in the Credential column and type the login again. For an account made on the server itself, leave Domain blank.
없어진	No folder at that path. On Windows, a server name that cannot be found, or a share the server does not have, also shows as missing.	Check the names, or pick the folder with Add folder from the agent instead of typing it.
unreachable, 또는 \\server did not answer	No answer from the server: it is off, the name is wrong, or a firewall blocks file sharing.	Open the same \\서버\공유 path on the Agent’s computer. If that fails too, it is a network problem.
not mounted (Linux or Mac)	The share is not mounted on the Agent’s computer. Hover the status, or the Not mounted chip in the Credential column, for the exact mount command.	Mount the share (리눅스, 스코틀랜드 사람), then test the folder again.
Another connector on this agent already signs in to \\server as …	Windows allows one account per file server on each computer, and another connector on this Agent uses a different one.	Use the same login as that connector, or change it on every connector that reads this server.
Windows already holds a sign-in to \\server for …	Something else on the Agent’s computer is signed in to that server with another account, and the Agent never closes a sign-in it did not make.	Follow the message: it names the Windows account the Agent runs as and says whether Use service identity would read the share through the existing sign-in.
This agent build cannot sign in to \\server with stored credentials.	An older Agent that cannot use a stored share login.	Update the Agent, then test again.

어디에서든 사용하세요

커넥터는 쿼리 스트림의 다른 데이터 소스와 마찬가지입니다. 쿼리는 한 번만 저장하면 됩니다. 쿼리 빌더 (DuckDB 방언입니다) 다음에서 사용하세요:

Excel

추가 기능의 쿼리를 스트리밍하세요 행들을 시트에 추가하고 클릭 한 번으로 다시 실행합니다. Excel에서 SQL 실행하기.

Google 스프레드시트

그만큼 쿼리 스트리머 추가 기능은 사용자가 선택한 탭을 채웁니다. Google 스프레드시트용 파워 쿼리.

Claude, Cursor 및 기타 AI 클라이언트

클로드는 Query Streams MCP 서버를 통해 폴더 모델을 알고 있습니다. _소스_파일 그리고 파일_이벤트. MCP를 통해 Claude와 함께 JSONL 폴더를 사용하세요..

REST API

저장된 모든 쿼리는 모든 플랜에서 자체 키를 가진 읽기 전용 엔드포인트가 됩니다. JSONL 폴더 REST API.

Nova

비즈니스 플랜에 대해 쉬운 말로 질문해 보세요. Nova는 내장된 설명 덕분에 모든 폴더, 테이블, 열을 알고 있습니다.

자동화

Airtable, Smartsheet, Baserow, SeaTable 또는 지정된 시트에 행을 동기화하세요. 자동화 가이드.

폴더 테이블은 다른 커넥터와도 조인할 수 있습니다. 연합 쿼리는 일치시킬 수 있습니다. _소스_파일 JSON 라인 파일이 담긴 폴더에 있는 이름이나 주문 ID를 동일한 에이전트의 데이터베이스와 비교합니다.

새로 생성되거나 변경되거나 삭제된 파일이 표시되는 방식

새 파일 및 변경된 파일

모든 것에서 스캔 간격 (또는 몇 초 이내에) 감시 폴더 레이아웃에 맞는 새 파일이 있으면 해당 파일의 행이 추가되고, 나타났다 이벤트. 변경된 파일은 하나의 트랜잭션으로 다시 읽힙니다. 이전 행은 삭제되고 새 행이 추가되며, 파일은 새로운 행을 갖게 됩니다. 수정됨 이벤트.

삭제된 파일

파일이 사라지면 기본적으로 행이 삭제되거나, 삭제됨 표시 옵션을 선택한 경우 삭제된 것으로 표시된 상태로 유지됩니다. 사라졌다 이벤트 발생 시 파일의 절반 이상이 한 번에 사라지면 검사가 거부되고 이전 인벤토리가 유지됩니다. 오프라인 공유는 바로 그런 상태입니다.

파일들을 따로 보관해 두세요

레이아웃에 맞지 않거나, 열 수 없거나, 용량 제한을 초과하는 파일은 전체가 따로 분리되어 어떤 행도 로드되지 않습니다. 파일_이벤트 얻다 경향 파일 이름과 열 이름을 행에 입력합니다. 파일을 수정하고 저장하면 다음 검사에서 다시 시도합니다.

내가 보고 있는 것이 얼마나 신선한 걸까?

쿼리 결과는 마지막 스캔에서 가져온 것입니다. '다시 스캔'이나 '지금 동기화' 버튼은 없으며, 스캔 간격, 폴더 감시 기능 등이 있습니다. 질문에 답변하기 전에 새로고침하세요. 세 가지 제어 장치가 있습니다. 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.

일반적으로 다음과 같은 JSON 라인 파일이 있는 폴더의 경우: 고정된 레이아웃과 다른 키 집합을 포함하는 web-03.jsonl 내보내기 파일은 해당 줄이 로드되지 않은 채로 따로 보관됩니다. files_events에는 detected_by 핀이 있는 드리프트 행이 추가되며, 해당 행의 세부 정보에는 파일 이름이 지정되고 레이아웃별 모드에서는 "새 레이아웃 - 커넥터의 드라이버 옵션 또는 매니페스트 재정의를 편집하여(변경 시 다시 스니핑됨) 새 테이블로 추가하세요."라는 내용이 표시됩니다.

알아두면 유용한 한계점

폴더 수나 파일 수에는 플랜 제한이 없습니다. 행 수는 다른 커넥터와 마찬가지로 데이터 영역에 포함됩니다. 커넥터에서 기본값을 높이거나 낮출 수 있습니다.

환경	기본	이 제품의 기능은 무엇인가요?
최대 깊이	8	각 루트 아래의 몇 단계 폴더를 스캔할 것인가(1~64).
스캔당 최대 파일 수	100,000	파일을 한 번에 검토합니다.
해시할 최대 파일 크기	32 MiB	오직 ~에만 중요합니다 해시 파일 내용 에.
이벤트 로그 보존	30일	얼마나 걸려요 `파일_이벤트` 행은 유지됩니다.
루트별 스캔 병렬 처리	2	루트 폴더별로 한 번에 하나의 폴더를 읽습니다.

파일 내용을 자르지 않고 저장하는 콘텐츠 제한은 파일당 200만 행(512MiB), 스캔당 1,000만 행(2GiB)입니다. 폴더에는 최대 25개의 서로 다른 레이아웃을 저장할 수 있습니다. 레이아웃당 테이블 하나 방법.

사람들이 묻는 질문

중첩된 JSON 객체는 어떻게 처리되나요?

그것들은 아래로 납작한 기둥 모양을 이룬다. 깊이를 평평하게 기본값은 2이고 최대 8까지 설정할 수 있습니다. 그보다 더 깊게 샘플링하더라도 JSON 텍스트 형태로 한 열에 저장되므로 데이터 손실은 없습니다. 쿼리에서 JSON 텍스트를 계속 분석해야 하는 경우 샘플링 깊이를 늘리세요. 값을 변경하면 폴더를 다시 샘플링하고 테이블을 재구성합니다.

내 파일들은 형태가 제각각입니다. 그래도 조회가 가능한가요?

네. 선택하세요. 레이아웃당 테이블 하나 각 도형은 최대 25개까지 자체 테이블이 됩니다. 각 테이블은 파일 이름의 공통 부분을 따서 이름이 지정됩니다. 검사 단계에서 고정된 레이아웃 하나에 있는 동안 여러 도형이 발견되면 해당 사실을 알리고 추가 옵션을 제공합니다. 레이아웃당 테이블 하나로 전환레이아웃을 자동으로 쌓아 올려주는 보기 기능은 없지만, 쿼리에서 UNION을 사용하여 여러 레이아웃을 결합할 수 있습니다.

나중에 새로운 형태의 파일이 도착하면 어떻게 될까요?

해당 영역은 따로 분리되어 있으며, 그 안의 어떤 줄도 로드되지 않습니다. 레이아웃별 모드에서는 파일_이벤트 "새 레이아웃"이라는 세부 정보와 함께 기록됩니다. 새 레이아웃은 자동으로 추가되지 않습니다. 평면화 깊이와 같은 커넥터 옵션을 변경하고 저장하면 에이전트가 다시 샘플링하여 기존 이름을 유지하면서 새 테이블을 추가합니다.

제 파일들은 .json 또는 .ndjson으로 끝나고 .jsonl은 아닙니다. 이런 파일들도 읽힐까요?

일치하는 파일만 패턴을 포함하세요 읽은 내용이며 기본값은 다음과 같습니다. **/*.jsonl다음과 같은 패턴을 추가하세요. **/*.ndjson 다른 확장자의 경우에도 마찬가지입니다. 각 파일은 여전히 한 줄에 하나의 JSON 객체를 포함해야 합니다. 하나의 커넥터는 하나의 파일 형식만 읽을 수 있으므로 CSV 파일도 포함된 폴더에는 동일한 폴더에 두 번째 커넥터가 필요합니다.

파일 크기나 행 수에 제한이 있나요?

에이전트의 기본 설정은 파일당 2,000,000행 및 512MiB이며, 동기화당 최대 허용 용량은 10,000,000행 또는 2GiB입니다. 허용 용량을 초과하는 파일은 별도로 분리되어 보고됩니다. 파일_이벤트폴더나 파일 개수에 대한 플랜 제한은 없습니다. 클로드가 테이블을 쿼리하도록 하려면 다음을 참조하세요. MCP를 사용하여 JSONL 파일 폴더를 Claude에 연결합니다..

내 파일들이 어디에 업로드되었나요?

아니요. 에이전트는 자체 컴퓨터에서 파일을 읽어 암호화된 로컬 캐시에 행을 저장합니다. 쿼리는 해당 캐시를 대상으로 실행되며, 쿼리가 반환하는 행만 하나의 아웃바운드 연결을 통해 컴퓨터 밖으로 전송됩니다. 파일은 절대 수정, 이동 또는 변환되지 않습니다.

포트를 열어야 하나요, 아니면 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 파일이 있는 폴더는 동일한 루트에 두 개의 커넥터(각 형식별로 하나씩)가 필요합니다. 포함 패턴과 일치하지 않는 파일은 무시되며, 따로 분류되지 않습니다.

재스캔 버튼이 있나요?

아니요. 에이전트가 스캔합니다. 스캔 간격변화에 반응할 때 감시 폴더 이 기능이 켜져 있으면 쿼리에 응답하기 전에 다시 스캔할 수 있습니다. 커넥터를 편집하여 세 가지 설정 중 하나를 변경할 수 있습니다.

무료 플랜으로 이 모든 기능을 이용할 수 있나요?

네. 무료 플랜은 만료되는 체험판이 아니라 계속 사용할 수 있는 플랜입니다. 폴더 커넥터 자체에는 파일 수 제한이 없으며, 다른 커넥터와 마찬가지로 행 수가 데이터 영역에 포함됩니다. 각 플랜에 포함된 내용은 다음에서 확인하세요. 가격 페이지.

다른 폴더의 쿼리 스트림은 테이블로 변환됩니다.SQL을 사용하여 파일이 있는 폴더를 쿼리하는 방법 모든 파일 세트 가이드

아직도 막히셨나요? 열려 있는 지원 쿼리 스트림에서 현재 단계와 표시되는 내용을 알려주시면 연결해 드리겠습니다.

모든 가이드 JSONL Folder

원하는 설정이 아닌가요?

이 파일들은 앱 자체의 로그 파일인데 계속해서 용량이 커지는 건가요? 애플리케이션 로그는 새 줄이 기록될 때마다 읽어 레벨, 로거, 메시지를 추출합니다. → App Logs
파일 크기, 날짜 및 변경 내역이 포함된 파일 목록만 필요하신가요? 파일 시스템은 파일을 읽지 않고도 이를 제공합니다. → File System

Setup trouble?

Agent says the file or folder does not exist, or access is denied? Mapped drives, network shares, OneDrive and Linux home folders each need one fix → Where the Agent can read files from
Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?