Logo della cartella CSV

file di fogli di calcolo Nuovo

Interrogare una Cartella CSV con SQL — in Excel, Fogli Google, IA e REST

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.

Un collegamento, ogni superficie

Dove possono essere archiviati i dati della cartella CSV

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.

Uno dei 9 driver del set di file su un motore di cartelle: le tabelle di inventario, la traccia delle modifiche e le regole di rifiuto sotto Funzionalità sono condivisi dalla famiglia Cartella CSV Sistema di file Cartella Parquet Cartella Excel Cartella SQLite Cartella JSONL File CSV multi-record Registri delle macchine Registri del server web

  1. Per il tuo team, i fornitori e i partner
  2. Conversione da cartella CSV a Excel Microsoft Excel · Componente aggiuntivo di Excel

    Importa i risultati di una cartella CSV in tempo reale direttamente in un foglio di lavoro e aggiornali su richiesta: Excel per desktop, Excel Online, Microsoft 365.

    Come funziona Excel
  3. Conversione di una cartella CSV in Fogli Google Componente aggiuntivo Fogli

    Esegui una query da una cartella CSV salvata dalla barra laterale e trascina le righe nel foglio. I collaboratori che condividono il file possono aggiornarlo autonomamente.

    Come funziona Google Sheets
  4. Chiedi a Nova informazioni sulla cartella CSV Nova AI · conversione da testo a SQL

    Poni una domanda in un linguaggio semplice. Nova conosce già le tabelle della tua cartella CSV, scrive ed esegue la query SQL, spiega la risposta e la rappresenta graficamente: non è necessario scrivere alcuna query né fornire credenziali.

    Come funziona la rosa
  5. Cartella CSV in visualizzatore di dati Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    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
  6. Per app e sistemi
  7. API REST per cartelle CSV Endpoint dell'HT

    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.

    Come funziona un'API REST
  8. Conversione di una cartella CSV in Power BI Power Query M

    Incolla la query Power Query M generata nell'editor avanzato di Power BI e il report leggerà i risultati in tempo reale dalla cartella CSV tramite HTTPS, senza driver ODBC né porte di database aperte.

    Come funziona Power BI
  9. Cartella CSV in Airtable Piattaforma di automazione

    Sincronizza le righe di una cartella CSV con una base Airtable a intervalli regolari, oppure recuperale tramite uno script di automazione di Airtable.

    Come funziona Airtable
  10. Cartella CSV nella riga di base Piattaforma di automazione

    Alimenta una tabella Baserow da una cartella CSV tramite l'endpoint REST, sia in locale che nel cloud di Baserow.

    Come funziona Baserow
  11. Cartella CSV in SeaTable Piattaforma di automazione

    Mantieni aggiornato il database di SeaTable con i dati delle cartelle CSV senza esportare un file o esporre il database stesso.

    Come funziona SeaTable
  12. Conversione di una cartella CSV in Smartsheet Piattaforma di automazione

    Trasferisci i risultati della cartella CSV in una griglia di Smartsheet in modo che piani e report leggano dal sistema di origine e non dall'esportazione della settimana precedente.

    Come funziona Smartsheet
  13. Cartella CSV in Anvil Anvil Works · Piattaforma per app

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

    Come funziona Anvil
  14. Per gli strumenti di intelligenza artificiale
  15. Cartella CSV Server MCP Clienti di Claude, Cursor e MCP

    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.

    Come funziona MCP
  16. Consegnato alle persone
  17. Avvisi e report relativi alle cartelle CSV Slack · Discord · Email · Webhook

    Imposta una query per una cartella CSV in modo che venga eseguita una pianificazione e le righe vengano inviate a Slack, Discord, via e-mail o tramite un webhook firmato, oppure trattieni il messaggio finché il numero di righe, una soglia o una variazione percentuale non superano il valore da te impostato.

    Come funzionano gli avvisi e i report

Come funziona

5 passaggi, nessuna modifica al firewall in entrata

01

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.

02

Punta il connettore su di esso. Ogni file .csv viene abbinato, sottocartelle incluse, ed è possibile restringere la ricerca utilizzando dei pattern.

03

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.

04

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.

05

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.

Analisi approfondita delle funzionalità

Cosa ti offre la cartella CSV

Da dove provengono le colonne

  • Campionamenti, non presupposti — l'agente ispeziona i file reali invece di fidarsi della prima riga del primo file.
  • Codifiche gestite — UTF-8, UTF-16, Windows-1252 e Latin-1, in modo che i nomi accentati e le esportazioni europee non vengano visualizzati come testo illeggibile.
  • Il denaro resta denaro — una colonna che contiene sempre numeri decimali viene memorizzata come un numero decimale esatto, non come un numero a virgola mobile, in modo che i totali non varino di 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.

