Logo Koyeb

Postgres sans serveur parle PostgreSQL

Connecter Koyeb vers Excel, Google Sheets, l'IA et REST

Serveur PostgreSQL Koyeb sur .pg.koyeb.app. Cette fiche signale l'erreur la plus fréquente : coller le nom d'hôte de l'application au lieu de celui de la base de données.

Commencez gratuitement 13 destinations

Une seule connexion, chaque surface

Où vos données Koyeb peuvent-elles être stockées ?

Koyeb tables en direct · en lecture seule
Requêtes fédérées + tout autre connecteur · un SQL toutes sources · tous les plans
Agent de réseau
  • 1 connexion sortante
  • 0 ports d'entrée
  • lecture seule · les identifiants restent stockés

fonctionne sur

Query Streams lit les données de Koyeb Postgres depuis Microsoft Excel, Google Sheets, Power BI, les assistants IA via MCP et un point de terminaison REST grâce à une connexion en lecture seule. Koyeb héberge les applications et les bases de données sur des noms d'hôte adjacents, mais un seul d'entre eux est une base de données : les applications sont accessibles via .koyeb.app et Postgres via .pg.koyeb.app. La confusion entre ces deux noms d'hôte est la principale cause d'échec de cette connexion. C'est pourquoi la carte vérifie cette confusion et l'indique clairement, plutôt que de laisser l'échec se traduire par un délai d'attente dépassé.

Koyeb est PostgreSQL sur le réseau — le pilote standard, donc tous les guides ci-dessous s'appliquent sans modification. La seule partie spécifique à Koyeb est la chaîne de connexion, traitée dans détails de connexion.

  1. Pour votre équipe, vos fournisseurs et vos partenaires

  2. Koyeb vers Excel Microsoft Excel · Complément Excel

    Importez directement les résultats Koyeb en direct dans une feuille de calcul et actualisez-les à la demande — Excel de bureau, Excel Online, Microsoft 365.

    Guide PostgreSQL

  3. Koyeb vers Google Sheets Module complémentaire Sheets

    Exécutez une requête Koyeb enregistrée depuis la barre latérale et glissez-déposez les lignes dans la feuille. Les collaborateurs peuvent ensuite la mettre à jour eux-mêmes.

    Guide PostgreSQL

  4. Demandez à Nova ce qu'il pense de Koyeb. Nova AI · Texte vers SQL

    Posez votre question en langage clair. Nova connaît déjà vos tables Koyeb, rédige et exécute la requête SQL, explique la réponse et la représente graphiquement — aucune requête à écrire, aucune information d’identification à fournir.

    Comment fonctionne Nova

  5. Koyeb vers Data Viewer Partage des résultats · équipe, fournisseurs, partenaires · téléphone, tablette, ordinateur

    Partagez un résultat Koyeb en temps réel avec qui vous voulez (un collègue, un fournisseur, un partenaire) sous forme de grille que vous pouvez ajouter à vos favoris et qui se met à jour automatiquement à chaque ouverture, sur un téléphone, une tablette ou un ordinateur. Ils voient les résultats, jamais le code SQL ni les identifiants.

    Fonctionnement du visualiseur de données
  6. Pour les applications et les systèmes

  7. API REST Koyeb point de terminaison HTTP

    Publiez une requête Koyeb sous forme de point de terminaison JSON authentifié, accessible à toute application, avec une spécification OpenAPI 3.1 et des collections Postman, Insomnia et Hoppscotch prêtes à l'emploi. Aucun port de base de données n'est ouvert.

    Guide PostgreSQL

  8. Koyeb vers Power BI Power Query M

    Collez le code Power Query M généré dans l'éditeur avancé de Power BI et le rapport affichera les résultats Koyeb en direct via HTTPS — sans pilote ODBC ni port de base de données ouvert.

    Comment fonctionne Power BI

  9. Koyeb vers Airtable Plateforme d'automatisation

    Synchronisez les lignes Koyeb dans une base Airtable selon une planification, ou récupérez-les dans un script d'automatisation Airtable.

    Guide PostgreSQL

  10. Koyeb à Baserow Plateforme d'automatisation

    Alimentez une table Baserow depuis Koyeb via le point de terminaison REST — auto-hébergé ou cloud Baserow.

    Guide PostgreSQL

  11. Koyeb à SeaTable Plateforme d'automatisation

    Maintenez une base SeaTable à jour avec les données Koyeb sans exporter de fichier ni exposer la base de données.

    Guide PostgreSQL

  12. Koyeb vers Smartsheet Plateforme d'automatisation

    Intégrez les résultats de Koyeb dans une grille Smartsheet afin que les plans et les rapports soient lus à partir du système source et non de l'exportation de la semaine précédente.

    Guide PostgreSQL

  13. Koyeb à Anvil Anvil Works · Plateforme d'applications

    Utilisez Koyeb pour synchroniser une application Anvil Python avec le point de terminaison REST au lieu d'intégrer les identifiants de base de données dans l'application.

    Guide PostgreSQL
  14. Pour les outils d'IA

  15. Serveur Koyeb MCP Claude, clients de Cursor et MCP

    Donnez à un assistant IA un accès en lecture seule à Koyeb avec le schéma dont il a besoin pour écrire du SQL correct — aucune information d'identification dans la conversation.

    Guide PostgreSQL
  16. Livré aux personnes

  17. Alertes et rapports de Koyeb Slack · Discord · Courriel · Webhook

    Programmez une requête Koyeb et faites en sorte que les lignes soient envoyées à Slack, Discord, par e-mail ou via un webhook signé — ou conservez le message jusqu'à ce qu'un nombre de lignes, un seuil ou un pourcentage de variation dépasse la limite que vous avez définie.

    Fonctionnement des alertes et des rapports

