Koyeb-logo

Serverloze PostgreSQL spreekt PostgreSQL

Verbinden Koyeb naar Excel, Google Sheets, AI en REST

Koyeb serverless Postgres op .pg.koyeb.app. De kaart corrigeert de meest voorkomende fout: het plakken van de hostnaam van de applicatie in plaats van die van de database.

Begin gratis 13 bestemmingen

Eén verbinding, elk oppervlak

Waar uw Koyeb-gegevens naartoe kunnen gaan

Koyeb live tafels · Alleen-lezen
Gefedereerde zoekopdrachten + elke andere connector · één SQL uit verschillende bronnen · elk plan
Netwerk Agent
  • 1 uitgaande verbinding
  • 0 inkomende poorten
  • alleen-lezen · inloggegevens blijven behouden

draait op

Query Streams leest Koyeb Postgres-gegevens uit Microsoft Excel, Google Sheets, Power BI, AI-assistenten via MCP en een REST-eindpunt via één alleen-lezen verbinding. Koyeb host apps en databases op naast elkaar gelegen hostnamen, en slechts één daarvan is een database: apps bevinden zich op .koyeb.app en Postgres op .pg.koyeb.app. Het verwisselen van deze twee is de meest voorkomende oorzaak van verbindingsproblemen, daarom controleert de kaart hierop en geeft dit duidelijk aan in plaats van een time-out te melden.

Koyeb is PostgreSQL op het netwerk. — de standaard driver, dus alle onderstaande handleidingen blijven ongewijzigd van toepassing. Het enige Koyeb-specifieke onderdeel is de verbindingsreeks, die wordt behandeld onder verbindingsgegevens.

  1. Voor uw team, leveranciers en partners

  2. Koyeb naar Excel Microsoft Excel · Excel-invoegtoepassing

    Haal live Koyeb-resultaten rechtstreeks in een werkblad op en vernieuw ze wanneer nodig — in Excel op de desktop, Excel Online en Microsoft 365.

    PostgreSQL-handleiding

  3. Koyeb naar Google Sheets Sheets-add-on

    Voer een opgeslagen Koyeb-query uit vanuit de zijbalk en sleep de rijen naar het spreadsheet. Gedeelde medewerkers kunnen het spreadsheet zelf vernieuwen.

    PostgreSQL-handleiding

  4. Vraag Nova naar Koyeb. Nova AI · tekst naar SQL

    Stel een vraag in begrijpelijke taal. Nova kent uw Koyeb-tabellen al, schrijft en voert de SQL-query uit, legt het antwoord uit en visualiseert het in een grafiek – u hoeft geen query te schrijven en geen inloggegevens te verstrekken.

    Hoe Nova werkt

  5. Koyeb naar Data Viewer Resultaten delen · team, leveranciers, partners · telefoon, tablet, desktop

    Deel een live Koyeb-resultaat met wie dan ook – een collega, een leverancier, een partner – als een bladwijzerbaar raster dat opnieuw wordt weergegeven wanneer het wordt geopend, op een telefoon, een tablet of een desktop. Ze zien de resultaten, nooit de SQL-query of de inloggegevens.

    Hoe de gegevensviewer werkt
  6. Voor apps en systemen

  7. Koyeb REST API HTTP-eindpunt

    Publiceer een Koyeb-query als een geauthenticeerd JSON-eindpunt dat elke applicatie kan aanroepen, met een OpenAPI 3.1-specificatie en kant-en-klare collecties voor Postman, Insomnia en Hoppscotch. Er wordt geen databasepoort geopend.

    PostgreSQL-handleiding

  8. Koyeb naar Power BI Power Query M

    Plak de gegenereerde Power Query M in de geavanceerde editor van Power BI en het rapport leest live Koyeb-resultaten via HTTPS — zonder ODBC-stuurprogramma en zonder geopende databasepoort.

    Hoe Power BI werkt

  9. Koyeb naar Airtable Automatiseringsplatform

    Synchroniseer Koyeb-rijen volgens een schema met een Airtable-database, of haal ze op binnen een Airtable-automatiseringsscript.

    PostgreSQL-handleiding

  10. Koyeb naar Baserow Automatiseringsplatform

    Vul een Baserow-tabel in vanuit Koyeb via het REST-eindpunt — zowel op een zelfgehoste locatie als in de Baserow-cloud.

    PostgreSQL-handleiding

  11. Koyeb naar SeaTable Automatiseringsplatform

    Houd een SeaTable-database actueel met Koyeb-gegevens zonder een bestand te exporteren of de database openbaar te maken.

    PostgreSQL-handleiding

  12. Koyeb naar Smartsheet Automatiseringsplatform

    Importeer de Koyeb-resultaten in een Smartsheet-raster, zodat plannen en rapporten rechtstreeks uit het bronsysteem worden gelezen en niet uit de export van vorige week.

    PostgreSQL-handleiding

  13. Koyeb naar Anvil Anvil Works · App-platform

    Ondersteun een Anvil Python-app met Koyeb via het REST-eindpunt in plaats van databasegegevens in de app in te sluiten.

    PostgreSQL-handleiding
  14. Voor AI-tools

  15. Koyeb MCP-server Claude, Cursor en MCP-klanten

    Geef een AI-assistent alleen-leestoegang tot Koyeb met het schema dat nodig is om correcte SQL te schrijven — geen inloggegevens in de chat.

    PostgreSQL-handleiding
  16. Bezorgd aan mensen

  17. Koyeb waarschuwt en rapporteert Slack · Discord · E-mail · Webhook

    Plan een Koyeb-query in en laat de resultaten naar Slack, Discord, e-mail of een ondertekende webhook verzenden, of wacht met verzenden totdat een bepaald aantal resultaten, een drempelwaarde of een percentageverandering de door u ingestelde grens overschrijdt.

    Hoe waarschuwingen en rapporten werken

