Logo della cartella Parquet

File a colonne Nuovo

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

Interroga una cartella di file Parquet come se fosse un'unica tabella. Parquet ha i propri tipi di colonna, quindi non viene fatto alcun tentativo di indovinare nulla: un decimale rimane un decimale e un timestamp rimane un timestamp.

Inizia gratis 13 destinazioni Guida alla cartella Parquet

Un collegamento, ogni superficie

Dove possono essere archiviati i dati della cartella Parquet

Cartella Parquet molti file → un tavolo live ciascuno
Query federate + qualsiasi altro connettore · un SQL da tutte le fonti · ogni piano
Agente di rete
  • 1 connessioni in uscita
  • 0 porti in entrata
  • sola lettura · i file rimangono al loro posto

funziona

Query Streams trasforma una cartella di file Parquet in un'unica tabella SQL interattiva, leggibile da Microsoft Excel, Fogli Google, assistenti AI tramite MCP, API REST e Power BI. Parquet ha i propri tipi di colonna, quindi l'agente self-hosted legge lo schema dal piè di pagina di ciascun file anziché campionare le righe: un decimale rimane un decimale, un timestamp rimane un timestamp e non sono possibili errori di campionamento. I file rimangono sul tuo 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 Parquet Sistema di file Cartella CSV 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. Cartella Parquet in Excel Microsoft Excel · Componente aggiuntivo di Excel

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

    Come funziona Excel

  3. Conversione della cartella Parquet in Fogli Google Componente aggiuntivo Fogli

    Esegui una query salvata dalla cartella Parquet 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 su Parquet Scena Nova AI · conversione da testo a SQL

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

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

    Pubblica una query per la cartella Parquet come endpoint JSON autenticato, accessibile a qualsiasi applicazione, con specifiche 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 Parquet 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 Parquet tramite HTTPS, senza driver ODBC né porte di database aperte.

    Come funziona Power BI

  9. Cartella Parquet in Airtable Piattaforma di automazione

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

    Come funziona Airtable

  10. Cartella Parquet alla riga di base Piattaforma di automazione

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

    Come funziona Baserow

  11. Cartella Parquet per SeaTable Piattaforma di automazione

    Mantieni aggiornata la base di SeaTable con i dati delle cartelle Parquet senza esportare un file o esporre il database.

    Come funziona SeaTable

  12. Cartella Parquet in Smartsheet Piattaforma di automazione

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

    Come funziona Smartsheet

  13. Cartella Parquet su incudine Anvil Works · Piattaforma per app

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

    Come funziona Anvil
  14. Per gli strumenti di intelligenza artificiale

  15. Server MCP della cartella Parquet Clienti di Claude, Cursor e MCP

    Concedi a un assistente IA l'accesso in sola lettura alla cartella Parquet 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 relativi alla cartella Parquet Slack · Discord · Email · Webhook

    Imposta una query per la cartella Parquet in modo che venga eseguita una query 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, ad esempio una directory di esportazione, un piccolo data lake o una cartella di destinazione del fornitore.

02

Punta il connettore alla cartella o all'intera struttura di directory; ogni file .parquet viene abbinato.

03

Parquet memorizza il suo schema all'interno di ciascun file, quindi l'agente legge tali descrizioni anziché campionare le righe. Nessun tipo viene dedotto dal testo e non è possibile alcun errore di campionamento.

04

I file vengono caricati in un'unica tabella, impilati, con una colonna _source_file in ogni riga che indica il nome del file.

05

Esegui una query con la stessa query SQL dei tuoi database e uniscila a questi ultimi nella stessa istruzione.

Analisi approfondita delle funzionalità

Cosa ti offre la cartella Parquet

Perché questa è esatta

  • I tipi provengono dal file stesso — i numeri decimali, i timestamp e gli interi arrivano così come sono.
  • Unione di colonne — se alcuni file contengono una colonna che manca agli altri, per quei file la colonna viene semplicemente letta come vuota anziché interrompere l'insieme.
  • Se due file differiscono effettivamente sul tipo di una colonna, il connettore si rifiuta di bloccarli anziché convertirli entrambi in testo. Viene indicato quale file e quale colonna presentano questo problema.
-- Righe e ricavi per file di esportazione SELECT _source_file, COUNT(*) AS righe, SUM(importo) AS totale FROM dati GROUP BY _source_file

Dopo la prima sincronizzazione

Un file successivo che aggiunge una colonna, ne elimina una bloccata o ne modifica il tipo viene trattenuto e registrato in files_events con il suo nome. Il resto della cartella continua a essere caricato, quindi un'esportazione non corretta non mette mai la tabella offline. La lettura è economica: vengono riletti solo i file effettivamente modificati.

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 Parquet 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 Parquet File a colonne
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     parquet_lake.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

Di cosa ha bisogno la cartella Parquet

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); every .parquet file is matched, subfolders included
Schema
Leggere dal piè di pagina Parquet di ciascun file: nessun campionamento, nessuna inferenza, nessun tipo ricavato dal testo.
Unione di colonne
Una colonna presente solo in alcuni file viene letta come vuota negli altri anziché interrompere l'insieme
Conflitti di tipo
Se due file differiscono effettivamente sul tipo di una colonna, il connettore si rifiuta di bloccarla e assegna un nome al file e alla colonna, invece di convertirli entrambi in testo.
Tavoli
Una tabella, ogni file impilato al suo interno, ogni riga contenente una colonna _source_file che nomina il suo file
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 .parquet 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.

Parquet è l'unico formato di questa famiglia in cui non è necessario dedurre nulla. Tutti gli altri connettori di cartella determinano il contenuto di una colonna analizzando i valori; Parquet lo sa già, quindi l'agente legge la descrizione anziché i dati. Questo rende la configurazione economica anche con cartelle molto grandi (vengono esaminati solo i piè di pagina) ed elimina completamente il problema per cui una colonna sembra numerica per le prime mille righe e poi si rivela non esserlo.

Documentazione del fornitore: parquet.apache.org

FAQ

Domande sulla cartella Parquet

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

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); every .parquet file is matched, subfolders included. Schema: Read from each file's own Parquet footer — no sampling, no inference, no type worked out from text. Column union: A column only some files carry reads as empty in the others rather than breaking the set. Type conflicts: If two files genuinely disagree on a column's type the connector refuses to pin and names the file and the column, instead of flattening both to text.

È 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 alla cartella Parquet e alle altre connessioni contemporaneamente, 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.

Metti la cartella Parquet dove si lavora

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

Inizia gratis Tutti i connettori

Sola lettura Solo in uscita Le credenziali rimangono sull'agente