Logo della cartella JSONL

JSON delimitato da righe Nuovo

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

Interroga le cartelle dei log degli eventi JSONL/NDJSON come tabelle. I campi annidati vengono appiattiti in colonne reali su cui è possibile applicare filtri, senza che sia necessario scrivere prima un parser.

Un collegamento, ogni superficie

Dove possono essere inseriti i dati della cartella JSONL

Query Streams trasforma una cartella di log di eventi JSONL/NDJSON in tabelle SQL interattive leggibili da Microsoft Excel, Fogli Google, assistenti AI tramite MCP, API REST e Power BI. Gli oggetti annidati vengono appiattiti in colonne reali che è possibile inserire in una clausola WHERE e l'agente self-hosted legge ogni file per intero anziché campionarne solo l'inizio, in modo che un campo che compare solo nelle ultime cento righe venga comunque trovato. I log rimangono sul computer; 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 JSONL Sistema di file Cartella CSV Cartella Parquet Cartella Excel Cartella SQLite 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 JSONL a Excel Microsoft Excel · Componente aggiuntivo di Excel

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

    Come funziona Excel
  3. Cartella JSONL su Fogli Google Componente aggiuntivo Fogli

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

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

    Poni una domanda in un linguaggio semplice. Nova conosce già le tabelle della tua cartella JSONL, 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. Visualizzazione della cartella JSONL in Data Viewer Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    Condividi i risultati di una cartella JSONL 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 della cartella JSONL Endpoint dell'HT

    Pubblica una query di cartella JSONL 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. Cartella JSONL 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 JSONL tramite HTTPS, senza driver ODBC né porte di database aperte.

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

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

    Come funziona Airtable
  10. Cartella JSONL in riga di base Piattaforma di automazione

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

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

    Mantieni aggiornato un database SeaTable con i dati delle cartelle in formato JSONL senza esportare un file o esporre il database.

    Come funziona SeaTable
  12. Cartella JSONL in Smartsheet Piattaforma di automazione

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

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

    Eseguire il backup di un'applicazione Anvil Python con JSONL Folder tramite l'endpoint REST anziché incorporare le credenziali del database nell'applicazione.

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

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

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

    Imposta una query JSONL Folder su una pianificazione e fai in modo che le righe vengano recapitate a Slack, Discord, via email 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 contenente i log delle applicazioni, gli archivi dei webhook, le esportazioni degli eventi e un oggetto JSON per riga.

02

Punta il connettore verso di esso; ogni file .jsonl viene abbinato.

03

L'agente legge i file per intero anziché campionarne solo la parte superiore, quindi un campo che compare solo nelle ultime cento righe viene comunque trovato.

04

Gli oggetti annidati vengono appiattiti in colonne a due livelli di profondità per impostazione predefinita, fino a un massimo di otto. fulfillment.site.region diventa una colonna che puoi inserire in una clausola WHERE. Gli array e qualsiasi elemento annidato più in profondità rimangono in formato JSON e possono essere interrogati.

05

Ogni riga contiene una colonna _source_file, quindi il file di un giorno, o l'intero archivio, è accessibile con una sola query.

Analisi approfondita delle funzionalità

Cosa ti offre la cartella JSONL

Progettato per gestire dati di eventi disordinati.

  • I file vengono letti per intero, non campionati. — un campo raro non viene trascurato solo perché non è apparso in precedenza.
  • Le strutture più complesse vengono mantenute in formato JSON anziché essere eliminate, quindi nulla viene perso silenziosamente.
  • Un campo che inizia ad apparire in un secondo momento viene considerato una modifica e segnalato, non ignorato silenziosamente.
  • Se la cartella contiene forme di eventi effettivamente diverse, la modalità per layout assegna a ciascuna forma una tabella separata, fino a un massimo di 25.
-- Eventi al giorno, direttamente dalla cartella dei log SELECT _source_file AS day, status, COUNT(*) AS events FROM data GROUP BY day, status ORDER BY day

Rigoroso, una riga alla volta

Una singola riga non corretta blocca l'intero file anziché caricare una mezza verità, e il file viene identificato nella cartella files_events. Correggilo o escludilo e la successiva sincronizzazione lo rileverà: non ti ritroverai mai a dover riconciliare un totale a cui mancano silenziosamente tre righe.

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 JSONL 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 JSONL JSON delimitato da righe
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     registri eventi.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 JSONL

Cartella
Una o più cartelle radice contenenti file .jsonl, incluse le sottocartelle: log delle applicazioni, archivi webhook, esportazioni di eventi, un oggetto JSON per riga.
Schema
Leggere i file interi anziché un campione, in modo che un campo che appare solo in un log di grandi dimensioni venga comunque trovato
Nidificazione
Gli oggetti vengono appiattiti in colonne a due livelli di profondità per impostazione predefinita e fino a otto: fulfillment.site.region diventa una colonna su cui è possibile filtrare
Strutture più profonde
Gli array e qualsiasi elemento al di sotto della profondità di appiattimento rimangono interrogabili come JSON anziché essere eliminati.
Rigore
Una riga malformata blocca l'intero file invece di caricare una mezza verità e il file è denominato in files_events
Modalità per layout
Se la cartella contiene effettivamente diverse forme di eventi, ogni forma può ottenere la propria tabella — fino a 25
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 log sul posto.
dialetto SQL
DuckDB: SQL standard, non c'è nulla di specifico da imparare sui log.

In questa configurazione non è presente alcun server di database. L'agente legge i file .jsonl 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: un anno di file di log giornalieri non viene rianalizzato solo perché è stato caricato quello odierno. Nulla viene caricato su Query Streams; l'unica cosa che esce dalla rete è il risultato di una query.

La profondità di appiattimento fa parte dello schema bloccato, non è un'impostazione per singola query. Questa scelta è intenzionale: fulfillment.site.region deve corrispondere alla stessa colonna di lunedì come corrispondeva a venerdì, altrimenti ogni query salvata e ogni aggiornamento programmato modificano silenziosamente il significato a vostra insaputa. Aumentare la profondità in un secondo momento è una modifica dello schema e viene gestita e segnalata come tale.

Documentazione del fornitore: jsonlines.org

FAQ

Domande sulla cartella JSONL

Quali strumenti sono in grado di leggere i dati JSONL delle cartelle 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 JSONL?

Percorso di cartella visibile alla macchina agente: nessun server, nessuna credenziale, nessun driver da installare. Cartella: una o più directory radice contenenti file .jsonl, incluse le sottocartelle: log delle applicazioni, archivi webhook, esportazioni di eventi, un oggetto JSON per riga. Schema: letto da file interi anziché da un campione, in modo che un campo che appare solo in un log di grandi dimensioni venga comunque trovato. Annidamento: gli oggetti vengono appiattiti in colonne a due livelli di profondità per impostazione predefinita e fino a otto: fulfillment.site.region diventa una colonna su cui è possibile applicare un filtro. Strutture più profonde: gli array e qualsiasi elemento al di sotto della profondità di appiattimento rimangono interrogabili come JSON anziché essere eliminati.

È 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 JSONL 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 JSONL nella directory 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