Ottieni dati da un DuckDB file in Fogli di Google
Apri il tuo database DuckDB in Fogli Google e aggiornalo quando vuoi. Niente caricamenti di file CSV, niente Apps Script, niente copia-incolla. La prima volta ci vogliono circa dieci minuti, ed è incluso nel piano gratuito.
Quello che otterrai alla fine
Un foglio Google che mostra i risultati in tempo reale di una query SQL sul tuo file DuckDB, con un pulsante che visualizza le righe più recenti ogni volta che i dati cambiano. Ad esempio:
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | ID cliente | nome di battesimo | cognome | Paese | totale |
| 2 | 1042 | Maria | Alvarez | U.S.A. | 1,284.50 |
| 3 | 1043 | Daniel | Okafor | U.S.A. | 612.00 |
| 4 | 1047 | Priya | Nair | U.S.A. | 2,090.75 |
| 5 | 1051 | Tommaso | Berg | U.S.A. | 338.20 |
| 6 | 1056 | Lucia | Ferreira | U.S.A. | 1,455.00 |
| 7 | 1060 | Kenji | Sato | U.S.A. | 874.10 |
| 8 |
I database DuckDB sono file singoli, che di solito terminano con .duckdbGoogle Sheets non è in grado di aprirli e la soluzione più comune è esportare un file CSV e caricarlo nuovamente ogni volta che i dati cambiano. Query Streams evita questo problema: un piccolo programma di supporto legge il file nella posizione in cui si trova già, e un componente aggiuntivo di Google Sheets gli richiede le righe desiderate. I due programmi non devono necessariamente trovarsi sullo stesso computer. Il file può essere sul computer dell'ufficio e voi potete lavorare ovunque: con qualsiasi browser e su qualsiasi dispositivo.
Cosa ti servirà
Un account Query Streams
Il piano gratuito è sufficiente per questa guida. Registrati su my.querystreams.com.
L'agente sul computer che ha il file
Un piccolo programma che viene eseguito in background e legge il file quando Google Sheets lo richiede. Il passaggio 2 qui sotto mostra dove trovarlo.
Il tuo file DuckDB
Sapere dove si trova, ad esempio C:\Data\sales.duckdbSe il file si trova su OneDrive, Dropbox o Google Drive, assicurati che sia sincronizzato con questo computer.
Quale computer riceve l'agente? Quello in cui si trova il file. L'agente deve essere in grado di aprire il file direttamente, quindi va su quel computer e quel computer deve rimanere acceso. Google Sheets può essere ovunque: funziona nel tuo browser, quindi non viene installato assolutamente nulla nel luogo in cui leggi i dati.
Collegalo in cinque passaggi
-
Crea il tuo account
Vai a my.querystreams.com e iscriviti. Scegli il Gratuito Piano. Si tratta di un piano reale, non di una versione di prova, che include la connessione al file DuckDB e l'esecuzione di query da Fogli Google.
Installa l'agente sul computer che contiene il file



