Logotipo de Koyeb

PostgreSQL sin servidor habla PostgreSQL

Conectar Koyeb a Excel, Google Sheets, IA y REST

Koyeb Serverless Postgres en .pg.koyeb.app. La tarjeta detecta el error que todos cometen: pegar el nombre de host de la aplicación en lugar del de la base de datos.

Comienza gratis 13 destinos

Una conexión, cada superficie

Dónde pueden ir tus datos de Koyeb

Koyeb mesas en vivo · solo lectura
Consultas federadas + cualquier otro conector · un SQL todas las fuentes · cada plan
Agente de red
  • 1 conexión saliente
  • 0 puertos de entrada
  • Solo lectura · Las credenciales permanecen

funciona en

Query Streams lee datos de Koyeb Postgres desde Microsoft Excel, Google Sheets, Power BI y asistentes de IA a través de MCP y un punto final REST mediante una conexión de solo lectura. Koyeb aloja aplicaciones y bases de datos en nombres de host adyacentes, y solo una de ellas es una base de datos: las aplicaciones se encuentran en .koyeb.app y Postgres en .pg.koyeb.app. La confusión entre ambas es la causa más común de fallo de esta conexión, por lo que la tarjeta lo comprueba y lo indica claramente en lugar de permitir que falle por tiempo de espera agotado.

Koyeb está en la línea de PostgreSQL — el controlador estándar, por lo que todas las guías a continuación se aplican sin cambios. La única parte específica de Koyeb es la cadena de conexión, cubierta en detalles de conexión.

  1. Para su equipo, proveedores y socios

  2. Koyeb para Excel Microsoft Excel · Complemento de Excel

    Integre los resultados de Koyeb en tiempo real directamente en una hoja de cálculo y actualícelos cuando lo necesite: Excel de escritorio, Excel Online, Microsoft 365.

    Guía de PostgreSQL

  3. Koyeb a Google Sheets Complemento de hojas

    Ejecuta una consulta de Koyeb guardada desde la barra lateral y arrastra las filas a la hoja de cálculo. Los colaboradores pueden actualizarla ellos mismos.

    Guía de PostgreSQL

  4. Pregúntale a Nova sobre Koyeb. Nova AI · texto a SQL

    Haz tu pregunta en lenguaje sencillo. Nova ya conoce tus tablas de Koyeb, escribe y ejecuta la consulta SQL, explica la respuesta y la representa gráficamente; no necesitas escribir ninguna consulta ni proporcionar credenciales.

    Cómo funciona Nova

  5. Koyeb al visor de datos Compartir resultados · equipo, proveedores, socios · teléfono, tableta, ordenador

    Comparte un resultado de Koyeb en tiempo real con quien quieras —un colega, un proveedor, un socio— como una cuadrícula que se puede guardar y que se actualiza automáticamente al abrirla en un teléfono, una tableta o un ordenador. Verán los resultados, nunca el código SQL ni las credenciales.

    Cómo funciona el visor de datos
  6. Para aplicaciones y sistemas

  7. API REST de Koyeb punto final HTTP

    Publica una consulta de Koyeb como un punto final JSON autenticado al que cualquier aplicación puede acceder, con una especificación OpenAPI 3.1 y colecciones preconfiguradas para Postman, Insomnia y Hoppscotch. No se abre ningún puerto de base de datos.

    Guía de PostgreSQL

  8. Koyeb a Power BI Power Query M

    Pegue la consulta Power Query M generada en el Editor avanzado de Power BI y el informe leerá los resultados de Koyeb en tiempo real a través de HTTPS, sin necesidad de un controlador ODBC ni de abrir ningún puerto de base de datos.

    Cómo funciona Power BI

  9. Koyeb a Airtable Plataforma de automatización

    Sincroniza las filas de Koyeb con una base de datos de Airtable según un cronograma, o recupéralas mediante un script de automatización de Airtable.

    Guía de PostgreSQL

  10. Koyeb a Baserow Plataforma de automatización

    Alimenta una tabla de Baserow desde Koyeb a través del punto final REST, ya sea en servidores propios o en la nube de Baserow.

    Guía de PostgreSQL

  11. Koyeb a SeaTable Plataforma de automatización

    Mantén actualizada una base de datos SeaTable con datos de Koyeb sin exportar ningún archivo ni exponer la base de datos.

    Guía de PostgreSQL

  12. Koyeb a Smartsheet Plataforma de automatización

    Introduzca los resultados de Koyeb en una cuadrícula de Smartsheet para que los planes e informes se lean desde el sistema de origen, y no desde la exportación de la semana pasada.

    Guía de PostgreSQL

  13. Koyeb a Anvil Anvil Works · Plataforma de aplicaciones

    Realiza una copia de seguridad de una aplicación Python de Anvil con Koyeb a través del punto final REST en lugar de incrustar las credenciales de la base de datos en la aplicación.

    Guía de PostgreSQL
  14. Para herramientas de IA

  15. Servidor Koyeb MCP Clientes de Claude, Cursor y MCP

    Otorgue a un asistente de IA acceso de solo lectura a Koyeb con el esquema que necesita para escribir SQL correcto; no se requieren credenciales en el chat.

    Guía de PostgreSQL
  16. Entregado a las personas

  17. Alertas e informes de Koyeb Slack · Discord · Correo electrónico · Webhook

    Programa una consulta de Koyeb y haz que las filas se envíen a Slack, Discord, correo electrónico o un webhook firmado, o bien, retén el mensaje hasta que un número de filas, un umbral o un cambio porcentual supere la línea que hayas establecido.

    Cómo funcionan las alertas y los informes

