DUCKDB
API REST
Trasforma una query DuckDB in una query sicura API REST — nessuna estensione httpserver, nessun servizio da ospitare.
DuckDB è un motore di analisi veloce, basato su file, senza processo server e senza autenticazione integrata. Salva una query SQL contro il tuo .duckdb file, conia una chiave API per destinatario e consegna a un partner un endpoint JSON attivo — no httpserver Estensione da esporre, nessun wrapper FastAPI da creare, nessun file di database da distribuire. Solo un'estensione governata e di sola lettura. API REST di DuckDB in minuti.
Chiedi a Nova, ottieni SQL + grafici
Incontrare Nova
Una chiave per ogni partner. Nessuna credenziale condivisa.
Creare un'API
+più
Sincronizzazione programmata con oltre 6 piattaforme
Esplorare
+più
Interrogare le API con SQL, senza codice
Esplorare
+più
Claude, Cursor, ChatGPT e Grok interagiscono con i tuoi dati
Connetti l'IAQuery Streams è una piattaforma di integrazione di database sicura e in tempo reale che trasforma qualsiasi query DuckDB salvata in un endpoint API REST pronto per i partner, con chiavi per destinatario, vincolo di sola lettura e tracciabilità completa delle modifiche. Ottieni una vita API REST di DuckDB senza eseguire un server, installando il httpserver estensione o spedizione del file del database. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente Pubblica il tuo primo endpoint DuckDB in pochi minuti.
Perché esporre un database DuckDB come API REST?
DuckDB è geniale proprio perché non ha un server: viene eseguito in-process, legge un singolo .duckdb file (o query Parquet, CSV e JSON sul posto) ed elabora carichi di lavoro analitici alla velocità di un column-store su un laptop o una cron box. Ma nel momento in cui qualcuno al di fuori del tuo team ha bisogno di quei numeri — un cliente vuole un feed in tempo reale, l'app di un partner deve leggere un rollup, un analista vuole l'aggregazione nella sua dashboard — quella forza del serverless diventa l'ostacolo. Non c'è una porta a cui connettersi e nessun login da distribuire. Le solite soluzioni alternative sono tutte dannose: invii un'e-mail al .duckdb file (ora una copia completa dei tuoi dati vive sul disco di qualcun altro), ti alzi dalla parte della comunità httpserver estensione o un wrapper FastAPI (ora possiedi un servizio HTTP, la sua autenticazione e il suo TLS), oppure pianifichi un'altra esportazione CSV. API REST di DuckDB Questa è la versione pulita: il partner riceve un URL e un token, non il tuo file. Query Streams crea una query salvata più una chiave.
Nessun server, nessuna porta aperta.
DuckDB non ha un listener di rete e non ne aggiungi uno. L'agente di rete legge il tuo .duckdb I file vengono archiviati localmente e le chiamate vengono effettuate in uscita; le chiamate in entrata viaggiano attraverso quella stessa connessione in uscita.
Chiavi API per destinatario
Ogni destinatario riceve il proprio qsapi_* Chiave. Revoca una senza toccare le altre: nessun file da recuperare, nessuna password da cambiare.
Sola lettura per impostazione predefinita
L'agente apre DuckDB in sola lettura e un validatore rifiuta qualsiasi istruzione non SELECT. Non c'è INSTALLARE, COPIA, o ALLEGARE percorso attraverso l'API.
Il tuo codice SQL e il tuo file rimangono privati
Il destinatario vede l'URL dell'endpoint, la risposta JSON e tutti i filtri che hai esposto, mai il tuo SQL, il tuo schema o il .duckdb file stesso.
Niente da ospitare o patchare
No httpserver Estensione da esporre, nessuna app FastAPI, nessun reverse proxy. L'endpoint viene eseguito come funzionalità gestita, quindi non è necessario gestire una pipeline di distribuzione o una rotazione TLS.
Permanente, in scadenza o autodistruttivo
Rendi un endpoint permanente, impostane la scadenza in una data specifica oppure assegnagli un budget di chiamate fisso che lo autodistrugge dopo un determinato numero di richieste.
I metodi usuali per implementare un'API REST su DuckDB e perché sono problematici
Esistono diverse opzioni concrete, ognuna con la sua utilità. Il punto cruciale è che ognuna di esse implica la gestione dell'infrastruttura, la cessione di una copia completa dei dati o entrambe le cose. Ecco un confronto tra gli approcci più comuni e un endpoint condiviso di Query Streams, quando l'obiettivo è semplicemente "consentire a un partner specifico di leggere un set di risultati specifico".
| Preoccupazione | Estensione httpserver (autogestita) | API veloce fai da te + duckdb | Invia il file .duckdb | Flussi di query |
|---|---|---|---|---|
| Esposizione alla rete | Si esegue e si espone un server HTTP | Tu ospiti un servizio | Nessuno — ma i dati sfuggono al tuo controllo | Agente solo in uscita — nessuna porta in entrata |
| Ciò che il destinatario tiene | Un URL che esegue SQL arbitrario per impostazione predefinita | Un URL nel tuo servizio | Una copia completa dell'intero database | Una chiave monouso per una singola query |
| Esposizione dei dati/schemi | Intero database, tutte le tabelle | Qualunque cosa tu codifichi manualmente | Tutto, per sempre | Una sola query salvata, nient'altro. |
| Chiavi per destinatario + revoca | Non integrato | Costruiscilo tu stesso | Impossibile una volta condiviso | Costruito |
| Registro di controllo di ogni chiamata | Aggiungilo tu stesso | Aggiungilo tu stesso | Nessuna visibilità. | Costruito |
| Gestisci / patch / ruoti TLS | Sì, per sempre | Sì, per sempre | Niente da correre | Gestito per te |
| I dati rimangono in tempo reale | Sì | Sì | Inattivo nel momento in cui lo invii | In diretta su ogni chiamata |
Desideri utilizzare DuckDB tramite HTTP senza l'estensione httpserver?
La comunità httpserver L'estensione è ottima per avviare un endpoint di query ad hoc su una macchina sotto il tuo controllo. Tuttavia, esegue SQL arbitrario e non prevede chiavi per destinatario, quote o traccia di controllo, quindi non è una soluzione adatta a un partner. Se il tuo obiettivo è fornire a un partner specifico un set di risultati governato e di sola lettura con una chiave dedicata, senza la necessità di eseguire alcun server, Query Streams colma esattamente questa lacuna.
Come Query Streams trasforma una query DuckDB in un'API REST
Una volta installato l'agente di rete accanto al file DuckDB e configurato il connettore, la promozione di una query salvata a un endpoint REST condiviso richiede circa tre passaggi. Se utilizzi già Query Streams per Excel, Fogli Google o il server MCP, l'agente e il connettore sono già presenti: puoi iniziare dal secondo passaggio.
Punta l'agente al tuo file DuckDB
Installa l'agente di rete sulla macchina che contiene il tuo .duckdb Apri il file e aggiungi un connettore DuckDB. L'agente apre il file in sola lettura e stabilisce una connessione TLS in uscita verso Query Streams: nulla viene esposto a Internet.
Salva una query SQL
Scrivi il SELEZIONARE Nel Query Builder, puoi utilizzare la tua connessione DuckDB per aggregazioni, funzioni finestra e letture da file Parquet, CSV o JSON allegati. Assegna un nome e salva.
Promuovilo e condividi una chiave
Apri la scheda Installa, scegli il tipo di endpoint (permanente, in scadenza o con budget di chiamate) e il formato di output, quindi invita un destinatario tramite e-mail. Riceveranno una richiesta di link magico e il proprio qsapi_* chiave.
Una query salvata, molte superfici
La stessa query DuckDB salvata può guidare un aggiornamento di Excel, una barra laterale di Fogli Google, una conversazione di Claude o Cursor attraverso il Server MCP, e un endpoint REST rivolto ai partner allo stesso tempo. La query viene creata una sola volta; Query Streams gestisce le interfacce.
Nessun server da avviare, nessun file da consegnare.
Il modello di sicurezza è il motivo per cui i team scelgono questo invece del httpserver estensione o un file condiviso. Il tuo file DuckDB non lascia mai la tua macchina e il percorso ad esso risiede solo all'interno della configurazione dell'Agente sulla tua rete: non viene mai trasmesso al nostro cloud e non è mai visibile a un destinatario. DuckDB stesso viene aperto in modalità di sola lettura e un validatore sulla tua rete rifiuta qualsiasi istruzione non SELECT con VIOLAZIONE DI SOLA LETTURA prima che possa essere eseguito.
Oltre all'applicazione delle restrizioni di sola lettura, lo stesso agente abilitato solo per le connessioni in uscita (HTTPS sulla porta 443, senza porte in entrata o VPN) supporta i controlli per destinatario di ogni endpoint: liste di indirizzi IP e CORS consentiti, limiti di velocità a due livelli e quote di byte opzionali che è possibile restringere prima della condivisione. Come funzionano la connessione solo in uscita e le protezioni per singolo destinatario →
Chiama la tua API REST di DuckDB
I destinatari chiamano l'endpoint come qualsiasi altra API REST: un token bearer e un URL. Qualsiasi parametro di query salvata esposto può essere impostato per chiamata — sulla stringa di query per OTTENERE o in un corpo JSON per INVIAREL'agente associa tali valori come parametri di istruzioni preparate appropriati, mai come concatenazione di stringhe, in modo che un destinatario non possa uscire da un filtro per iniettare codice SQL.
Seleziona il formato di output per chiamata con il Accettare intestazione (o un ?format= parametro di query): JSON per un singolo array, CSV per fogli di calcolo e pandas, oppure, su un endpoint di streaming, NDJSON (una riga JSON per riga) per pipeline di analisi in tempo reale: utile per i grandi set di risultati analitici che DuckDB è progettato per produrre. Per i consumatori sensibili alla larghezza di banda, optare per LZ4 compressione del carico utile con Accept-Encoding: lz4; anche le risposte non compresse ottengono lo standard gzip sul filo automaticamente. Per la ripartizione completa delle modalità statica vs streaming, delle quattro combinazioni di fili e della generazione OpenAPI 3.1, vedere il API REST istantanea per database SQL guida.
Modalità di fatturazione dell'utilizzo
La piattaforma API fa parte di ogni piano Query Streams, senza abbonamento separato, ed è un Accept-Encoding: lz4 chiamate bollette sui byte compressi che sono stati effettivamente trasferiti. Come viene misurato l'utilizzo della piattaforma API →
Integralo in Power BI, Tableau e in qualsiasi programma che legga file JSON.
DuckDB è un motore di analisi, quindi la maggior parte delle volte i suoi risultati sono destinati a una dashboard. Poiché ogni endpoint restituisce standard JSON — grazie alla disponibilità di CSV e NDJSON in streaming — qualsiasi strumento in grado di leggere un feed REST può utilizzare direttamente i dati di DuckDB, senza bisogno di installare nulla. Power Query è il ponte più semplice per entrare nello stack di Business Intelligence di Microsoft: in Power BI scegliere Ottieni dati → Dal Web, incolla l'URL dell'endpoint, aggiungi il tuo Autorizzazione intestazione e Power Query analizza il JSON in una tabella aggiornabile che alimenta il modello di dati. (Per i dati in tempo reale all'interno di un foglio di calcolo, il nativo Componente aggiuntivo Query Streams per Excel è la strada più semplice: Power Query è disponibile quando si desidera accedere ai dati direttamente nel modello di Power BI.
Power Query
Ottieni dati → Dal Web, incolla l'URL e il token bearer, espandi il JSON in una tabella aggiornabile
Power BI
Stesso motore Power Query: carica l'endpoint direttamente nel tuo modello e pianifica l'aggiornamento.
Tableau
Punta un connettore dati Web o un'origine JSON all'endpoint per dashboard in tempo reale
Postino
Importa le specifiche OpenAPI 3.1, quindi invia, analizza e condividi le richieste con un solo clic.
Si nutre anche n8n, Qlik, arricciare, Python (richieste o pandas.read_json), Insomnia, Hoppscotch — o qualsiasi script o flusso di lavoro in grado di inviare una richiesta HTTP e leggere JSON.
Funziona con file locali e condivisioni di rete.
L'agente di rete si connette allo stesso modo a un locale .duckdb È possibile eseguire query su file, file di database su una condivisione di rete o su un'istanza DuckDB in memoria, ed è in grado di gestire qualsiasi query, incluse quelle che leggono file Parquet, CSV o JSON accessibili dall'istanza DuckDB. Per ridurre al minimo la latenza, è consigliabile eseguire l'agente sulla stessa macchina o nelle sue vicinanze. Un singolo account Query Streams può eseguire più agenti su macchine e siti diversi, e un singolo endpoint si comporta in modo identico indipendentemente dall'agente che lo gestisce.
Più di DuckDB
Lo stesso flusso di lavoro promuove una query salvata da PostgreSQL, Microsoft SQL Server, MySQL, MariaDB, SQLite, Microsoft Access, Snowflake, Oracle o BigQuery a un endpoint REST. DuckDB è semplicemente uno dei punti di partenza in più rapida crescita. Esplora il Guide all'installazione dei connettori per l'elenco attuale.
Domande frequenti
Devo avviare un server o installare l'estensione httpserver? +
.duckdb file di sola lettura sulla tua macchina e stabilisce una connessione TLS in uscita verso agent.querystreams.com sulla porta 443. Non c'è httpserver Estensione da installare, nessuna porta da aprire e nessuna regola firewall in entrata da aggiungere.Il destinatario può visualizzare il mio codice SQL o scaricare il mio file .duckdb? +
.duckdb Il file non lascia mai il tuo computer: a differenza dell'invio di un file tramite e-mail, nessuna copia dei tuoi dati viene mai memorizzata sul disco del destinatario.In che cosa si differenzia dall'estensione httpserver di DuckDB? +
httpserver L'estensione trasforma una macchina sotto il tuo controllo in un endpoint HTTP che esegue query SQL arbitrarie: ottima per un accesso interno rapido, ma non prevede chiavi per destinatario, quote, tracciabilità delle operazioni e devi gestirla e proteggerla autonomamente. Query Streams adotta un approccio opposto, più mirato, per la condivisione in uscita: una query salvata diventa un endpoint, ogni destinatario ottiene la propria chiave revocabile, ogni chiamata viene registrata e non è necessario implementare o applicare alcuna patch.Quali formati di output può restituire l'API? +
Accettare intestazione o un ?format= parametro. le quattro combinazioni di fili e la compressione LZ4 →La query è in grado di leggere file Parquet, CSV o JSON tramite DuckDB? +
SELEZIONARE DuckDB può leggere un endpoint da una tabella nativa, un file Parquet o CSV allegato, un documento JSON o una vista che combina più elementi. Il destinatario visualizza solo il risultato JSON, senza sapere se proviene da una tabella o da un file.Un endpoint può scadere o autodistruggersi? +
Dove deve essere eseguito l'agente per DuckDB? +
.duckdb file o uno con accesso alla condivisione di rete su cui risiede. Per la latenza più bassa, eseguilo il più vicino possibile ai dati. Un account Query Streams può eseguire più agenti su macchine e siti diversi, e ognuno di essi può servire lo stesso endpoint.Il destinatario necessita di un account Query Streams? +
Iniziare
Pubblica gratuitamente la tua prima API REST di DuckDB.
Registrati, installa l'agente di rete accanto al tuo file DuckDB, salva una query SQL e invia via email al destinatario una richiesta di accesso tramite link magico. Chiavi per singolo destinatario, accesso in sola lettura e tracciabilità completa delle modifiche sono disponibili fin dalla prima chiamata.
Guide correlate: API REST istantanea per database SQL | Esporre PostgreSQL come API REST | Piattaforma API REST per database | Guide all'installazione dei connettori
Categoria: Piattaforma API
Tag: duckdb-rest-api, duckdb, duckdb-server, duckdb-api, rest-api, Exposisci-duckdb-come-api, httpserver-alternative, condividi-dati-duckdb, chiavi-per-destinatario, no-code-api, database-rest-api
Meta Description: Trasforma una query DuckDB in un'API REST sicura e di sola lettura con chiavi per destinatario: nessuna estensione httpserver, nessun server, nessun codice.
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish