Trasforma qualsiasi cartella di file in tabelle SQL che rimangono aggiornati
Tredici connettori per cartelle, un'unica idea: puntate l'agente Query Streams a una cartella sulla vostra rete e questo creerà le tabelle, etichetterà ogni riga con il file di provenienza e le manterrà aggiornate man mano che i file vengono aggiunti, modificati o eliminati. Potrete interrogarle da Excel, Fogli Google, Nova, Claude o tramite l'API REST. Non è necessario caricare, convertire o modificare alcun file.
Scegli la guida per i tuoi file
Ogni scheda qui sotto rappresenta un connettore e una guida. Ogni guida segue gli stessi cinque passaggi: installare l'agente, indicargli la cartella, verificare cosa creerà, scegliere la frequenza di scansione, visualizzare le tabelle e quindi mostrare le tabelle, le query e le insidie specifiche per quel tipo di file. Non sei sicuro di quale sia la più adatta? Nel portale scegli File in una cartella: l'agente campiona la cartella e apre la scheda corretta per te.
Sistema di file
Un inventario interrogabile di ogni file presente nelle cartelle, con dimensioni, date, cronologia delle modifiche e crescita delle cartelle, senza dover leggere il contenuto dei file.
Cartella CSV
Tutti i file CSV presenti nella cartella sono stati uniti in un'unica tabella, oppure in una tabella per ogni layout, con ogni riga contrassegnata dal file di provenienza.
Cartella Parquet
Una cartella di file Parquet formattata come un'unica tabella, con colonne e tipi ricavati dai piè di pagina dei file.
Cartella Excel
I fogli di ogni cartella di lavoro uniti in un'unica tabella per foglio, come ad esempio ordini_datioppure una tabella per layout per cartelle di lavoro miste.
Cartella SQLite
Molti file SQLite vengono interrogati come se fossero un unico database, con le tabelle con lo stesso nome unite e ogni riga etichettata con il nome del file corrispondente.
Cartella JSONL
File di righe JSON appiattiti in colonne in un'unica tabella, oppure una tabella per ogni forma.
File CSV multi-record
una tabella per tipo di record, come ad esempio data_hdr e elemento_dati, unibili tramite numero di file e numero di sequenza.
Registri delle macchine
I registri CNC, PLC e robot sono stati inseriti in un eventi tabella, oltre a tabelle di allarme, ciclo e tempi di inattività per i controller supportati.
Registri del server web
Una riga per ogni richiesta dai log di nginx, Apache, IIS o Caddy, con IP del client, percorso, stato e byte come colonne.
Registri dei container
Le righe del log del container Docker sono visualizzate come righe, mentre il nome del container, lo stream e il messaggio sono visualizzati come colonne.
Registri delle applicazioni
I log delle applicazioni, sia in formato JSON che testuale, vengono visualizzati come righe con livello, logger e messaggio, mentre le tracce dello stack vengono conservate insieme all'evento corrispondente.
Registri personalizzati
Qualsiasi registro di testo viene analizzato e suddiviso nelle colonne da te descritte, mentre le righe non analizzate vengono conservate in una tabella di righe grezze.
Come funziona ogni connettore di cartella
Un connettore di database punta a un server che ha già delle tabelle. Un connettore di cartella punta alle cartelle sul computer dell'agente. L'agente legge i file, fissa un layout da un campione di massimo 64 di essi, crea le tabelle in una cache locale crittografata (uno schema DuckDB, denominato set di filee li aggiorna secondo una pianificazione a tua scelta. I file che non si adattano al layout vengono messi da parte e segnalati, mai eliminati silenziosamente o modificati a piacimento. Un connettore legge un solo tipo di file; una cartella con file CSV e Parquet corrisponde a due connettori sulla stessa cartella.
Ogni connettore di cartella serve anche le stesse tabelle di contabilità, tutte nella set di file schema:
| Tavolo | Cosa contiene |
|---|---|
file | Ogni file attualmente presente nella cartella: percorso, nome, estensione, dimensione, data di creazione e di modifica, prima e ultima visualizzazione. Una panoramica file_correntiche conserva anche i file scomparsi. |
file_eventi | La cronologia delle modifiche: una riga per file che apparso, era modificato, scomparso, è stato messo da parte (deriva) o era rifiutato, con il tempo in evento_al, come è stato notato in rilevato_da e il motivo in dettaglio. |
elenchi, istantanee della directory, volumi | Numero e dimensioni delle cartelle, come sono cresciute e i dischi o le condivisioni su cui risiedono le directory principali. |
_source_file, _row_id | Due colonne su ogni riga di dati: il file da cui proviene la riga e un ID di riga stabile all'interno di quel file. Raggruppa per _source_file per confrontare i file. |
Cosa ti servirà
Un account Query Streams
I connettori per le cartelle sono disponibili in tutti i piani, incluso quello gratuito. Il piano gratuito è un piano a lungo termine, non una prova che scade. Non c'è limite al numero di file che una cartella può contenere.
L'agente, versione 2.6.0 o successiva
Installato su un computer in grado di aprire la cartella: il file server stesso, un computer dell'ufficio o la macchina su cui finiscono i file. Un agente più vecchio mostra le schede delle cartelle in grigio con un Agente 2.6.0+ Distintivo. Windows, Mac o Linux.
Il percorso della cartella, così come lo vede l'agente.
Un percorso locale o una condivisione di rete scritta come \\server\condiviso\cartella. 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 o /media, a Mac under /Volumes).
Dove si svolge il lavoro? Sul computer che esegue l'agente. Scansiona la cartella, copia le righe in una cache locale crittografata lì (uno schema, denominato set di filee esegue ogni query su quella cache. I tuoi file vengono letti, mai modificati, spostati o caricati.
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. Controlla la cartella per eventuali modifiche works on a share too, on a best-effort basis; the scheduled scan is what guarantees every change is picked up.
Come vengono visualizzati i file nuovi, modificati ed eliminati
File nuovi e modificati
Su ogni Intervallo di scansione (o in pochi secondi con Cartella di monitoraggio su) un nuovo file che si adatta al layout ha le sue righe aggiunte e ottiene un apparso evento. Un file modificato viene riletto in una transazione: le sue vecchie righe vanno, le sue nuove righe arrivano e ottiene un modificato evento.
File eliminati
Un file che scompare elimina le sue righe per impostazione predefinita, oppure le mantiene contrassegnate come eliminate se hai scelto l'opzione lapide e ottiene un scomparso evento. Se più della metà dei file scompare contemporaneamente, la scansione viene rifiutata e l'inventario precedente rimane: una condivisione offline si presenta esattamente in questo modo.
File da mettere da parte
Un file che non si adatta al layout, non può essere aperto o supera un limite viene messo da parte per intero: nessuna delle sue righe viene caricata e file_eventi ottiene un deriva riga che denomina il file e la colonna. Correggi il file e salvalo; la scansione successiva riprova.
Quanto è fresco ciò che vedo?
Le query rispondono dall'ultima scansione. Non c'è un pulsante Riscansiona o Sincronizza ora; l'intervallo di scansione, il monitoraggio della cartella e Aggiorna la pagina prima di rispondere a una domanda sono i tre comandi. MAX(ultimo_visto_utc) da file_correnti Ti indica quando l'agente ha effettuato l'ultima verifica.
File che vengono messi da parte
Nella fase di verifica e nella scheda Manifest compaiono tre parole che hanno significati diversi:
- Riservato (parcheggiato)
- Il file non corrisponde al layout bloccato, oppure è illeggibile, strappato, bloccato o coperto da un cappuccio. Per ogni file, la regola è "tutto o niente": un file parcheggiato non contribuisce con nessuna riga.
file_eventiregistra underivafila la cuidettaglioIl programma specifica il nome del file e della colonna. Il file viene ignorato finché le sue dimensioni e la data di modifica rimangono invariate, e viene riprovato non appena si verificano delle modifiche. - Illeggibile
- L'agente non è riuscito ad aprire o analizzare il file a causa del suo tipo: non è una vera cartella di lavoro, è bloccato da un altro programma, è un segnaposto cloud, contiene byte non decodificabili. Il file viene archiviato automaticamente e il resto della cartella continua. Solo una cartella con zero file leggibili rifiuta l'intero set.
- Rifiutato
- L'agente non è riuscito a fissare alcun layout, ad esempio perché i file non concordano sul tipo di colonna. Non esiste ancora alcuna tabella dati.
file_eventiottiene unrifiutatoriga con il motivo indettaglioe l'agente riprova a ogni scansione finché non viene trovato un layout. Correggi o escludi il file indicato e il messaggio scomparirà.
Dove guardare: lo striscione ambra su Controllo (Mostra quali file e perché), del connettore Manifesto tab successivamente. In SQL: SELECT relative_path, event_type, detail FROM fileset.files_events WHERE event_type IN ('drift','refused') ORDER BY event_at DESC.
Usa i tavoli ovunque
Il connettore è un'origine dati come qualsiasi altra in Query Streams. Salva una query una volta nel Generatore di query (il dialetto è DuckDB) e utilizzalo da:
Excel
Il componente aggiuntivo Trasmetti una query trascina le righe in un foglio e le riesegue con un clic. Esecuzione di query SQL in Excel.
Fogli di Google
IL Streamer di query Il componente aggiuntivo riempie la scheda che selezioni. Power Query per Google Sheets.
Claude, Cursor e altri client di intelligenza artificiale
Tramite il server Query Streams MCP; Claude conosce il modello di cartella, incluso _source_file e file_eventi. Cartella CSV con Claude tramite MCP.
API REST
Ogni query salvata diventa un endpoint di sola lettura con una propria chiave, indipendentemente dal piano. API REST per cartelle CSV.
Nova
Chiedi in modo chiaro e semplice riguardo al piano Business; Nova conosce ogni cartella, tabella e colonna grazie alle sue descrizioni predefinite.
Automazioni
Sincronizza le righe con Airtable, Smartsheet, Baserow, SeaTable o un foglio di calcolo in base a una pianificazione. Guide all'automazione.
Le tabelle delle cartelle si uniscono anche agli altri connettori: una query federata può corrispondere _source_file nomi o ID ordine in una cartella di file CSV rispetto a un database sullo stesso agente.
Limiti che vale la pena conoscere
Non ci sono limiti di piano per quanto riguarda le cartelle o il numero di file. Le righe vengono conteggiate nel tuo Data Realm come qualsiasi altro connettore. È possibile aumentare o diminuire i valori predefiniti del connettore:
| Collocamento | Predefinito | Cosa fa |
|---|---|---|
| Profondità massima | 8 | Quanti livelli di cartella al di sotto di ciascuna radice vengono analizzati (1–64). |
| Numero massimo di file per scansione | 100,000 | I file vengono considerati in un'unica operazione. |
| Dimensione massima del file da sottoporre ad hashing | 32 MiB | Conta solo con Contenuto del file hash SU. |
| Conservazione dei registri eventi | 30 giorni | Per quanto file_eventi Le righe vengono mantenute. |
| Parallelismo di scansione per radice | 2 | Cartelle lette una sola volta per ogni directory principale. |
Limiti di contenuto, che parcheggiano un file anziché troncarlo: 2.000.000 di righe o 512 MiB per file, 10.000.000 di righe o 2 GiB per scansione. Una cartella può contenere al massimo 25 layout distinti in Un tavolo per ogni disposizione modalità.
Domande che le persone si pongono
I miei file sono stati caricati da qualche parte?
No. L'agente legge i file sul proprio computer e memorizza le righe in una cache locale crittografata. Una query viene eseguita su tale cache e solo le righe restituite lasciano la macchina, tramite un'unica connessione in uscita. I file non vengono mai modificati, spostati o convertiti.
Devo aprire una porta o usare una VPN?
No. L'agente effettua una connessione in uscita sulla porta 443 e sia le richieste che le righe transitano attraverso di essa. Se HTTPS in uscita funziona, anche questo funziona.
La cartella può trovarsi su una condivisione di rete, su OneDrive o su Dropbox?
Yes. Type a share as \\server\condiviso\cartella, 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 Tenere sempre acceso questo dispositivoL'agente non scarica i file disponibili solo nel cloud.
La cartella contiene più di un tipo di file. Un connettore o due?
Un connettore legge un solo tipo di file. Una cartella contenente file CSV e Parquet ha due connettori sulla stessa directory principale, uno per tipo. I file che non corrispondono al modello di inclusione vengono ignorati, non messi da parte.
È presente un pulsante per ripetere la scansione?
No. L'agente esegue la scansione su Intervallo di scansione, reagisce ai cambiamenti quando Cartella di monitoraggio è attivo e può eseguire una nuova scansione prima di rispondere a una query quando lo attivi. Modifica il connettore per cambiare una qualsiasi delle tre opzioni.
Il piano gratuito copre davvero tutto questo?
Sì. La versione gratuita è un piano che mantieni, non una versione di prova che scade. I connettori di cartella non hanno un limite di file proprio; le righe vengono conteggiate nel tuo Data Realm come qualsiasi altro connettore. Scopri cosa include ogni piano su pagina dei prezzi.
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