Condiviso da tutta la famiglia del set di file

Ogni connettore di cartella ti dà anche

  • file_correnti — un inventario in tempo reale: ogni file che il connettore può visualizzare in questo momento, con il relativo percorso, dimensione e data di modifica.
  • file_eventi — la traccia di controllo: cosa è apparso, cosa è cambiato, cosa è scomparso e qualsiasi elemento omesso, con il nome del file e la motivazione.
  • elenchi e volumi — totali per cartella, cronologia della crescita giornaliera e spazio rimanente sul disco.
  • 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, forzata — un'istruzione alla volta, solo SELECT e simili. I tuoi file non vengono mai scritti, spostati o rinominati.
  • Non è stato caricato nulla. — i dati vengono memorizzati nella cache, crittografati, sul tuo computer, accanto all'agente. Solo il risultato di una query esce dalla tua rete.
  • Impostazioni predefinite sensate — fino a 250.000 file, 16 cartelle di profondità, 512 MB per file, tutto personalizzabile. Cestino, .git e node_modules vengono sempre ignorati.
  • Il dialetto SQL è DuckDB — lo stesso codice SQL che scriveresti per qualsiasi altro connettore.

SQL tra sorgenti diverse

Unisci la cartella CSV al resto dei tuoi dati

Una cartella di file è un insieme di tabelle SQL come qualsiasi altra, quindi una singola istruzione può unirla contemporaneamente a un database e a un'API. Ogni sorgente esegue solo la parte di cui è capace, restituisce il risultato e l'unione avviene centralmente: le sorgenti non comunicano mai tra loro e nulla viene copiato da nessuna parte.

3 connessioni · 3 agenti

Cartella CSV file di fogli di calcolo
PostgreSQL Motore relazionale
Striscia Pagamenti e fatturazione

Una dichiarazione

-- 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;

Le tre parti sono connessione, schema e tabella, e il nome della connessione è quello che le hai assegnato. Le colonne sono a scopo illustrativo; le tue tabelle saranno le tue tabelle. La modalità di sola lettura si applica a ogni elemento: solo SELECT, WITH ed EXPLAIN, con un limite massimo alla quantità di dati che una singola fonte può fornire per una singola query. Come funzionano le query federate

Dettagli di connessione

Cosa serve alla cartella CSV

Cartella
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); subfolders included, include and exclude patterns supported
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.

FAQ

Domande sulla cartella CSV

Quali strumenti sono in grado di leggere i dati di una cartella CSV tramite Query Streams?

Tutto questo, da un'unica connessione: Excel, Fogli Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, avvisi e report programmati. Collega la cartella una sola volta e ogni strumento leggerà la stessa connessione di sola lettura: non è necessaria alcuna configurazione per ogni strumento e non ci sono seconde copie dei dati.

I miei file vengono caricati su Query Streams?

No. L'agente di rete legge i file direttamente nella posizione corrente e memorizza le righe nella cache in un archivio crittografato sulla stessa macchina. I file stessi non lasciano mai la rete: solo le righe risultanti da una query lo fanno, tramite un'unica connessione crittografata in uscita, senza porte firewall in entrata.

Query Streams può modificare, spostare o rinominare i miei file?

No. I file vengono aperti rigorosamente in sola lettura e non vengono mai scritti, spostati o rinominati. Le query sono forzatamente in sola lettura al momento dell'esecuzione: un'istruzione alla volta, solo SELECT e simili.

Di cosa ha bisogno Query Streams per connettersi alla cartella CSV?

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); subfolders included, include and exclude patterns supported. Schema: Sampled from the real files on first sync — delimiter, quote character, header row, encoding, date formats — then pinned. Encodings: UTF-8, UTF-16, Windows-1252 and Latin-1, detected per file. Money columns: A column that always holds decimals is stored as exact DECIMAL, never floating point.

È possibile unire una cartella di file a un database nella stessa query?

Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento contemporaneamente alla cartella CSV e alle altre connessioni, come indicato in `connection.schema.table`. Ogni origine esegue solo la parte di cui è competente e restituisce il risultato; l'unione avviene centralmente, quindi le origini non si connettono mai tra loro e nulla viene copiato o pianificato. La modalità di sola lettura si applica a ogni parte (solo SELECT, WITH ed EXPLAIN) e esiste un limite massimo alla quantità di dati che una singola origine può cedere per una singola query. Le query federate sono una funzionalità del piano; la pagina delle query federate riporta i limiti attuali relativi alle origini e alle dimensioni.

Posiziona la cartella CSV nella posizione in cui viene eseguito il lavoro

Installa l'agente, configuralo in modo che punti alla cartella desiderata e seleziona una destinazione.

Sola lettura Solo in uscita Le credenziali rimangono sull'agente