Koyeb-Logo

Serverloses Postgres spricht PostgreSQL

Verbinden Koyeb zu Excel, Google Sheets, KI und REST

Koyeb Serverless Postgres auf .pg.koyeb.app. Die Karte zeigt den einen Fehler auf, den jeder macht – den Hostnamen der Anwendung anstelle des Datenbank-Hostnamens einzufügen.

Kostenlos starten 13 Reiseziele

Eine Verbindung, jede Oberfläche

Wohin Ihre Koyeb-Daten gelangen können

Koyeb Live-Tische • Nur lesbar
Verbundabfragen + jeder andere Anschluss · eine SQL-Abfrage über verschiedene Quellen hinweg · jeder Plan
Netzwerk-Agent
  • 1 ausgehende Verbindung
  • 0 eingehende Ports
  • Schreibgeschützt · Anmeldeinformationen bleiben erhalten

läuft auf

Query Streams liest Daten aus Koyeb Postgres von Microsoft Excel, Google Sheets, Power BI, KI-Assistenten über MCP und einem REST-Endpunkt über eine einzige schreibgeschützte Verbindung. Koyeb hostet Anwendungen und Datenbanken unter benachbarten Hostnamen, wobei nur eine davon eine Datenbank ist: Anwendungen befinden sich unter .koyeb.app und Postgres unter .pg.koyeb.app. Die häufigste Ursache für Verbindungsfehler ist die Verwechslung dieser beiden. Daher prüft die Karte dies und gibt eine entsprechende Meldung aus, anstatt einen Timeout zu melden.

Koyeb ist PostgreSQL im Netzwerk — der Standardtreiber, daher gelten alle nachfolgenden Anleitungen unverändert. Der einzige Koyeb-spezifische Teil ist die Verbindungszeichenfolge, die unter [Link einfügen] behandelt wird. Verbindungsdetails.

  1. Für Ihr Team, Ihre Lieferanten und Partner

  2. Koyeb to Excel Microsoft Excel · Excel-Add-in

    Koyeb-Ergebnisse live direkt in ein Arbeitsblatt importieren und bei Bedarf aktualisieren – Desktop-Excel, Excel Online, Microsoft 365.

    PostgreSQL-Leitfaden

  3. Koyeb zu Google Sheets Tabellen-Add-on

    Führen Sie eine gespeicherte Koyeb-Abfrage aus der Seitenleiste aus und ziehen Sie die Zeilen in das Tabellenblatt. Gemeinsame Mitarbeiter können es selbst aktualisieren.

    PostgreSQL-Leitfaden

  4. Frag Nova nach Koyeb Nova AI · Text zu SQL

    Stellen Sie Ihre Frage in einfachem Englisch. Nova kennt Ihre Koyeb-Tabellen bereits, schreibt und führt die SQL-Abfrage aus, erklärt die Antwort und stellt sie grafisch dar – Sie müssen keine Abfrage schreiben und keine Zugangsdaten angeben.

    So funktioniert Nova

  5. Koyeb zum Datenbetrachter Ergebnispräsentation · Team, Lieferanten, Partner · Smartphone, Tablet, Desktop

    Teilen Sie Live-Ergebnisse von Koyeb mit beliebigen Personen – Kollegen, Lieferanten, Partnern – als Lesezeichen speichernde Tabelle, die beim Öffnen auf einem Smartphone, Tablet oder Desktop-Computer immer neu angezeigt wird. Die Empfänger sehen die Ergebnisse, niemals die SQL-Abfrage oder die Zugangsdaten.

    So funktioniert der Datenbetrachter
  6. Für Apps und Systeme

  7. Koyeb REST-API HTTP-Endpunkt

    Veröffentlichen Sie eine Koyeb-Abfrage als authentifizierten JSON-Endpunkt, den jede Anwendung aufrufen kann, mit einer OpenAPI 3.1-Spezifikation und vorgefertigten Sammlungen für Postman, Insomnia und Hoppscotch. Es wird kein Datenbankport geöffnet.

    PostgreSQL-Leitfaden

  8. Koyeb zu Power BI Power Query M

    Fügen Sie die generierte Power Query M in den Power BI Advanced Editor ein, und der Bericht liest Live-Koyeb-Ergebnisse über HTTPS – ohne ODBC-Treiber und ohne geöffneten Datenbankport.

    So funktioniert Power BI

  9. Koyeb zu Airtable Automatisierungsplattform

    Koyeb-Zeilen können zeitgesteuert mit einer Airtable-Datenbank synchronisiert oder innerhalb eines Airtable-Automatisierungsskripts abgerufen werden.

    PostgreSQL-Leitfaden

  10. Koyeb nach Baserow Automatisierungsplattform

    Eine Baserow-Tabelle wird über den REST-Endpunkt von Koyeb gespeist – entweder selbst gehostet oder in der Baserow-Cloud.

    PostgreSQL-Leitfaden

  11. Koyeb zu SeaTable Automatisierungsplattform

    Halten Sie eine SeaTable-Datenbank mit Koyeb-Daten auf dem neuesten Stand, ohne eine Datei zu exportieren oder die Datenbank preiszugeben.

    PostgreSQL-Leitfaden

  12. Koyeb zu Smartsheet Automatisierungsplattform

    Die Ergebnisse von Koyeb werden in ein Smartsheet-Raster übertragen, sodass Pläne und Berichte aus dem Quellsystem und nicht aus dem Export der letzten Woche gelesen werden.

    PostgreSQL-Leitfaden

  13. Koyeb nach Anvil Anvil Works · App-Plattform

    Eine Anvil Python-App mit Koyeb über den REST-Endpunkt absichern, anstatt Datenbankzugangsdaten in die App einzubetten.

    PostgreSQL-Leitfaden
  14. Für KI-Tools

  15. Koyeb MCP-Server Claude-, Cursor- und MCP-Clients

    Gewähren Sie einem KI-Assistenten Lesezugriff auf Koyeb mit dem Schema, das er benötigt, um korrekten SQL-Code zu schreiben – keine Anmeldeinformationen im Chat.

    PostgreSQL-Leitfaden
  16. An Personen geliefert

  17. Koyeb-Warnungen und -Berichte Slack · Discord · E-Mail · Webhook

    Richten Sie eine Koyeb-Abfrage ein, die zeitgesteuert ausgeführt wird, und lassen Sie die Zeilen an Slack, Discord, per E-Mail oder über einen signierten Webhook zustellen – oder halten Sie die Nachricht zurück, bis eine bestimmte Zeilenanzahl, ein Schwellenwert oder eine prozentuale Änderung den von Ihnen festgelegten Wert überschreitet.

    So funktionieren Benachrichtigungen und Berichte