Accedi, apri Scaricamentoe installa l'agente per il tuo sistema sul computer in cui si trova il file. L'operazione richiede un minuto e da quel momento in poi si avvierà automaticamente.
Perché un piccolo programma invece di un driver? L'Agent è un'unica installazione per Windows, Mac o Linux (circa 85 MB su Windows, poco più di 100 MB su Mac e Linux) che funziona silenziosamente in background. Stabilisce una connessione in uscita crittografata con Query Streams, nello stesso modo di un browser, quindi non è necessario aprire porte del firewall né configurare una VPN. Il file rimane sul computer e i dati vengono trasmessi ovunque vi troviate, anche attraverso Internet se necessario. L'unico componente aggiuntivo di cui dovrete occuparvi è l'Agent stesso.
La pagina di download mostra La tua chiave di accesso. Incollalo nell'Agente quando richiesto e attendi che il badge venga letto Connesso ai flussi di queryQuesta è l'unica operazione che si esegue sull'agente stesso.
Se volete, potete trovare le guide complete: Finestre, Mac, Linux.
-
Puntalo al tuo file DuckDB
Torna al tuo browser, apri Agenti dati (Sotto Dati nel menu in alto). Il tuo agente è elencato lì. Fai clic Aggiungi connettore, scegliere DuckDBe compilare:
- Nome della società
- Un nome che riconoscerai in seguito, come ad esempio "Database delle vendite".
- Percorso file database
- Il percorso del file DuckDB (.duckdb o .db) sul computer dell'agente; utilizzare Sfoglia per selezionarlo.
Cliccare Verifica la connessioneQuando legge Collegato, clicca RisparmiareLa connessione raggiunge il tuo agente in pochi secondi.
Test fallito? Nella maggior parte dei casi, il percorso contiene un errore di battitura oppure il file si trova su un computer diverso da quello dell'agente. Apri la cartella, copia il percorso dalla barra degli indirizzi e incollalo nuovamente.
-
Aggiungere Query Streams a Fogli Google
Apri un qualsiasi foglio Google, vai a Estensioni → Componenti aggiuntivi → Ottieni componenti aggiuntivi, cerca Flussi di querye clicca InstallareOppure installalo direttamente da Query Streams sul Google Workspace MarketplaceGoogle ti chiederà di autorizzare l'installazione del componente aggiuntivo; è normale.
Successivamente è presente in ogni Foglio Google che apri: un'icona di Query Streams nel pannello laterale a destra, elencata anche sotto EstensioniNon è necessario effettuare un accesso separato. Il sistema riconosce l'account Google che già utilizzi, quindi l'indirizzo email deve essere lo stesso associato al tuo account Query Streams.
-
Porta il tuo primo tavolo
Fai clic sull'icona Query Streams nel pannello laterale a destra del foglio (oppure trovala sotto Estensioni). Scegliere Streamer di query e seleziona la connessione appena stabilita.
Digita la query che vuoi eseguire. Questa estrae alcune colonne da un ordini tavolo:
Esempio · SQLSELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;
Sotto Scheda di destinazione seleziona la scheda in cui devono finire le righe, quindi fai clic Eseguire la queryLe righe vengono visualizzate in quella scheda in uno o due secondi. Fai clic su "Esegui query" ogni volta che i dati sono cambiati e la scheda si aggiornerà automaticamente.
Non conosci SQL? Crea la query direttamente nel portale Query Streams. Generatore di query Mostra le tue tabelle e colonne in modo che tu possa puntare e cliccare. Con i piani Business puoi anche chiedere a Nova in linguaggio naturale ("mostrami i clienti negli Stati Uniti") e lei scriverà la query SQL per te. Salva la query e sarà disponibile con un clic nel portale e nell'elenco delle query salvate del componente aggiuntivo a partire dal piano Personal Core.
Questo è tutto. I tuoi dati sono presenti nel foglio di calcolo e rimangono aggiornati con un solo clic. Nulla ha lasciato la tua rete, a parte le righe che hai richiesto.
Buone mosse successive
- Salva la query nel portale, così puoi eseguirlo di nuovo con un solo clic, da Fogli Google o Excel.
- Aggiungi un filtro come ad esempio un intervallo di date, in modo che la stessa query possa rispondere "questo mese" senza modifiche.
- Condividi i risultati con un collega. Loro vedono le righe, non il tuo file e non il tuo percorso file.
Domande che le persone si pongono
Il file DuckDB deve trovarsi sul computer che utilizzo per Fogli Google?
No. Solo l'agente deve trovarsi nella stessa posizione del file DuckDB. Google Sheets funziona nel browser su qualsiasi dispositivo. Apri il componente aggiuntivo con lo stesso account Google e troverai le tue connessioni.
Il mio file del database viene caricato da qualche parte?
No. L'agente legge il file sul tuo computer e invia solo le righe richieste dalla tua query. Il file rimane dov'è.
Il file può essere archiviato su OneDrive, Dropbox o Google Drive?
Sì, a patto che sia sincronizzato con il computer su cui è in esecuzione l'Agent, in modo che quest'ultimo lo veda come un normale file locale. Imposta la connessione in modo che punti alla copia sincronizzata.
Il piano gratuito copre davvero tutto questo?
Sì. La versione gratuita è un piano che mantieni, non una prova che scade. Scopri esattamente cosa include su pagina dei prezzi.
Il foglio si aggiorna automaticamente?
Fai clic su "Esegui query" ogni volta che desideri visualizzare le righe più recenti. Per un foglio di calcolo che si aggiorni automaticamente a intervalli regolari senza alcun intervento umano, configura un'automazione nel portale Query Streams (Streams → Automazione). Questa opzione è disponibile in tutti i piani.
Guide correlate
Ogni guida per DuckDB
Non è proprio la tua configurazione?
- Hai una cartella di file Parquet anziché un file di database DuckDB? Parquet Folder li legge tutti come un'unica tabella → Parquet Folder