Cómo funciona

5 pasos, sin cambios en el firewall de entrada

01

Instala el Agente de red donde te convenga. Abre una conexión saliente y nunca escucha, por lo que Koyeb ve un cliente normal y tu red no necesita ninguna regla de entrada.

02

Abre la pestaña Detalles de conexión en la base de datos en la consola de Koyeb y copia la cadena. Tómala de la base de datos, no de la aplicación.

03

Pégalo. Se leen el host, el puerto, el usuario, la contraseña y la base de datos, y se comprueba el host para ver si tiene la extensión .pg. que lo identifica como punto final de la base de datos.

04

Los valores predeterminados habituales de Koyeb ya están configurados (koyeb-adm como usuario y koyebdb como base de datos), por lo que un servicio nuevo normalmente solo necesita la contraseña.

05

Guardar. Microsoft Excel, Google Sheets, Power BI, MCP y REST leen a través de esa única conexión o la combinan con sus otras fuentes en una sola instrucción de solo lectura.

Análisis en profundidad de la función

Lo que Koyeb te ofrece

El nombre de host de la aplicación no es el nombre de host de la base de datos.

Koyeb es una plataforma de aplicaciones que también ejecuta PostgreSQL, y ambas se encuentran separadas por una etiqueta. Es un error muy fácil de cometer y tiene consecuencias graves, por lo que la tarjeta lo intercepta.

  • Las aplicaciones se ejecutan desde .koyeb.app. Las bases de datos se acceden desde .pg.koyeb.app. La diferencia radica en el .pg. intermedio.
  • Si pegas un host que termina en .koyeb.app sin eso, la tarjeta te detiene con esa explicación, en lugar de permitirte guardar una conexión que siempre caducará.
  • Un tiempo de espera agotado es el peor síntoma posible en este caso, porque parece un problema de firewall. La gente revisa reglas de red que nunca fueron el problema.
  • Los nombres de host de las bases de datos siguen el formato ep-<nombre>-<id>. El Postgres de Koyeb está basado en Neon, de ahí proviene ese patrón.

Más allá de eso, deliberadamente ordinario

Aquí no hay ningún mecanismo sofisticado, y pretender lo contrario solo induciría a error. Lo que hace la tarjeta es proporcionar la información correcta y no interferir.

  • Se aplica TLS a todos los hosts .pg.koyeb.app, independientemente de lo que indique la casilla de verificación, por lo que una cadena que haya perdido su modo SSL en el portapapeles seguirá viajando cifrada. El tráfico está cifrado; la cadena de certificados no se verifica.
  • No hay ningún pooler en la ruta. Algunos servicios Postgres sin servidor colocan un pooler en modo transacción delante y necesitan que las sentencias preparadas estén fijadas para funcionar; Koyeb no lo hace, por lo que el agente se conecta directamente y omite todo eso.
  • Los archivos koyeb-adm y koyebdb vienen precargados porque así es como comienza una base de datos Koyeb nueva. Un servicio completamente nuevo generalmente solo necesita la contraseña.
  • La conexión se guarda como PostgreSQL con Koyeb como nombre. No existe ningún tipo de conexión llamado Koyeb. — lo que también significa que una conexión Postgres simple que hayas hecho anteriormente a un host .pg.koyeb.app detectará la marca al instante.
-- Postgres ordinario, solo lectura 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;

Compartido por todos los conectores de bases de datos