Hoe het werkt

5 stappen, geen wijziging van de inkomende firewall

01

Installeer de netwerkagent waar u maar wilt. Deze opent één uitgaande verbinding en luistert nooit, waardoor Koyeb een gewone client ziet en uw netwerk geen inkomende regel nodig heeft.

02

Open het tabblad Verbindingsdetails in de Koyeb-console van de database en kopieer de tekenreeks. Haal deze uit de database, niet uit de app.

03

Plak het erin. Host, poort, gebruiker, wachtwoord en database worden er allemaal uitgelezen, en de host wordt gecontroleerd op de extensie .pg, die aangeeft dat het een database-eindpunt is.

04

De gebruikelijke Koyeb-standaardgegevens zijn al ingevuld — koyeb-adm als gebruiker en koyebdb als database — dus voor een nieuwe service is meestal alleen het wachtwoord nodig.

05

Opslaan. Microsoft Excel, Google Sheets, Power BI, MCP en REST lezen allemaal via die ene verbinding, of koppel deze aan uw andere bronnen in één enkele alleen-lezen instructie.

Diepgaande analyse van de functies

Wat Koyeb je geeft

De hostnaam van de app is niet dezelfde als de hostnaam van de database.

Koyeb is een applicatieplatform dat ook PostgreSQL draait, en de twee bestaan op één label van elkaar. Dat is een heel makkelijke fout die ernstig misgaat, dus de kaart onderschept het.

  • Applicaties worden aangeboden via .koyeb.app. Databases zijn bereikbaar via .pg.koyeb.app. Het verschil zit hem in de .pg. in het midden.
  • Plak een host die eindigt op .koyeb.app zonder die toevoeging en de kaart blokkeert je met die uitleg, in plaats van je een verbinding te laten opslaan die toch altijd een time-out zal geven.
  • Een time-out is hier het ergst mogelijke symptoom, omdat het lijkt alsof er een firewallprobleem is. Mensen gaan dan netwerkregels controleren die helemaal niet het probleem waren.
  • Databasehostnamen volgen de structuur ep-<naam>-<id>. Koyeb's PostgreSQL is gebaseerd op Neon, vandaar dat patroon.