So funktioniert es

5 Schritte, keine Änderung der eingehenden Firewall

01

Installieren Sie den Netzwerkagenten an einem beliebigen Ort. Er öffnet eine ausgehende Verbindung und lauscht nie, sodass Koyeb ihn als normalen Client erkennt und Ihr Netzwerk keine eingehende Regel benötigt.

02

Öffnen Sie in der Koyeb-Konsole den Tab „Verbindungsdetails“ der Datenbank und kopieren Sie die Zeichenfolge. Nehmen Sie sie aus der Datenbank, nicht aus der App.

03

Fügen Sie es ein. Host, Port, Benutzername, Passwort und Datenbank werden alle daraus ausgelesen, und der Host wird auf die Endung .pg überprüft, die ihn als Datenbankendpunkt kennzeichnet.

04

Die üblichen Koyeb-Standardeinstellungen sind bereits voreingestellt – koyeb-adm als Benutzer und koyebdb als Datenbank – sodass ein neu gestarteter Dienst in der Regel nur das Passwort benötigt.

05

Speichern. Microsoft Excel, Google Sheets, Power BI, MCP und REST lesen alle über diese eine Verbindung oder verbinden sie mit Ihren anderen Datenquellen in einer einzigen schreibgeschützten Anweisung.

Funktionsanalyse

Was Koyeb Ihnen gibt

Der Hostname der Anwendung ist nicht der Hostname der Datenbank.

Koyeb ist eine Anwendungsplattform, die auch Postgres nutzt, und die beiden arbeiten eng beieinander. Das ist ein leicht zu begehender Fehler, der schwerwiegende Folgen hat, weshalb die Karte ihn abfängt.

  • Anwendungen werden über die Domain .koyeb.app bereitgestellt. Datenbanken sind über .pg.koyeb.app erreichbar. Der Unterschied liegt im .pg. in der Mitte.
  • Wenn Sie eine Host-Adresse mit der Endung .koyeb.app ohne diese einfügen, werden Sie mit dieser Erklärung gestoppt, anstatt eine Verbindung speichern zu können, die ohnehin immer wieder abbricht.
  • Ein Timeout ist hier das schlimmstmögliche Symptom, da es wie ein Firewall-Problem aussieht. Die Leute überprüfen dann Netzwerkregeln, die nie die Ursache waren.
  • Datenbank-Hostnamen folgen dem Muster ep-<Name>-<ID>. Koyebs Postgres basiert auf Neon, daher stammt dieses Muster.

