file di fogli di calcolo

Trasforma CSV Folder in tabelle interrogabili.

Esegui una query su una cartella di file CSV come se fosse un'unica tabella. L'agente calcola automaticamente il delimitatore, la codifica e le colonne, mantenendo poi la struttura predefinita in modo che un'esportazione errata non possa alterare silenziosamente i dati.

Usa i risultati in Excel, Google Sheets, negli strumenti di IA e nelle tue app tramite l’API REST del database.

Ogni tipo di connettore è incluso nel piano Free. Inizia con 2 origini dati e 1 agente.

Cartella CSVFile letti direttamente nella loro posizione
All’interno della tua reteAgente di rete per i flussi di query

Leggi, organizza ed esegui query sulla tua macchina.

Query di sola lettura · connessione in uscita

I file sorgente restano al loro posto. I tuoi strumenti ricevono i risultati delle query.

Origine → agente → risultati consentiti

Query Streams trasforma una cartella di file CSV in una tabella SQL interattiva, leggibile da Microsoft Excel, Fogli Google, assistenti AI tramite MCP, API REST e Power BI. L'agente self-hosted campiona i file reali (delimitatore, carattere di virgoletta, riga di intestazione, codifica, formato data), ne memorizza lo schema e lo conserva: un file successivo che non corrisponde viene bloccato e identificato nella cartella files_events, senza mai essere caricato silenziosamente. I file rimangono sul computer dell'utente; solo i risultati delle query lasciano la rete.

  • Delimitatore e codifica rilevati automaticamente
  • Decimali esatti per le colonne di importi
  • I file non validi vengono messi da parte e identificati

Collega CSV Folder con le impostazioni corrette.

Mantieni la connessione sul Network Agent. Ecco i dettagli specifici di CSV Folder.

Cartella
Una o più radici: disco locale o condivisione di rete denominata \\server\share (mai una lettera di unità mappata; su Linux o Mac, montata per prima); sottocartelle incluse, pattern di inclusione ed esclusione supportati.
Schema
Campionamenti dai file reali alla prima sincronizzazione: delimitatore, carattere virgoletta, riga di intestazione, codifica, formati data, quindi bloccati
Codifiche
UTF-8, UTF-16, Windows-1252 e Latin-1, rilevati per file
Colonne di denaro
Una colonna che contiene sempre valori decimali viene memorizzata come DECIMAL esatto, mai in virgola mobile.
Limiti
Fino a 250.000 file, 16 livelli di cartelle, 512 MB per file: tutto regolabile.
Credenziali
Nessuno: non c'è alcun server; l'agente legge i file direttamente sul posto.
dialetto SQL
DuckDB: SQL standard, non c'è nulla di specifico da imparare riguardo alle cartelle.

In questa immagine non è presente alcun server di database. L'agente legge i file .csv nella posizione in cui si trovano già, memorizza nella cache le righe in un archivio DuckDB crittografato sulla stessa macchina e rilegge solo i file effettivamente modificati: una cartella di 50.000 file non viene rianalizzata solo perché è stata aggiunta una nuova esportazione. Nulla viene caricato su Query Streams; l'unica cosa che esce dalla rete è il risultato di una query.

Le esportazioni ricorrenti dello stesso report vengono memorizzate in un'unica tabella, e questa è l'impostazione predefinita. Se la cartella contiene effettivamente file CSV diversi (ad esempio, un elenco clienti accanto a un dump degli ordini), la modalità per layout assegna a ciascun layout distinto una tabella separata, fino a un massimo di 25.

Guida alla configurazione di CSV Folder

Progettato per il funzionamento di CSV Folder.

Da dove provengono le colonne

  • Campionamento, non supposizioni: l'agente esamina i file reali invece di fidarsi della prima riga del primo file.
  • Codifiche gestite: UTF-8, UTF-16, Windows-1252 e Latin-1, così i nomi accentati e le esportazioni europee non risultano illeggibili.
  • Gli importi restano importi: una colonna che contiene sempre decimali viene memorizzata come decimale esatto, non come numero in virgola mobile, così i totali non perdono neanche un centesimo.
  • Una colonna presente solo in alcuni file diventa una colonna vuota negli altri, anziché essere causa di un errore.