Daarnaast is het opzettelijk gewoon.

Er komt geen ingewikkelde techniek aan te pas, en doen alsof dat wel zo is, zou alleen maar misleidend zijn. De kaart geeft de juiste informatie weer en doet verder niets anders dan op de achtergrond treden.

  • TLS wordt afgedwongen voor elke .pg.koyeb.app-host, ongeacht wat het selectievakje aangeeft. Een tekenreeks waarvan de sslmode in het klembord verloren is gegaan, wordt dus nog steeds versleuteld verzonden. Het verkeer is versleuteld; de certificaatketen wordt niet geverifieerd.
  • Er is geen pooler in het pad. Sommige serverloze PostgreSQL-services plaatsen een transactiemodus-pooler ervoor en vereisen dat voorbereide statements worden vastgezet om dit te kunnen verwerken; Koyeb doet dit niet, waardoor de agent direct verbinding maakt en dit alles overslaat.
  • koyeb-adm en koyebdb zijn vooraf ingevuld omdat dat de beginwaarden zijn van een nieuwe Koyeb-database. Een gloednieuwe service heeft vaak niets anders nodig dan het wachtwoord.
  • De verbinding wordt opgeslagen als PostgreSQL met Koyeb als badge. Er bestaat geen verbindingstype met de naam Koyeb. — wat ook betekent dat een gewone Postgres-verbinding die je eerder hebt gemaakt met een .pg.koyeb.app-host de merknaam direct zal herkennen.
-- Gewone PostgreSQL, alleen-lezen 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;

Gedeeld door elke databaseconnector

Dit geldt voor elke databaseconnector.

  • Alleen uitgaand — De agent opent één versleutelde verbinding naar Query Streams. Geen inkomende poort om door te sturen, geen VPN, geen IP-whitelist, niets van uw database wordt blootgesteld aan het internet.
  • De inloggegevens blijven behouden. — De gebruikersnaam en het wachtwoord van de database bevinden zich op de machine waarop u de agent hebt geïnstalleerd. Query Streams ontvangt deze gegevens nooit en kan uw database dus niet zelfstandig bereiken.
  • Alleen-lezen, afgedwongen — één instructie tegelijk, alleen SELECT en soortgelijke instructies. Een schrijfbewerking wordt op uw eigen machine geweigerd voordat deze naar de server wordt verzonden, in plaats van te vertrouwen op een machtiging die iemand zich herinnerd heeft te hebben ingesteld.
  • Zet zoveel agents in als u wilt. — één per site, regio of cloud. Alle gegevensbronnen die ze kunnen zien, verschijnen in één enkel dropdownmenu, zodat niemand hoeft te weten welke agent wat host.

Dit is wat je krijgt nadat een query is opgeslagen.

  • Deel de mogelijkheden, niet de SQL-code. — Een collega of externe partner kan uw query uitvoeren en de filters ervan wijzigen zonder ooit de onderliggende instructie te zien.
  • Filters uit beide richtingen — declareer ze zelf als @variabelen, of laat de connector de letterlijke waarden herkennen die al in je WHERE-clausule staan en bied die aan als keuzelijsten.
  • Lees het vanaf elke gewenste locatie. — Microsoft Excel, Google Sheets, Power BI, de REST API, AI-assistenten via MCP, de Query Builder en Nova lezen allemaal dezelfde opgeslagen query.
  • Voer er meerdere tegelijk uit — vijf opgeslagen zoekopdrachten in vijf werkbladtabbladen, die gelijktijdig worden weergegeven, ongeacht de omvang van de resultaten.
  • Verbind het met alles wat je al hebt aangesloten. — een andere database, een zakelijke API of een map met bestanden, in één alleen-lezen instructie.

Cross-source SQL