Darüber hinaus, bewusst gewöhnlich

Hier steckt keine ausgeklügelte Technik dahinter, und das Gegenteil zu behaupten, würde nur irreführend sein. Die Karte liefert einfach die korrekten Details und hält sich im Hintergrund.

  • TLS wird für jeden .pg.koyeb.app-Host unabhängig von der Checkbox-Einstellung erzwungen. Daher wird auch eine Zeichenkette, deren SSL-Verschlüsselung in der Zwischenablage verloren gegangen ist, verschlüsselt übertragen. Der Datenverkehr ist verschlüsselt; die Zertifikatskette wird nicht überprüft.
  • Es gibt keinen Pooler im Pfad. Einige serverlose Postgres-Dienste verwenden einen Transaktionsmodus-Pooler davor und benötigen vorbereitete Anweisungen, um damit umzugehen; Koyeb benötigt dies nicht, sodass der Agent sich direkt verbindet und dies alles überspringt.
  • Die Dateien koyeb-adm und koyebdb sind bereits ausgefüllt, da dies die Ausgangskonfiguration einer neuen Koyeb-Datenbank ist. Ein brandneuer Dienst benötigt oft nur das Passwort.
  • Die Verbindung wird als PostgreSQL-Verbindung mit dem Namenszusatz „Koyeb“ gespeichert. Es existiert kein Verbindungstyp namens „Koyeb“. — was auch bedeutet, dass eine einfache Postgres-Verbindung, die Sie zuvor zu einem .pg.koyeb.app-Host hergestellt haben, das Branding sofort erkennt.
-- Normales Postgres, schreibgeschützt 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;

Wird von jedem Datenbank-Connector gemeinsam genutzt.

Gilt für jeden Datenbank-Connector.

  • Nur ausgehend Der Agent öffnet eine einzige verschlüsselte Verbindung zu Query Streams. Es wird kein eingehender Port weitergeleitet, kein VPN verwendet, keine IP-Zulassungsliste verwendet und Ihre Datenbank wird nicht im Internet offengelegt.
  • Die Zugangsdaten bleiben erhalten. — Benutzername und Passwort der Datenbank befinden sich auf dem Rechner, auf dem der Agent installiert wurde. Query Streams empfängt diese Daten nicht und kann daher nicht selbstständig auf Ihre Datenbank zugreifen.
  • Schreibgeschützt, erzwungen — Nur eine Anweisung gleichzeitig, ausschließlich SELECT und ähnliche Optionen. Ein Schreibvorgang wird auf Ihrem Rechner abgelehnt, bevor er an den Server gesendet wird, anstatt sich auf eine von jemandem gesetzte Berechtigung zu verlassen.
  • Setzen Sie beliebig viele Agenten ein. — eine pro Standort, Region oder Cloud. Alle sichtbaren Datenquellen werden in einem einzigen Dropdown-Menü angezeigt, sodass niemand wissen muss, welcher Agent welche Daten hostet.

Was Sie erhalten, sobald eine Abfrage gespeichert wurde

  • Teilen Sie die Funktionalität, nicht die SQL-Anweisung. — Ein Kollege oder ein externer Partner kann Ihre Abfrage ausführen und deren Filter ändern, ohne jemals die dahinterstehende Anweisung zu sehen.
  • Filter aus beiden Richtungen — Deklarieren Sie sie selbst als @Variablen oder lassen Sie den Konnektor die bereits in Ihrer WHERE-Klausel vorhandenen Literalwerte erkennen und diese als Dropdown-Listen anbieten.
  • Lesen Sie es von überall aus — Microsoft Excel, Google Sheets, Power BI, die REST-API, KI-Assistenten über MCP, der Query Builder und Nova lesen alle dieselbe gespeicherte Abfrage.
  • Mehrere gleichzeitig ausführen — fünf gespeicherte Abfragen in fünf Tabellenblattregisterkarten, die gleichzeitig abgearbeitet werden, unabhängig von der Größe der Ergebnisse.
  • Verbinde es mit allem anderen, was du verbunden hast. — eine andere Datenbank, eine Business-API oder einen Ordner mit Dateien in einer einzigen schreibgeschützten Anweisung.