Esto es cierto para todos los conectores de bases de datos.

  • Solo salida — El agente abre una conexión cifrada hacia Query Streams. No hay ningún puerto de entrada que reenviar, ni VPN, ni lista de direcciones IP permitidas, nada de su base de datos queda expuesto a Internet.
  • Las credenciales permanecen en su lugar. — El nombre de usuario y la contraseña de la base de datos se encuentran en la máquina donde instaló el agente. Query Streams nunca los recibe y no puede acceder a su base de datos por sí solo.
  • Solo lectura, obligatorio — Una instrucción a la vez, solo SELECT y similares. La escritura se rechaza en tu máquina antes de enviarse al servidor, en lugar de depender de un permiso que alguien haya configurado.
  • Despliega tantos agentes como quieras. — uno por sitio, región o nube. Todas las fuentes de datos que pueden ver llegan en un único menú desplegable, por lo que nadie tiene que saber qué agente aloja qué.

Lo que obtienes una vez que se guarda una consulta

  • Comparte la capacidad, no el SQL. — Un colega o un socio externo puede ejecutar su consulta y cambiar sus filtros sin ver nunca la instrucción que la respalda.
  • Filtros desde cualquier dirección — declárelas usted mismo como @variables, o deje que el conector detecte los valores literales que ya se encuentran en su cláusula WHERE y los ofrezca como menús desplegables.
  • Léelo desde cualquier lugar — Microsoft Excel, Google Sheets, Power BI, la API REST, los asistentes de IA a través de MCP, el Generador de consultas y Nova leen la misma consulta guardada.
  • Ejecutar varios a la vez — cinco consultas guardadas en cinco pestañas de hojas de cálculo, procesadas simultáneamente, independientemente del tamaño de los resultados.
  • Conéctalo a cualquier otra cosa que tengas conectada. — otra base de datos, una API empresarial o una carpeta de archivos, en una sola instrucción de solo lectura.

SQL entre fuentes

Une Koyeb al resto de tus datos.

Una sola instrucción puede abarcar Koyeb y tus otras conexiones simultáneamente. Cada fuente ejecuta solo la parte que puede, transmite el resultado y la unión se realiza de forma centralizada; las fuentes nunca se comunican entre sí y no se copia nada en ningún lugar.

3 conexiones · 3 agentes

Koyeb PostgreSQL sin servidor
Microsoft SQL Server Motor relacional
Raya Pagos y facturación

Una declaración

-- nada copiado, nada fusionado, nada programado
SELECCIONE   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
DESDE     aplicación koyebÓrdenes públicas1 f
ÚNASE A     erp_sql.dbo.clientes2   c ON c.id = f.customer_id
ÚNASE A     facturación.stripe.facturas3 i ON i.cliente = c.stripe_id
GRUPO POR región c
ORDENAR POR facturado DESC;

Las tres partes son conexión, esquema y tabla; el nombre de la conexión es el que le hayas dado. Las columnas son solo ilustrativas; tus tablas serán tus tablas. Se aplica el modo de solo lectura a cada elemento: solo SELECT, WITH y EXPLAIN, con un límite en la cantidad de datos que una sola fuente puede proporcionar para una sola consulta. Cómo funcionan las consultas federadas

Detalles de conexión

Lo que Koyeb necesita

Anfitrión
ep-<nombre>-<id>.<región>.pg.koyeb.app — observe el .pg., que es lo que la convierte en una base de datos en lugar de una aplicación.
Puerto
5432
Conductor
Npgsql, incluido por el agente; no hay nada que instalar en Koyeb.
Base de datos
koyebdb en un servicio nuevo y precargado como tal
Nombre de usuario
koyeb-adm en un servicio nuevo y prellenado como tal
TLS
Obligatorio y exigido por el agente para cada host .pg.koyeb.app. Cifrado; la cadena de certificados no está verificada.
Agrupación
Ninguno: Koyeb no necesita un punto final agrupado, por lo que el agente se conecta directamente.
Tiempo de espera de conexión agotado
30 segundos, un intento
Guardado como
PostgreSQL, con Koyeb como distintivo: no existe ningún tipo de conexión llamado Koyeb.
Esquema predeterminado
público, que es lo que conlleva una referencia federada

