PostgreSQL senza server parla PostgreSQL
Collegare Koyeb per Excel, Fogli Google, IA e REST
Koyeb serverless Postgres su .pg.koyeb.app. La scheda individua l'errore che tutti commettono: incollare il nome host dell'applicazione invece di quello del database.
Un collegamento, ogni superficie
Dove possono andare i tuoi dati Koyeb
- 1 connessioni in uscita
- 0 porti in entrata
- sola lettura · le credenziali rimangono memorizzate
funziona
- Per il tuo team, i fornitori e i partner
-
Excel componente aggiuntivo · aggiorna su richiesta
-
Fogli di Google componente aggiuntivo · aggiornamento su richiesta
-
Nova AI chiedere in linguaggio semplice · testo in SQL
-
Visualizzatore di dati Condividi i risultati in tempo reale · Team, fornitori, partner · Qualsiasi dispositivo
- Per app e sistemi
-
API REST Endpoint JSON · OpenAPI 3.1
-
Power BI Power Query M
-
Sincronizzazioni programmate Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- Per gli strumenti di intelligenza artificiale
-
Assistenti basati sull'intelligenza artificiale Claude · Cursor · Server MCP
- Consegnato alle persone
-
Avvisi e segnalazioni Slack · Discord · Email · Webhook
Query Streams legge i dati da Koyeb Postgres provenienti da Microsoft Excel, Fogli Google, Power BI, assistenti AI tramite MCP e un endpoint REST attraverso un'unica connessione di sola lettura. Koyeb ospita app e database su hostname adiacenti, e solo uno di essi è un database: le app si trovano all'indirizzo .koyeb.app e Postgres all'indirizzo .pg.koyeb.app. La confusione tra i due hostname è la causa più comune di errore di questa connessione, pertanto la scheda verifica questa eventualità e la segnala in modo chiaro, anziché lasciare che l'errore venga gestito tramite timeout.
Koyeb è PostgreSQL in rete — il driver standard, quindi ogni guida seguente si applica senza modifiche. L'unica parte specifica di Koyeb è la stringa di connessione, trattata sotto dettagli di connessione.
- Per il tuo team, i fornitori e i partner
-
Koyeb to Excel Microsoft Excel · Componente aggiuntivo di Excel
Importa i risultati di Koyeb in tempo reale direttamente in un foglio di lavoro e aggiornali a piacimento: Excel per desktop, Excel Online, Microsoft 365.
Guida a PostgreSQL -
Koyeb a Fogli Google Componente aggiuntivo Fogli
Esegui una query Koyeb salvata dalla barra laterale e trascina le righe nel foglio. I collaboratori che condividono il foglio possono aggiornarlo autonomamente.
Guida a PostgreSQL -
Chiedi a Nova informazioni su Koyeb. Nova AI · conversione da testo a SQL
Poni una domanda in un linguaggio semplice. Nova conosce già le tue tabelle Koyeb, 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 -
Koyeb a Data Viewer Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso
Condividi i risultati di Koyeb in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia salvabile che si riavvia automaticamente all'apertura, su telefono, tablet o computer. L'interlocutore visualizzerà i risultati, senza mai dover scrivere codice SQL o richiedere le credenziali.
Come funziona il visualizzatore di dati - Per app e sistemi
-
API REST di Koyeb Endpoint dell'HT
Pubblica una query Koyeb 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.
Guida a PostgreSQL -
Koyeb a Power BI Power Query M
Incolla la query Power Query M generata nell'editor avanzato di Power BI e il report visualizzerà i risultati di Koyeb in tempo reale tramite HTTPS, senza driver ODBC né porte di database aperte.
Come funziona Power BI -
Koyeb ad Airtable Piattaforma di automazione
Sincronizza le righe di Koyeb con un database Airtable a intervalli regolari, oppure recuperale tramite uno script di automazione di Airtable.
Guida a PostgreSQL -
Koyeb a Baserow Piattaforma di automazione
È possibile alimentare una tabella Baserow da Koyeb tramite l'endpoint REST, sia in locale che nel cloud di Baserow.
Guida a PostgreSQL -
Koyeb a SeaTable Piattaforma di automazione
Mantieni aggiornato il database di SeaTable con i dati di Koyeb senza esportare un file o esporre il database stesso.
Guida a PostgreSQL -
Koyeb a Smartsheet Piattaforma di automazione
Inserisci i risultati di Koyeb in una griglia di Smartsheet in modo che i piani e i report vengano letti dal sistema di origine e non dall'esportazione della settimana precedente.
Guida a PostgreSQL -
Koyeb ad Anvil Anvil Works · Piattaforma per app
Esegui il backup di un'app Anvil Python con Koyeb tramite l'endpoint REST anziché incorporare le credenziali del database nell'app.
Guida a PostgreSQL - Per gli strumenti di intelligenza artificiale
-
Server MCP di Koyeb Clienti di Claude, Cursor e MCP
Concedi a un assistente IA l'accesso in sola lettura a Koyeb con lo schema necessario per scrivere codice SQL corretto, senza credenziali nella chat.
Guida a PostgreSQL - Consegnato alle persone
-
Avvisi e segnalazioni di Koyeb Slack · Discord · Email · Webhook
Imposta una query Koyeb su una pianificazione e ricevi le righe su Slack, Discord, via email o tramite un webhook firmato, oppure trattieni il messaggio finché il numero di righe, la soglia o la 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
Installa l'agente di rete dove preferisci. Apre una sola connessione in uscita e non rimane mai in ascolto, quindi Koyeb lo vede come un normale client e la tua rete non necessita di alcuna regola in entrata.
Apri la scheda Dettagli di connessione nel database nella console di Koyeb e copia la stringa. Prendila dal database, non dall'app.
Incollalo. Vengono letti host, porta, utente, password e database, e viene verificato se l'host ha l'estensione .pg che lo identifica come endpoint del database.
Le impostazioni predefinite di Koyeb sono già configurate (koyeb-adm come utente e koyebdb come database), quindi per un nuovo servizio di solito è sufficiente inserire la password.
Salva. Microsoft Excel, Fogli Google, Power BI, MCP e REST leggono tutti tramite quella singola connessione oppure possono essere uniti ad altre origini dati in un'unica istruzione di sola lettura.
Analisi approfondita delle funzionalità
Ciò che Koyeb ti dà
Il nome host dell'applicazione non corrisponde al nome host del database.
Koyeb è una piattaforma applicativa che utilizza anche PostgreSQL, e i due sistemi risiedono separati da un'unica etichetta. Si tratta di un errore davvero facile da commettere, che può causare gravi problemi, quindi la scheda lo intercetta.
- Le applicazioni vengono servite da .koyeb.app. I database sono accessibili da .pg.koyeb.app. La differenza sta nel suffisso .pg. nel mezzo.
- Incolla un host che termina con .koyeb.app senza specificare il percorso, e la scheda ti blocca con quella spiegazione, invece di permetterti di salvare una connessione che scadrà sempre.
- Un timeout è il sintomo peggiore possibile in questo caso, perché sembra un problema del firewall. Le persone vanno a controllare le regole di rete che non erano affatto il problema.
- I nomi host dei database seguono la struttura ep-<nome>-<id>. Il PostgreSQL di Koyeb è basato su Neon, ed è da lì che deriva questo schema.
Oltre a ciò, deliberatamente ordinario
Non c'è nessun meccanismo sofisticato qui, e fingere il contrario sarebbe solo fuorviante. La carta si limita a riportare i dettagli correttamente e a non intralciare.
- Il protocollo TLS è obbligatorio per ogni host .pg.koyeb.app, indipendentemente dall'impostazione della casella di controllo; pertanto, una stringa che ha perso la sua modalità SSL negli appunti viene comunque trasmessa crittografata. Il traffico è crittografato; la catena di certificati non viene verificata.
- Non è presente alcun pooler nel percorso. Alcuni servizi Postgres serverless inseriscono un pooler in modalità transazionale a monte e necessitano di istruzioni preparate per funzionare; Koyeb non ne ha bisogno, quindi l'agente si connette direttamente e salta tutto questo passaggio.
- koyeb-adm e koyebdb sono precompilati perché è così che si presenta un nuovo database Koyeb. Un servizio appena creato spesso richiede solo la password.
- La connessione viene salvata come PostgreSQL con Koyeb mantenuto come badge. Non esiste un tipo di connessione chiamato Koyeb. — il che significa anche che una semplice connessione Postgres stabilita in precedenza con un host .pg.koyeb.app riconoscerà immediatamente il marchio.
-- Postgres ordinario, sola lettura SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;
Condiviso da ogni connettore di database
Vero per ogni connettore di database
- Solo in uscita — l'agente apre una connessione crittografata verso Query Streams. Nessuna porta in entrata da inoltrare, nessuna VPN, nessuna lista IP consentita, nessuna informazione sul database esposta a Internet.
- Le credenziali restano al loro posto — Il nome utente e la password del database risiedono sul computer su cui è installato l'agente. Query Streams non li riceve mai e non può accedere al database autonomamente.
- Sola lettura, forzata — un'istruzione alla volta, solo SELECT e simili. Una scrittura viene rifiutata sulla propria macchina prima ancora di essere inviata al server, anziché fare affidamento su un permesso che qualcuno si è ricordato di impostare.
- Distribuisci tutti gli agenti che desideri — uno per sito, regione o cloud. Tutte le fonti di dati che possono visualizzare vengono visualizzate in un unico menu a tendina, quindi nessuno deve sapere quale agente ospita cosa.
Ecco cosa si ottiene una volta salvata una query.
- Condividi la funzionalità, non l'SQL — un collega o un partner esterno può eseguire la tua query e modificarne i filtri senza mai visualizzare l'istruzione sottostante.
- Filtri da entrambe le direzioni — dichiarali tu stesso come @variabili, oppure lascia che il connettore rilevi i valori letterali già presenti nella clausola WHERE e li offra come menu a tendina.
- Leggilo ovunque Microsoft Excel, Fogli Google, Power BI, l'API REST, gli assistenti AI tramite MCP, Query Builder e Nova leggono tutti la stessa query salvata.
- Eseguine diversi contemporaneamente — cinque query salvate in cinque schede di fogli di lavoro, eseguite simultaneamente, indipendentemente dalle dimensioni dei risultati.
- Collegalo a qualsiasi altro dispositivo che hai già connesso. — un altro database, un'API aziendale o una cartella di file, in un'unica istruzione di sola lettura.
SQL tra sorgenti diverse
Collega Koyeb al resto dei tuoi dati
Un'unica istruzione può coinvolgere Koyeb e le altre connessioni contemporaneamente. Ogni sorgente esegue solo la parte che può, trasmette 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
Una dichiarazione
-- niente copiato, niente unito, niente programmato
SELEZIONARE c.region, COUNT(*) AS ordini, SUM(i.amount_due) AS fatturati
DA koyeb_app.ordini pubblici1 f
CONGIUNGERE erp_sql.dbo.clienti2 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
Ciò di cui Koyeb ha bisogno
- Ospite
- ep-<nome>-<id>.<regione>.pg.koyeb.app — notare l'estensione .pg., che lo rende un database anziché un'app.
- Porto
- 5432
- Autista
- Npgsql, trasportato dall'agente: non è necessario installare nulla sul lato Koyeb.
- Database
- koyebdb su un servizio fresco e pre-riempito come tale
- Nome utente
- koyeb-adm su un nuovo servizio e pre-riempito come tale
- TLS
- Obbligatorio e imposto dall'agente per ogni host .pg.koyeb.app. Crittografato; la catena di certificati non è verificata.
- Pooling
- Nessuno: Koyeb non necessita di endpoint condivisi, quindi l'agente si connette direttamente.
- Timeout di connessione
- 30 secondi, un tentativo
- Salvato come
- PostgreSQL, con Koyeb mantenuto come badge: non esiste un tipo di connessione chiamato Koyeb
- Schema predefinito
- pubblico, che è ciò che un riferimento federato comporta
Un validatore possiede questa caratteristica, ed è opportuno spiegare perché merita una sezione a parte anziché una nota a piè di pagina. La maggior parte degli errori di connessione si manifestano: una password errata genera un errore di autenticazione, un nome di database errato indica che il database non esiste. Puntare un client Postgres a un hostname di un'applicazione non produce nessuno di questi problemi. Genera un timeout, perché all'altro capo c'è un host reale che semplicemente non è in ascolto per Postgres. Un timeout viene interpretato come un problema di rete, quindi gli utenti vanno a controllare le regole del firewall, chiedono al team di sviluppo informazioni sul traffico in uscita e perdono un pomeriggio a causa di un'estensione .pg. mancante in un hostname. Individuare l'errore nel momento in cui si incolla il codice vale molto di più delle due righe di codice necessarie.
Tutto il resto di questo connettore è onestamente insignificante, e la pagina lo specifica chiaramente, senza dilungarsi in dettagli superflui. Koyeb afferma che Postgres è basato su Neon, l'agente comunica con esso tramite Npgsql su TLS forzato e non è previsto alcun pool di connessioni. Questa è tutta la storia, e una storia vera e più breve è meglio di una più lunga e lusinghiera.
Per una query cross-source, Koyeb si comporta come un normale PostgreSQL. Una connessione chiamata koyeb_app viene scritta koyeb_app.public.orders e si connette a una cartella di file CSV, a un sistema di registrazione locale o a un'API di fatturazione con un'unica istruzione di sola lettura, senza copiare nulla e senza pianificare alcuna operazione.
Documentazione del fornitore: www.koyeb.com
FAQ
Domande su Koyeb
Quali strumenti sono in grado di leggere i dati di Koyeb 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 il database 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.
Devo aprire una porta del firewall per il mio database Koyeb?
No. L'agente di rete di Query Streams viene eseguito all'interno della rete locale e apre una singola connessione crittografata in uscita. Nessun sistema intercetta il traffico in entrata, non è necessaria una VPN e il database mantiene le regole del firewall esistenti.
È possibile modificare i dati in Koyeb tramite Query Streams?
No. L'agente impone la sola lettura nel punto di esecuzione: un'istruzione alla volta, solo SELECT e simili. Le credenziali rimangono sull'agente e non vengono mai inviate a Query Streams.
Di cosa ha bisogno Query Streams per connettersi a Koyeb?
Un host raggiungibile, un ruolo e la relativa password: l'agente trasporta il driver, quindi non viene installato nulla sul database. Host: ep-<nome>-<id>.<regione>.pg.koyeb.app — notare l'estensione .pg., che lo identifica come un database anziché come un'app. Porta: 5432. Driver: Npgsql, trasportato dall'agente: non è necessario installare nulla sul lato Koyeb. Database: koyebdb su un servizio appena avviato e precompilato come tale.
Posso unire Koyeb a un altro database nella stessa query?
Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento a Koyeb 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.
La connessione a Koyeb è diversa dalla connessione a PostgreSQL?
Solo la stringa di connessione. Koyeb utilizza il protocollo di rete di PostgreSQL, quindi filtri, pianificazione, condivisione, i componenti aggiuntivi per Excel e Fogli Google e il server MCP si comportano tutti allo stesso modo. La scheda Koyeb precompila le impostazioni di host, porta e SSL previste dal provider.
Esiste una guida da Koyeb a Excel?
Sì, si tratta della guida per PostgreSQL, ed è corretta anche per Koyeb. Koyeb utilizza il protocollo di rete di PostgreSQL, quindi la connessione da Koyeb a Excel, da Koyeb a Fogli Google e a qualsiasi altra destinazione segue gli stessi passaggi. L'unica parte specifica per Koyeb è la stringa di connessione, che viene inserita automaticamente nella scheda di Koyeb.
Metti Koyeb dove si lavora
Installa l'agente, configuralo per connettersi al tuo database e scegli una destinazione.
Sola lettura Solo in uscita Le credenziali rimangono sull'agente