-- L'intera cartella come un'unica tabella, quindi per file SELECT _source_file, COUNT(*) AS rows, SUM(total) AS revenue FROM data GROUP BY _source_file ORDER BY revenue DESC

Quando un file non è d'accordo

Se i primissimi file si contraddicono a vicenda (ad esempio, utilizzando due delimitatori diversi o una colonna che contiene una data in un file e testo libero in un altro), il connettore si rifiuta di bloccare qualsiasi elemento e ti indica quali file e quali colonne non corrispondono. Non sceglierà silenziosamente un file vincente lasciandoti scoprire la discrepanza a fine mese.

  • Dopodiché, un file danneggiato viene bloccato anziché corrompere la tabella: un'intestazione modificata, una colonna aggiuntiva, un valore non valido o un'ultima riga troncata.
  • Le sue righe rimangono fuori e files_events registra esattamente quale file e quale colonna ne sono la causa.
  • Tutti gli altri file nella cartella vengono ancora caricati correttamente. Un'esportazione non riuscita non compromette mai il report.

Un tavolo, oppure uno per ogni disposizione.

Le esportazioni ricorrenti dello stesso report vengono raggruppate in un'unica tabella, e questa è l'impostazione predefinita. Se la cartella contiene effettivamente file CSV diversi (ad esempio, un elenco clienti accanto a un dump degli ordini), è necessario passare alla modalità per layout: in questo modo, ogni layout distinto avrà la propria tabella, fino a un massimo di 25.

Dalla connessione a risultati utili.

  1. Installa l'agente di rete in una posizione accessibile alla cartella: un'unità condivisa, una cartella di caricamento notturno o una cartella condivisa di reparto.
  2. Punta il connettore su di esso. Ogni file .csv viene abbinato, sottocartelle incluse, ed è possibile restringere la ricerca utilizzando dei pattern.
  3. Alla prima sincronizzazione, l'agente campiona i file reali e determina automaticamente il dialetto: delimitatore, carattere di virgoletta, riga di intestazione, codifica del testo e formati data. Il risultato diventa lo schema fisso della tabella.
  4. Ogni file CSV viene quindi letto rispetto a quello schema e inserito in un'unica tabella, dove ogni riga contiene una colonna _source_file che indica il nome del file di origine.
  5. Esegui una query. Tratta la cartella come un'unica tabella, raggruppa per file per confrontare i drop oppure filtra per singolo file, il tutto con il normale SQL.

Sfrutta i risultati di CSV Folder.

Un’unica connessione serve i tuoi fogli di calcolo, le tue app e i tuoi strumenti di IA. Concedi l’autorizzazione a eseguire una query salvata; i destinatari vedono i risultati autorizzati, mentre l’SQL e le credenziali di accesso all’origine restano nascosti.

Per il tuo team, i fornitori e i partner

Condividi i risultati di una cartella CSV in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia aggiungibile ai segnalibri che si riavvia automaticamente all'apertura, su telefono, tablet o computer. L'interlocutore visualizzerà i risultati, mai il codice SQL o i file.

Come funziona il visualizzatore di dati

Per app e sistemi

Pubblica una query di cartella CSV come endpoint JSON autenticato che qualsiasi applicazione può richiamare, con una specifica OpenAPI 3.1 e raccolte predefinite per Postman, Insomnia e Hoppscotch. Non viene aperta alcuna porta del database.

Esplora l’API REST

Esegui il backup di un'app Anvil Python con cartella CSV tramite l'endpoint REST anziché incorporare le credenziali del database nell'app.

Scopri Anvil

Per gli strumenti di intelligenza artificiale

Concedi all'assistente IA l'accesso in sola lettura alla cartella CSV contenente lo schema necessario per scrivere codice SQL corretto, senza fornire credenziali nella chat.

Esplora MCP

Consegnato alle persone

Unisci CSV Folder al resto dei tuoi dati.

Riunisci database, API aziendali, file e log in un’unica query di sola lettura. Ogni connettore supporta le query federate.

Indica le connessioni e le tabelle. Query Streams gestisce le query alle origini e combina i risultati.

Esplora le query federate
Esempio illustrativo di query tra origini
-- niente copiato, niente unito, niente programmato
SELEZIONARE   c.region, COUNT(*) AS ordini, SUM(i.amount_due) AS fatturati
DA     csv_drops.fileset.data1  f
CONGIUNGERE     pg_crm.clienti pubblici2 c ON c.id = f.customer_id
CONGIUNGERE     fatturazione.stripe.invoices3 i ON i.customer = c.stripe_id
GRUPPO PER c.regione
ORDINATO DA fatturata DESCRIZIONE;

Usa i nomi delle tue connessioni, schemi, tabelle e colonne.

Condiviso tra tutti i connettori della famiglia.

Ogni connettore di cartella ti dà anche

  • files_current — un inventario aggiornato in tempo reale: tutti i file visibili al connettore in questo momento, con percorso, dimensioni e data di modifica.
  • files_events — il registro di controllo: cosa è comparso, cosa è cambiato, cosa è scomparso e cosa è stato escluso, con il nome del file e il motivo.
  • directory e volumi — totali per cartella, cronologia della crescita giornaliera e spazio disponibile sull’unità.
  • Ad ogni sincronizzazione vengono riletti solo i file effettivamente modificati, quindi una cartella contenente 50.000 file non viene rianalizzata solo perché è stata aggiunta una nuova esportazione.

Buono a sapersi

  • Sola lettura, garantita — una singola istruzione per volta, solo SELECT e simili. I tuoi file non vengono mai scritti, spostati o rinominati.
  • Non viene caricato nulla: i dati vengono memorizzati nella cache, in forma crittografata, sul tuo computer accanto all’agente. Solo il risultato di una query esce dalla tua rete.
  • Impostazioni predefinite ragionevoli — fino a 250.000 file, 16 livelli di cartelle e 512 MB per file, tutti configurabili. Cestini, .git e node_modules vengono sempre ignorati.
  • Il dialetto SQL è DuckDB: lo stesso SQL che useresti con qualsiasi altro connettore.

Domande sulla cartella CSV

Dove posso usare i risultati delle query di CSV Folder?

Usa i risultati di CSV Folder in Excel, Google Sheets, nel Data Viewer, nelle tue app tramite il Database REST API e negli strumenti di IA tramite MCP o Nova. I risultati salvati alimentano anche le destinazioni di Automation supportate, i report e gli avvisi. La disponibilità delle destinazioni e i limiti dipendono dal tuo piano.

Devo aprire una porta in ingresso per CSV Folder?

No. Installa il Network Agent su un computer che può raggiungere CSV Folder. L'agente si connette in uscita a Query Streams; non è necessaria alcuna porta in ingresso né una VPN. L'origine dati deve comunque consentire al computer dell'agente di connettersi in base alle proprie regole di accesso.

I miei file CSV Folder vengono caricati?

Network Agent legge i file dove si trovano e conserva la propria cache sulla macchina con l'agente. I file sorgente non vengono caricati, spostati né riscritti. Solo i risultati delle query richiesti escono dalla rete tramite la connessione crittografata in uscita.

Cosa mi serve per connettermi a CSV Folder?

Cartella: una o più radici, su disco locale o su una condivisione di rete specificata come \\server\share (mai una lettera di unità mappata; su Linux o Mac, montata prima); sono incluse le sottocartelle e sono supportati i pattern di inclusione ed esclusione. Schema: campionato dai file effettivi alla prima sincronizzazione — delimitatore, carattere di virgolette, riga di intestazione, codifica, formati di data — e poi fissato. Codifiche: UTF-8, UTF-16, Windows-1252 e Latin-1, rilevate per ogni file. Colonne monetarie: una colonna che contiene sempre valori decimali viene archiviata come DECIMAL esatto, mai in virgola mobile.

Posso unire CSV Folder ad altre origini dati connesse?

Sì. Le query federate supportano ogni tipo di connettore, inclusi database, API aziendali, file e log. Indica le connessioni e le tabelle in un’unica query di sola lettura. Query Streams traduce, quando necessario, le parti relative alle origini e combina i risultati. Scopri come funzionano le query federate.

Porta CSV Folder nel luogo in cui si svolge il lavoro.

Inizia con Free: ogni tipo di connettore, 2 origini dati e 1 Network Agent. Aggiungi le quote previste dal piano man mano che crescono le tue esigenze.