Comment ça marche

5 étapes, aucune modification du pare-feu entrant

01

Installez l'agent réseau où vous le souhaitez. Il ouvre une connexion sortante et n'écoute jamais, de sorte que Koyeb le considère comme un client ordinaire et que votre réseau ne nécessite aucune règle entrante.

02

Ouvrez l'onglet « Détails de connexion » de la base de données dans la console Koyeb et copiez la chaîne de caractères. Récupérez-la depuis la base de données, et non depuis l'application.

03

Collez-le. L'hôte, le port, l'utilisateur, le mot de passe et la base de données sont tous lus, et l'hôte est vérifié pour l'extension .pg qui le désigne comme point de terminaison de base de données.

04

Les paramètres par défaut habituels de Koyeb sont déjà renseignés — koyeb-adm comme utilisateur et koyebdb comme base de données — de sorte qu'un nouveau service n'a généralement besoin que du mot de passe.

05

Enregistrez. Microsoft Excel, Google Sheets, Power BI, MCP et REST lisent tous cette connexion unique, ou la combinent à vos autres sources dans une seule instruction en lecture seule.

Analyse approfondie des fonctionnalités

Ce que Koyeb vous donne

Le nom d'hôte de l'application n'est pas le nom d'hôte de la base de données.

Koyeb est une plateforme applicative qui exécute également Postgres, et les deux sont distantes d'un seul label. C'est une erreur très facile à commettre et elle entraîne des conséquences graves ; la carte intercepte donc l'opération.

  • Les applications sont accessibles depuis .koyeb.app. Les bases de données sont accessibles via .pg.koyeb.app. La différence réside dans l'extension .pg.
  • Si vous collez un hôte se terminant par .koyeb.app sans ce suffixe, la fiche vous bloque avec cette explication, au lieu de vous laisser enregistrer une connexion qui expirera systématiquement.
  • Un délai d'attente dépassé est le pire symptôme possible, car il ressemble à un problème de pare-feu. Les utilisateurs vérifient alors des règles réseau qui n'étaient en rien liées au problème.
  • Les noms d'hôtes des bases de données suivent le format ep-<nom>-<id>. Le serveur Postgres de Koyeb est basé sur Neon, d'où provient ce format.

Au-delà de cela, délibérément ordinaire

Il n'y a pas de mécanisme complexe ici, et prétendre le contraire serait induire en erreur. La carte se contente de fournir les informations exactes et de rester discrète.

  • Le protocole TLS est obligatoire pour chaque hôte .pg.koyeb.app, quelle que soit la valeur de la case à cocher. Ainsi, une chaîne de caractères dont le mode SSL a été perdu dans le presse-papiers est toujours transmise chiffrée. Le trafic est chiffré ; la chaîne de certificats n'est pas vérifiée.
  • Aucun pooler n'est présent sur le chemin. Certains services Postgres sans serveur utilisent un pooler en mode transactionnel et nécessitent l'utilisation de requêtes préparées ; Koyeb, lui, n'en a pas besoin : l'agent se connecte donc directement et ignore cette étape.
  • Les fichiers koyeb-adm et koyebdb sont préremplis car c'est ainsi qu'une nouvelle base de données Koyeb est initialisée. Un service nouvellement créé ne nécessite souvent que le mot de passe.
  • La connexion est enregistrée au format PostgreSQL avec Koyeb comme identifiant. Il n'existe pas de type de connexion appelé Koyeb. — ce qui signifie également qu'une simple connexion Postgres que vous avez établie précédemment avec un hôte .pg.koyeb.app affichera la marque dès sa réception.
-- Postgres ordinaire, en lecture seule 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;

Partagé par tous les connecteurs de base de données