Quellübergreifendes SQL

Verbinde Koyeb mit deinen übrigen Daten.

Eine einzige Anweisung kann Koyeb und Ihre anderen Verbindungen gleichzeitig umfassen. Jede Quelle führt nur den von ihr bearbeitbaren Teil aus, streamt das Ergebnis zurück, und die Zusammenführung erfolgt zentral – die Quellen kommunizieren nie miteinander, und es werden keine Kopien an andere Stellen angefertigt.

3 Verbindungen · 3 Agenten

Koyeb Serverloses Postgres
Microsoft SQL-Server Relationale Maschine
Streifen Zahlungen & Rechnungsstellung

Eine Aussage

– nichts kopiert, nichts zusammengeführt, nichts geplant
SELECT   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
VON     koyeb_app.public.orders1 f
JOIN     erp_sql.dbo.customers2   c ON c.id = f.customer_id
JOIN     Abrechnung.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY c.region
ORDER BY in Rechnung gestellte Beschreibung;

Die drei Bestandteile sind Verbindung, Schema und Tabelle – der Verbindungsname ist der von Ihnen gewählte. Die Spalten dienen nur der Veranschaulichung; Ihre Tabellen entsprechen Ihren tatsächlichen Tabellen. Der Schreibschutz gilt für alle Komponenten: Nur SELECT, WITH und EXPLAIN sind zulässig, und es gibt eine Obergrenze für die Datenmenge, die eine einzelne Datenquelle pro Abfrage übermitteln darf. Wie föderierte Abfragen funktionieren

Verbindungsdetails

Was Koyeb braucht

Gastgeber
ep-<name>-<id>.<region>.pg.koyeb.app – Beachten Sie die Endung .pg., die es zu einer Datenbank und nicht zu einer App macht.
Hafen
5432
Treiber
Npgsql wird vom Agenten bereitgestellt – auf Koyeb-Seite ist keine Installation erforderlich.
Datenbank
koyebdb auf einem neuen Service, und als solches vorausgefüllt
Benutzername
koyeb-adm auf einem neuen Service, und als solches vorausgefüllt
TLS
Erforderlich und vom Agenten für jeden .pg.koyeb.app-Host erzwungen. Verschlüsselt; die Zertifikatskette wird nicht überprüft.
Pooling
Keine – Koyeb benötigt keinen gepoolten Endpunkt, daher verbindet sich der Agent direkt.
Verbindungstimeout
30 Sekunden, ein Versuch
Gespeichert als
PostgreSQL, wobei Koyeb als Symbol beibehalten wird – es gibt keinen Verbindungstyp namens Koyeb
Standardschema
öffentlich, was eine föderierte Bezugnahme beinhaltet

Ein Validator verwendet diese Karte, und es lohnt sich zu erklären, warum sie einen eigenen Abschnitt und nicht nur eine Fußnote verdient. Die meisten Verbindungsfehler kündigen sich an: Ein falsches Passwort führt zu einem Authentifizierungsfehler, ein falscher Datenbankname bedeutet, dass die Datenbank nicht existiert. Wenn man einen Postgres-Client auf einen Anwendungshostnamen verweist, passiert nichts dergleichen. Es kommt zu einem Timeout, weil am anderen Ende ein realer Host existiert, der aber einfach nicht auf Postgres wartet. Ein Timeout wird als Netzwerkproblem interpretiert, sodass Benutzer Firewall-Regeln überprüfen, ihr Plattformteam bezüglich ausgehender Verbindungen kontaktieren und einen ganzen Nachmittag wegen eines fehlenden „.pg.“ im Hostnamen verlieren. Das Abfangen dieses Fehlers beim Einfügen ist weitaus wertvoller als die zwei Zeilen Code, die es kostet.

Alles andere an diesem Konnektor ist ehrlich gesagt unspektakulär, und die Seite beschreibt das auch so, anstatt es künstlich aufzubauschen. Koyeb Postgres basiert auf Neon, der Agent kommuniziert mit Npgsql über erzwungenes TLS, und es ist kein Pooler erforderlich. Das ist die ganze Geschichte, und eine kürzere, wahre Geschichte ist besser als eine längere, schmeichelhafte.

Für eine quellenübergreifende Abfrage verhält sich Koyeb wie gewöhnliches Postgres. Eine von Ihnen als koyeb_app bezeichnete Verbindung wird als koyeb_app.public.orders geschrieben und verknüpft einen Ordner mit CSV-Dateien, ein lokales Datensystem oder eine Abrechnungs-API in einer einzigen schreibgeschützten Anweisung – ohne dass Daten kopiert oder geplant werden.