Un validador lleva esta tarjeta, y vale la pena explicar por qué merece una sección en lugar de una nota al pie. La mayoría de los errores de conexión se hacen evidentes: una contraseña incorrecta es un error de autenticación, un nombre de base de datos erróneo indica que la base de datos no existe. Apuntar un cliente Postgres al nombre de host de una aplicación no produce ninguno de esos problemas. Produce un tiempo de espera agotado, porque hay un host real en el otro extremo y simplemente no está escuchando a Postgres. Un tiempo de espera agotado se interpreta como un problema de red, por lo que la gente revisa las reglas del firewall, consulta con su equipo de plataforma sobre la salida y pierde una tarde entera por un error que falta en la extensión .pg. en un nombre de host. Detectarlo en el momento de pegar vale mucho más que las dos líneas de código que cuesta.

El resto de este conector es, sinceramente, poco destacable, y la página lo deja claro en lugar de añadirle detalles. Koyeb Postgres se basa en Neon, el agente se comunica con él mediante Npgsql a través de TLS forzado, y no hay ningún pooler que lo admita. Esa es toda la historia, y una historia corta y veraz es mejor que una larga y halagadora.

Para una consulta entre fuentes, Koyeb funciona como un PostgreSQL estándar. Una conexión que usted denominó koyeb_app se escribe como koyeb_app.public.orders y se une a una carpeta de archivos CSV, un sistema de registro local o una API de facturación en una sola instrucción de solo lectura, sin copiar ni programar nada.

Documentación del proveedor: www.koyeb.com

Preguntas frecuentes

Preguntas sobre Koyeb

¿Qué herramientas pueden leer datos de Koyeb a través de Query Streams?

Todas ellas, desde una única conexión: Excel, Google Sheets, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e informes programados. Conecte la base de datos una sola vez y todas las superficies leerán la misma conexión de solo lectura; no se requiere configuración por herramienta ni una segunda copia de los datos.

¿Tengo que abrir un puerto del firewall para mi base de datos Koyeb?

No. El agente de red de Query Streams se ejecuta dentro de su red y abre una única conexión cifrada saliente. No se monitoriza el tráfico entrante, no se requiere VPN y la base de datos conserva sus reglas de firewall existentes.

¿Pueden las consultas de flujo modificar los datos en Koyeb?

No. El agente aplica el modo de solo lectura en el punto de ejecución: una instrucción a la vez, solo SELECT y similares. Las credenciales permanecen en el agente y nunca se envían a Query Streams.

¿Qué necesita Query Streams para conectarse a Koyeb?

Un host accesible, un rol y su contraseña: el agente lleva el controlador, por lo que no se instala nada en la base de datos. Host: ep-<nombre>-<id>.<región>.pg.koyeb.app: observe el .pg., que es lo que lo convierte en una base de datos en lugar de una aplicación. Puerto: 5432. Controlador: Npgsql, llevado por el agente; no hay nada que instalar en Koyeb. Base de datos: koyebdb en un servicio nuevo y precargada como tal.

¿Puedo unir Koyeb con otra base de datos en la misma consulta?

Sí, se trata de una consulta federada. Una sola instrucción puede hacer referencia a Koyeb y a tus otras conexiones simultáneamente, escritas como conexión.esquema.tabla. Cada origen ejecuta solo la parte que puede y transmite el resultado; la unión se realiza de forma centralizada, por lo que los orígenes nunca se conectan entre sí y no se copia ni se programa nada. El modo de solo lectura se aplica a cada parte (solo SELECT, WITH y EXPLAIN) y existe un límite en la cantidad de datos que un origen puede transferir para una sola consulta. Las consultas federadas son una característica del plan; la página de consultas federadas muestra los límites actuales de origen y tamaño.

¿Conectar Koyeb es diferente a conectarse a PostgreSQL?

Solo la cadena de conexión. Koyeb utiliza el protocolo de red de PostgreSQL, por lo que los filtros, la programación, el uso compartido, los complementos de Excel y Google Sheets, y el servidor MCP funcionan de forma idéntica. La tarjeta Koyeb precarga la configuración de host, puerto y SSL que espera el proveedor.

¿Existe alguna guía para convertir Koyeb a Excel?

Sí, se trata de la guía de PostgreSQL, y es correcta para Koyeb tal como está escrita. Koyeb utiliza el protocolo de comunicación de PostgreSQL, por lo que la conexión de Koyeb a Excel, a Google Sheets y a cualquier otro destino sigue los mismos pasos. La única parte específica de Koyeb es la cadena de conexión, y la tarjeta de Koyeb la completa automáticamente.

Coloca a Koyeb donde se hace el trabajo.

Instale el agente, indíquele la ubicación de su base de datos y elija un destino.

Comienza gratis Todos los conectores

Solo lectura Solo salida Las credenciales permanecen en el agente.