C'est valable pour tous les connecteurs de base de données.

  • Sortant uniquement L'agent ouvre une connexion chiffrée vers Query Streams. Aucun port entrant à rediriger, aucun VPN, aucune liste blanche d'adresses IP : votre base de données n'est en aucun cas exposée sur Internet.
  • Les identifiants restent en place — Le nom d'utilisateur et le mot de passe de la base de données sont stockés sur la machine où l'agent est installé. Query Streams ne les reçoit jamais et ne peut pas accéder à votre base de données par lui-même.
  • Lecture seule, obligatoire — une seule instruction à la fois, SELECT et les instructions associées uniquement. Une tentative d'écriture est bloquée sur votre machine avant même d'être envoyée au serveur, sans dépendre d'une autorisation préalablement définie par un tiers.
  • Déployez autant d'agents que vous le souhaitez — un par site, région ou cloud. Toutes les sources de données visibles apparaissent dans un menu déroulant unique ; il est donc inutile de savoir quel agent héberge quoi.

Voici ce que vous obtenez une fois qu'une requête est enregistrée.

  • Partagez les compétences, pas le SQL. — un collègue ou un partenaire externe peut exécuter votre requête et modifier ses filtres sans jamais voir la requête sous-jacente.
  • Filtres provenant des deux directions — Déclarez-les vous-même comme @variables, ou laissez le connecteur repérer les valeurs littérales déjà présentes dans votre clause WHERE et les proposer sous forme de listes déroulantes.
  • Lisez-le depuis n'importe où — Microsoft Excel, Google Sheets, Power BI, l'API REST, les assistants IA via MCP, le générateur de requêtes et Nova lisent tous la même requête enregistrée.
  • Exécutez-en plusieurs simultanément — cinq requêtes enregistrées dans cinq onglets de feuille de calcul, diffusées simultanément, quelle que soit la taille des résultats.
  • Connectez-le à tout autre élément que vous avez connecté. — une autre base de données, une API métier ou un dossier de fichiers, dans une seule instruction en lecture seule.

SQL inter-sources

Associez Koyeb au reste de vos données

Une seule requête peut couvrir simultanément Koyeb et vos autres connexions. Chaque source exécute uniquement la partie qu'elle peut, renvoie le résultat, et la jointure est centralisée ; les sources ne communiquent jamais entre elles et aucune donnée n'est copiée.

3 connexions · 3 agents

Koyeb Postgres sans serveur
Microsoft SQL Server Moteur relationnel
Rayure Paiements et facturation

Une déclaration

-- rien copié, rien fusionné, rien programmé
SELECTIONNER   c.region, COUNT(*) AS commandes, SUM(i.montant_dû) AS facturé
DE     application koyeb.public.orders1 f
JOINDRE     erp_sql.dbo.clients2   c ON c.id = f.customer_id
JOINDRE     facturation.stripe.factures3 i ON i.customer = c.stripe_id
GROUPE PAR région c.
ORDER BY facturé DESC;

Les trois éléments sont la connexion, le schéma et la table ; le nom de la connexion est celui que vous lui avez donné. Les colonnes sont données à titre d'exemple ; vos tables seront les vôtres. Chaque élément est en lecture seule : seules les instructions SELECT, WITH et EXPLAIN sont autorisées, avec une limite quant aux données qu'une source peut transmettre pour une requête donnée. Fonctionnement des requêtes fédérées

Détails de connexion

Ce dont Koyeb a besoin

Hôte
ep-<nom>-<id>.<région>.pg.koyeb.app — notez l'extension .pg., qui indique qu'il s'agit d'une base de données et non d'une application.
Port
5432
Conducteur
Npgsql, pris en charge par l'agent — aucune installation requise côté Koyeb
Base de données
koyebdb sur un nouveau service, et prérempli comme tel
Nom d'utilisateur
koyeb-adm sur un service frais, et prérempli comme tel
TLS
Obligatoire et imposé par l'agent pour chaque hôte .pg.koyeb.app. Chiffré ; la chaîne de certificats n'est pas vérifiée.
Mise en commun
Aucun — Koyeb n'a besoin d'aucun point de terminaison mutualisé ; l'agent se connecte donc directement.
Délai de connexion dépassé
30 secondes, une tentative
Enregistré sous
PostgreSQL, avec Koyeb conservé comme badge — il n'existe pas de type de connexion appelé Koyeb
Schéma par défaut
public, ce que contient une référence fédérée

Un validateur possède cette fonctionnalité, et il est important d'expliquer pourquoi elle mérite une section entière plutôt qu'une simple note de bas de page. La plupart des erreurs de connexion sont explicites : un mot de passe incorrect entraîne une erreur d'authentification, un nom de base de données erroné indique que la base de données n'existe pas. Configurer un client Postgres pour qu'il utilise le nom d'hôte d'une application ne produit aucun de ces problèmes. Cela provoque un délai d'attente dépassé, car un serveur réel est présent à l'autre extrémité, mais il n'est tout simplement pas à l'écoute pour Postgres. Un délai d'attente dépassé est interprété comme un problème réseau ; les utilisateurs vérifient alors les règles du pare-feu, contactent leur équipe technique concernant le trafic sortant et perdent un après-midi entier à cause d'un nom d'hôte contenant l'extension .pg manquante. Détecter ce problème dès la connexion est bien plus précieux que les deux lignes de code nécessaires.