Herstellerdokumentation: www.koyeb.com

Häufig gestellte Fragen

Fragen zu Koyeb

Welche Tools können Koyeb-Daten über Query Streams lesen?

Alle Anwendungen – Excel, Google Sheets, MCP, REST-API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, geplante Benachrichtigungen und Berichte – werden über eine einzige Verbindung bereitgestellt. Die Datenbankverbindung wird einmalig hergestellt, und alle Anwendungen greifen auf dieselbe schreibgeschützte Verbindung zu – es ist keine separate Einrichtung pro Tool und keine Datenkopie erforderlich.

Muss ich einen Firewall-Port für meine Koyeb-Datenbank öffnen?

Nein. Der Query Streams Network Agent läuft innerhalb Ihres Netzwerks und öffnet eine einzige verschlüsselte ausgehende Verbindung. Es wird kein eingehender Datenverkehr überwacht, ein VPN ist nicht erforderlich und die Datenbank behält ihre bestehenden Firewall-Regeln bei.

Können Abfrageströme Daten in Koyeb ändern?

Nein. Der Agent erzwingt zum Zeitpunkt der Ausführung den Lesezugriff – es wird jeweils nur eine Anweisung ausgeführt, beispielsweise SELECT-Anweisungen. Die Anmeldeinformationen verbleiben auf dem Agenten und werden niemals an Abfrageströme gesendet.

Was benötigt Query Streams, um eine Verbindung zu Koyeb herzustellen?

Ein erreichbarer Host, eine Rolle und deren Passwort – der Agent trägt den Treiber, daher ist keine Installation auf der Datenbank erforderlich. Host: ep-<Name>-<ID>.<Region>.pg.koyeb.app – beachten Sie die Endung .pg., die die Datenbank von einer Anwendung unterscheidet. Port: 5432. Treiber: Npgsql, vom Agenten bereitgestellt – keine Installation auf Koyeb-Seite erforderlich. Datenbank: koyebdb auf einem neu eingerichteten Dienst, entsprechend vorbefüllt.

Kann ich Koyeb in derselben Abfrage mit einer anderen Datenbank verknüpfen?

Ja, das ist eine föderierte Abfrage. Eine einzige Anweisung kann Koyeb und Ihre anderen Verbindungen gleichzeitig referenzieren, geschrieben als Verbindung.Schema.Tabelle. Jede Quelle führt nur den Teil aus, den sie ausführen kann, und streamt das Ergebnis zurück. Der Join erfolgt zentral, sodass die Quellen sich nicht untereinander verbinden und nichts kopiert oder eingeplant wird. Der Schreibschutz gilt nur für SELECT, WITH und EXPLAIN. Außerdem ist die Datenmenge, die eine Quelle für eine einzelne Abfrage übermitteln darf, begrenzt. Föderierte Abfragen sind eine Funktion des Abonnementplans. Die Seite für föderierte Abfragen zeigt die aktuellen Quell- und Größenbeschränkungen an.

Unterscheidet sich die Verbindung von Koyeb von der Verbindung von PostgreSQL?

Lediglich die Verbindungszeichenfolge. Koyeb verwendet das PostgreSQL-Protokoll, daher verhalten sich Filter, Terminplanung, Freigabe, die Excel- und Google Sheets-Add-ons sowie der MCP-Server identisch. Die Koyeb-Karte füllt die vom Anbieter erwarteten Host-, Port- und SSL-Einstellungen automatisch aus.

Gibt es eine Anleitung zur Übertragung von Koyeb in Excel?

Ja, es handelt sich um die PostgreSQL-Anleitung, und sie ist für Koyeb in der beschriebenen Form korrekt. Koyeb verwendet das PostgreSQL-Protokoll, daher sind die Schritte für die Verbindung von Koyeb mit Excel, Google Sheets und allen anderen Zielen identisch. Der einzige Koyeb-spezifische Bestandteil ist die Verbindungszeichenfolge, die von der Koyeb-Karte automatisch ausgefüllt wird.

Setz Koyeb dorthin, wo die Arbeit passiert.

Installieren Sie den Agenten, verweisen Sie ihn auf Ihre Datenbank und wählen Sie ein Ziel aus.

Kostenlos starten Alle Anschlüsse

Schreibgeschützt Nur ausgehend Die Zugangsdaten bleiben beim Agenten.