Voeg Koyeb toe aan de rest van je gegevens

Eén enkele instructie kan Koyeb en uw andere verbindingen tegelijk omvatten. Elke bron voert alleen het deel uit dat het aankan, streamt het resultaat terug en de samenvoeging vindt centraal plaats — de bronnen communiceren nooit met elkaar en er wordt niets gekopieerd.

3 verbindingen · 3 agenten

Koyeb Serverloze PostgreSQL
Microsoft SQL Server Relationele engine
Streep Betalingen en facturering

Eén verklaring

-- niets gekopieerd, niets samengevoegd, niets ingepland
SELECT   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
VAN     koyeb_app.openbare.bevelen1 f
JOIN     erp_sql.dbo.customers2   c ON c.id = f.customer_id
JOIN     facturering.stripe.facturen3 i ON i.customer = c.stripe_id
GROEP DOOR c.regio
ORDER BY gefactureerd DESC;

De drie onderdelen zijn de verbinding, het schema en de tabel — en de verbindingsnaam is wat je er zelf aan hebt gegeven. Illustratieve kolommen; je tabellen zullen je eigen tabellen zijn. Alleen-lezen is van toepassing op elk onderdeel: alleen SELECT, WITH en EXPLAIN, met een limiet op hoeveel gegevens een bron mag vrijgeven voor een enkele query. Hoe werken gefedereerde query's?

Verbindingsgegevens

Wat Koyeb nodig heeft

Gastheer
ep-<naam>-<id>.<regio>.pg.koyeb.app — let op de .pg., die aangeeft dat het een database is in plaats van een app.
Haven
5432
Bestuurder
Npgsql wordt door de agent meegeleverd — er hoeft niets aan de Koyeb-kant geïnstalleerd te worden.
Database
koyebdb op een nieuwe service, en als zodanig vooraf ingevuld
Gebruikersnaam
koyeb-adm op een nieuwe service, en als zodanig vooraf ingevuld
TLS
Vereist en afgedwongen door de agent voor elke .pg.koyeb.app-host. Versleuteld; de certificaatketen wordt niet geverifieerd.
Samenvoegen
Geen — Koyeb heeft geen gepoolde eindpunten nodig, dus de agent maakt direct verbinding.
Verbindingsfout
30 seconden, één poging
Opgeslagen als
PostgreSQL, waarbij Koyeb als badge wordt behouden — er bestaat geen verbindingstype met de naam Koyeb.
Standaardschema
openbaar, wat een gefedereerde referentie met zich meedraagt

Eén validator heeft dit punt, en het is de moeite waard om uit te leggen waarom het een eigen paragraaf verdient in plaats van een voetnoot. De meeste verbindingsfouten kondigen zich vanzelf aan: een verkeerd wachtwoord is een authenticatiefout, een verkeerde databasenaam geeft aan dat de database niet bestaat. Het laten verwijzen van een PostgreSQL-client naar een applicatiehostnaam levert echter niets van dat alles op. Het resulteert in een time-out, omdat er aan de andere kant wel degelijk een host bestaat die simpelweg niet luistert naar PostgreSQL. Een time-out wordt geïnterpreteerd als een netwerkprobleem, waardoor mensen firewallregels gaan controleren, hun platformteam vragen naar uitgaand verkeer en een middag kwijt zijn aan een ontbrekende .pg. in een hostnaam. Het opsporen van dit probleem op het moment van plakken is veel waardevoller dan de twee regels code die het kost.

Voor de rest is deze connector eerlijk gezegd onopvallend, en dat staat ook op de pagina zelf, zonder er dieper op in te gaan. Koyeb Postgres is gebaseerd op Neon, de agent communiceert ermee via Npgsql over een afgedwongen TLS-verbinding, en er is geen pooler nodig. Dat is het hele verhaal, en een korter, waargebeurd verhaal is beter dan een langer, vleiend verhaal.