Pour le reste, ce connecteur est franchement banal, et la page le précise sans s'encombrer de détails superflus. Koyeb Postgres est basé sur Neon, l'agent communique avec lui via Npgsql en utilisant TLS obligatoire, et aucun pool de connexions n'est nécessaire. Voilà tout, et une version courte et véridique vaut mieux qu'une version longue et flatteuse.

Pour une requête inter-sources, Koyeb fonctionne comme une base de données Postgres classique. Une connexion nommée koyeb_app est enregistrée sous le nom koyeb_app.public.orders et effectue une jointure en lecture seule avec un dossier de fichiers CSV, un système d'information local ou une API de facturation ; aucune copie n'est effectuée et aucune opération n'est planifiée.

Documentation du fournisseur : www.koyeb.com

FAQ

Questions sur Koyeb

Quels outils peuvent lire les données Koyeb via les flux de requêtes ?

Tous ces outils, depuis une seule connexion : Excel, Google Sheets, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertes et rapports programmés. Connectez la base de données une seule fois et tous les systèmes accèdent à la même connexion en lecture seule ; aucune configuration n’est requise pour chaque outil et aucune copie supplémentaire des données n’est nécessaire.

Dois-je ouvrir un port de pare-feu pour ma base de données Koyeb ?

Non. L'agent réseau Query Streams s'exécute au sein de votre réseau et ouvre une seule connexion sortante chiffrée. Aucun trafic entrant n'est intercepté, aucun VPN n'est requis et la base de données conserve ses règles de pare-feu existantes.

Les flux de requêtes peuvent-ils modifier les données dans Koyeb ?

Non. L'agent impose un accès en lecture seule lors de l'exécution : une seule instruction à la fois, uniquement SELECT et les instructions associées. Les informations d'identification restent sur l'agent et ne sont jamais envoyées aux flux de requêtes.

De quoi Query Streams a-t-il besoin pour se connecter à Koyeb ?

Un hôte accessible, un rôle et son mot de passe : l’agent héberge le pilote, aucune installation n’est donc requise sur la base de données. Hôte : ep-<nom>-<id>.<région>.pg.koyeb.app — notez l’extension .pg, qui indique qu’il s’agit d’une base de données et non d’une application. Port : 5432. Pilote : Npgsql, hébergé par l’agent — aucune installation n’est nécessaire côté Koyeb. Base de données : koyebdb sur un service fraîchement créé et pré-remplie.

Puis-je joindre Koyeb à une autre base de données dans la même requête ?

Oui, il s'agit bien d'une requête fédérée. Une seule instruction peut référencer simultanément Koyeb et vos autres connexions, sous la forme `connection.schema.table`. Chaque source exécute uniquement la partie qu'elle peut traiter et renvoie le résultat. La jointure est centralisée, ce qui évite toute connexion entre les sources et empêche toute copie ou planification. L'accès en lecture seule s'applique à chaque élément (SELECT, WITH et EXPLAIN uniquement), et la quantité de données qu'une source peut transmettre pour une requête donnée est limitée. Les requêtes fédérées sont une fonctionnalité incluse dans votre abonnement ; la page dédiée affiche les limites actuelles de la source et de la taille des données.

La connexion à Koyeb est-elle différente de la connexion à PostgreSQL ?

Seule la chaîne de connexion est nécessaire. Koyeb utilise le protocole PostgreSQL ; par conséquent, les filtres, la planification, le partage, les modules complémentaires Excel et Google Sheets ainsi que le serveur MCP fonctionnent de manière identique. La carte Koyeb pré-remplit les paramètres d'hôte, de port et SSL attendus par le fournisseur.

Existe-t-il un guide de conversion de Koyeb vers Excel ?

Oui, il s'agit bien du guide PostgreSQL, et il est correct pour Koyeb tel qu'il est rédigé. Koyeb utilise le protocole PostgreSQL ; par conséquent, la procédure est identique pour connecter Koyeb à Excel, à Google Sheets ou à toute autre destination. Seule la chaîne de connexion est spécifique à Koyeb, et la carte Koyeb la renseigne automatiquement.

Placez Koyeb là où le travail se déroule.

Installez l'agent, configurez-le pour qu'il pointe vers votre base de données et choisissez une destination.

Commencez gratuitement Tous les connecteurs

Lecture seule Sortant uniquement Les identifiants restent sur l'agent