Logo Koyeb

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

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.

  1. Per il tuo team, i fornitori e i partner
  2. 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
  3. 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
  4. 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
  5. 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
  6. Per app e sistemi
  7. 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
  8. 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
  9. 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
  10. 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
  11. 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
  12. 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
  13. 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
  14. Per gli strumenti di intelligenza artificiale
  15. 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
  16. Consegnato alle persone
  17. 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

01

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.

02

Apri la scheda Dettagli di connessione nel database nella console di Koyeb e copia la stringa. Prendila dal database, non dall'app.

03

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.

04

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.

05

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

Koyeb PostgreSQL senza server
Microsoft SQL Server 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     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