Voor een query over meerdere bronnen is Koyeb een gewone PostgreSQL-server. Een verbinding die je koyeb_app noemt, wordt geschreven als koyeb_app.public.orders en maakt in één alleen-lezen statement verbinding met een map met CSV-bestanden, een lokaal systeem voor gegevensregistratie of een facturerings-API — zonder dat er iets wordt gekopieerd of gepland.

Leveranciersdocumentatie: www.koyeb.com

Veelgestelde vragen

Vragen over Koyeb

Welke tools kunnen Koyeb-gegevens lezen via Query Streams?

Alles via één verbinding: Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, geplande meldingen en rapporten. Verbind de database één keer en elk apparaat leest dezelfde alleen-lezen verbinding — er is geen configuratie per tool nodig en er wordt geen tweede kopie van de gegevens gemaakt.

Moet ik een firewallpoort openen naar mijn Koyeb-database?

Nee. De Query Streams Network Agent draait binnen uw netwerk en opent één versleutelde uitgaande verbinding. Er wordt niets afgeluisterd voor inkomend verkeer, er is geen VPN nodig en de database behoudt de bestaande firewallregels.

Kunnen querystreams gegevens in Koyeb wijzigen?

Nee. De agent zorgt ervoor dat alleen-lezen is toegestaan tijdens de uitvoering — één instructie tegelijk, alleen SELECT en soortgelijke instructies. De inloggegevens blijven op de agent en worden nooit naar Query Streams verzonden.

Wat heeft Query Streams nodig om verbinding te maken met Koyeb?

Een bereikbare host, een rol en het bijbehorende wachtwoord — de agent bevat de driver, dus er hoeft niets op de database geïnstalleerd te worden. Host: ep-<naam>-<id>.<regio>.pg.koyeb.app — let op de .pg., die aangeeft dat het een database is in plaats van een app. Poort: 5432. Driver: Npgsql, meegeleverd door de agent — er hoeft niets aan de Koyeb-kant geïnstalleerd te worden. Database: koyebdb op een nieuwe service, en als zodanig vooraf ingevuld.

Kan ik Koyeb in dezelfde query aan een andere database koppelen?

Ja, dat is een gefedereerde query. Eén statement kan tegelijkertijd verwijzen naar Koyeb en uw andere verbindingen, geschreven als connection.schema.table. Elke bron voert alleen het deel uit dat het aankan en streamt het resultaat terug; de join vindt centraal plaats, waardoor de bronnen nooit met elkaar verbinding maken en er niets wordt gekopieerd of gepland. Alleen-lezen is van toepassing op elk onderdeel — alleen SELECT, WITH en EXPLAIN — en er is een limiet aan hoeveel gegevens een bron voor een enkele query mag vrijgeven. Gefedereerde queries zijn een functie van het abonnement; op de pagina met gefedereerde queries vindt u de huidige limieten voor bronnen en groottes.

Is de verbinding met Koyeb anders dan de verbinding met PostgreSQL?

Alleen de verbindingsreeks. Koyeb gebruikt het PostgreSQL-protocol, dus filters, planning, delen, de Excel- en Google Sheets-add-ons en de MCP-server werken allemaal identiek. De Koyeb-kaart vult de host-, poort- en SSL-instellingen die de provider verwacht, automatisch in.

Is er een Koyeb naar Excel-handleiding?

Ja, het is de PostgreSQL-handleiding en die is correct voor Koyeb zoals die is beschreven. Koyeb gebruikt het PostgreSQL-protocol, dus verbindingen van Koyeb naar Excel, Google Sheets en alle andere bestemmingen volgen dezelfde stappen. Het enige Koyeb-specifieke onderdeel is de verbindingsreeks, en de Koyeb-kaart vult die voor je in.

Plaats Koyeb daar waar het werk gebeurt.

Installeer de agent, koppel deze aan uw database en kies een bestemming.

Begin gratis Alle connectoren

Alleen-lezen Alleen uitgaand De inloggegevens blijven bij de agent.