Logotipo Koyeb

Postgres sem servidor fala PostgreSQL

Conectar Koyeb para Excel, Planilhas Google, IA e REST

Koyeb serverless Postgres em .pg.koyeb.app. O cartão detecta o erro mais comum: colar o nome do host do aplicativo em vez do nome do banco de dados.

Comece gratuitamente 13 destinos

Uma conexão, todas as superfícies

Para onde seus dados Koyeb podem ir

Koyeb mesas ao vivo · somente leitura
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · credenciais permanecem inalteradas

funciona em

O Query Streams lê dados do Postgres da Koyeb a partir do Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST através de uma única conexão somente leitura. A Koyeb hospeda aplicativos e bancos de dados em nomes de host adjacentes, sendo que apenas um deles é um banco de dados: os aplicativos residem em .koyeb.app e o Postgres em .pg.koyeb.app. A confusão entre esses dois é a causa mais comum de falha nessa conexão, portanto, o cartão verifica essa possibilidade e a informa de forma clara, em vez de permitir que a conexão falhe por tempo limite.

Koyeb é PostgreSQL na rede — o driver padrão, portanto, todas as instruções abaixo se aplicam sem alterações. A única parte específica da Koyeb é a string de conexão, abordada em detalhes de conexão.

  1. Para sua equipe, fornecedores e parceiros.

  2. Koyeb para Excel Microsoft Excel · Suplemento do Excel

    Importe os resultados do Koyeb em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Guia do PostgreSQL

  3. Koyeb para Planilhas Google Suplemento de planilhas

    Execute uma consulta Koyeb salva na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilharam a planilha podem atualizá-la por conta própria.

    Guia do PostgreSQL

  4. Pergunte a Nova sobre Koyeb Nova AI · texto para SQL

    Faça uma pergunta em inglês simples. O Nova já conhece suas tabelas Koyeb, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova

  5. Koyeb para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado Koyeb em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma tabela que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas

  7. API REST da Koyeb endpoint HTTP

    Publique uma consulta Koyeb como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Guia do PostgreSQL

  8. Koyeb para Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório exibirá os resultados do Koyeb em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI

  9. Koyeb para Airtable Plataforma de automação

    Sincronize as linhas do Koyeb com uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Guia do PostgreSQL

  10. Koyeb para Baserow Plataforma de automação

    Alimente uma tabela Baserow do Koyeb através do endpoint REST — hospedado localmente ou na nuvem Baserow.

    Guia do PostgreSQL

  11. Koyeb para SeaTable Plataforma de automação

    Mantenha uma base SeaTable atualizada com dados Koyeb sem exportar um arquivo ou expor o banco de dados.

    Guia do PostgreSQL

  12. Koyeb para Smartsheet Plataforma de automação

    Integre os resultados do Koyeb a uma planilha do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Guia do PostgreSQL

  13. Koyeb para Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com Koyeb por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Guia do PostgreSQL
  14. Para ferramentas de IA

  15. Servidor Koyeb MCP Clientes Claude, Cursor e MCP

    Conceda ao assistente de IA acesso somente leitura a Koyeb com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Guia do PostgreSQL
  16. Entregue às pessoas

  17. Koyeb alerta e relata Slack · Discord · E-mail · Webhook

    Programe uma consulta Koyeb para que os resultados sejam entregues no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Instale o Agente de Rede onde for mais conveniente. Ele abre uma conexão de saída e nunca escuta, portanto o Koyeb vê um cliente comum e sua rede não precisa de nenhuma regra de entrada.

02

Abra a aba Detalhes da Conexão no banco de dados no console do Koyeb e copie a string. Copie-a do banco de dados, não do aplicativo.

03

Cole o código. O host, a porta, o usuário, a senha e o banco de dados são lidos automaticamente, e o host é verificado em busca da extensão .pg, que o identifica como um ponto de extremidade de banco de dados.

04

As configurações padrão do Koyeb já estão preenchidas — koyeb-adm como usuário e koyebdb como banco de dados — portanto, um novo serviço geralmente precisa apenas da senha.

05

Salve. Microsoft Excel, Google Sheets, Power BI, MCP e REST leem os dados por meio dessa única conexão, ou você pode combiná-la com suas outras fontes em uma única instrução somente leitura.

Análise detalhada do recurso

O que Koyeb te dá

O nome do host do aplicativo não é o mesmo que o nome do host do banco de dados.

Koyeb é uma plataforma de aplicativos que também executa o Postgres, e os dois estão separados por apenas um rótulo. Esse é um erro muito fácil de cometer e que resulta em consequências graves, por isso o cartão o intercepta.

  • Os aplicativos são servidos a partir de .koyeb.app. Os bancos de dados são acessados em .pg.koyeb.app. A diferença está no ".pg." no meio.
  • Cole um host que termine em .koyeb.app sem essa informação e o cartão irá impedi-lo com essa explicação, em vez de permitir que você salve uma conexão que sempre expirará.
  • Um tempo limite excedido é o pior sintoma possível aqui, porque parece um problema de firewall. As pessoas vão verificar regras de rede que nunca foram o problema.
  • Os nomes de host do banco de dados seguem o formato ep-<nome>-<id>. O Postgres de Koyeb é baseado em Neon, e é daí que vem esse padrão.

Além disso, deliberadamente comum

Não há nenhum mecanismo sofisticado aqui, e fingir o contrário seria apenas enganar. O que o cartão faz é acertar nos detalhes e não interferir.

  • O TLS é imposto a todos os hosts .pg.koyeb.app, independentemente da configuração da caixa de seleção. Portanto, uma string que perdeu seu modo SSL na área de transferência ainda trafega criptografada. O tráfego é criptografado; a cadeia de certificados não é verificada.
  • Não há nenhum pooler no caminho. Alguns serviços Postgres sem servidor colocam um pooler de modo transacional na frente e precisam que as instruções preparadas sejam bloqueadas para funcionar; o Koyeb não faz isso, então o agente se conecta diretamente e ignora tudo isso.
  • Os arquivos koyeb-adm e koyebdb vêm preenchidos automaticamente porque é assim que um novo banco de dados Koyeb é iniciado. Um serviço totalmente novo geralmente precisa apenas da senha.
  • A conexão é salva como PostgreSQL com Koyeb mantido como identificador. Não existe um tipo de conexão chamado Koyeb. — o que também significa que uma conexão Postgres simples que você tenha feito anteriormente com um host .pg.koyeb.app reconhecerá a marca imediatamente.
-- Postgres comum, somente leitura 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;

Compartilhado por todos os conectores de banco de dados

Verdadeiro para todos os conectores de banco de dados.

  • Apenas envio — o agente abre uma conexão criptografada para o Query Streams. Nenhuma porta de entrada para encaminhar, nenhuma VPN, nenhuma lista de permissões de IP, nada sobre seu banco de dados exposto à internet.
  • As credenciais permanecem no mesmo lugar. — O nome de usuário e a senha do banco de dados ficam armazenados na máquina onde você instalou o agente. O Query Streams nunca os recebe e não consegue acessar seu banco de dados por conta própria.
  • Somente leitura, obrigatório — uma instrução por vez, apenas SELECT e similares. Uma operação de escrita é rejeitada em sua própria máquina antes mesmo de ser enviada ao servidor, em vez de depender de uma permissão que alguém se lembrou de definir.
  • Implante quantos agentes desejar. — uma por site, região ou nuvem. Todas as fontes de dados que eles podem visualizar aparecem em um único menu suspenso, para que ninguém precise saber qual agente hospeda o quê.

O que você obtém depois de salvar uma consulta.

  • Compartilhe a capacidade, não o SQL. — um colega ou um parceiro externo pode executar sua consulta e alterar seus filtros sem nunca ver a declaração por trás dela.
  • Filtros de ambas as direções — declare-as você mesmo como @variáveis ou deixe o conector identificar os valores literais já presentes na sua cláusula WHERE e oferecê-los como listas suspensas.
  • Leia de qualquer lugar — Microsoft Excel, Google Sheets, Power BI, a API REST, assistentes de IA via MCP, o Construtor de Consultas e o Nova leem a mesma consulta salva.
  • Execute várias ao mesmo tempo — cinco consultas salvas em cinco abas de planilha, transmitidas simultaneamente, independentemente do tamanho dos resultados.
  • Conecte-o a qualquer outro dispositivo que você já tenha utilizado. — outro banco de dados, uma API de negócios ou uma pasta de arquivos, em uma única instrução somente leitura.

SQL entre fontes diferentes

Junte Koyeb ao restante dos seus dados

Uma única instrução pode abranger Koyeb e suas outras conexões simultaneamente. Cada fonte executa apenas a parte que consegue, transmite o resultado de volta e a junção ocorre centralmente — as fontes nunca se comunicam entre si e nada é copiado para nenhum lugar.

3 conexões · 3 agentes

Koyeb Postgres sem servidor
Microsoft SQL Server Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- nada copiado, nada mesclado, nada agendado
SELECIONAR   c.região, COUNT(*) AS pedidos, SUM(i.valor_devido) AS faturado
DE     aplicativo koyeb.ordens.públicas1 f
JUNTAR     erp_sql.dbo.clientes2   c LIGADO c.id = f.id_do_cliente
JUNTAR     cobrança.stripe.faturas3 i LIGADO i.cliente = c.stripe_id
GRUPO POR c.região
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você escolheu. Colunas ilustrativas; suas tabelas serão suas tabelas. O acesso somente leitura se aplica a cada componente: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma consulta. Como funcionam as consultas federadas

Detalhes da conexão

Do que Koyeb precisa

Hospedar
ep-<nome>-<id>.<região>.pg.koyeb.app — observe o .pg., que indica que se trata de um banco de dados e não de um aplicativo.
Porto
5432
Motorista
Npgsql, incluído no agente — nada para instalar no lado da Koyeb
Banco de dados
koyebdb em um novo serviço e preenchido previamente dessa forma
Nome de usuário
koyeb-adm em um novo serviço e preenchido previamente como tal
TLS
Obrigatório e imposto pelo agente para todos os hosts .pg.koyeb.app. Criptografado; a cadeia de certificados não é verificada.
Agrupamento
Nenhum — Koyeb não precisa de um ponto de extremidade agrupado, então o agente se conecta diretamente.
Tempo limite de conexão
30 segundos, uma tentativa
Salvo como
PostgreSQL, com Koyeb mantido como um emblema — não existe um tipo de conexão chamado Koyeb.
Esquema padrão
público, que é o que uma referência federada carrega.

Um dos validadores carrega esse cartão, e vale a pena explicar por que ele merece uma seção inteira em vez de uma nota de rodapé. A maioria dos erros de conexão se anuncia: uma senha incorreta é um erro de autenticação, um nome de banco de dados incorreto indica que o banco de dados não existe. Apontar um cliente Postgres para o nome de host de um aplicativo não produz nenhum desses problemas. Produz um timeout, porque existe um host real na outra ponta e ele simplesmente não está aguardando o Postgres. Um timeout é interpretado como um problema de rede, então as pessoas verificam as regras do firewall, perguntam à equipe de plataforma sobre a saída de dados e perdem uma tarde inteira por causa de um ".pg." ausente no nome do host. Detectar o erro no momento da conexão vale muito mais do que as duas linhas de código que ele custa.

Sinceramente, todo o resto sobre este conector é bastante comum, e a página deixa isso claro em vez de inventar detalhes. O Koyeb Postgres é baseado em Neon, o agente se comunica com ele usando Npgsql por meio de TLS obrigatório, e não há nenhum pooler para acomodar. Essa é toda a história, e uma história verdadeira e concisa é melhor do que uma longa e lisonjeira.

Para uma consulta entre fontes diferentes, o Koyeb é um Postgres comum. Uma conexão que você chamou de koyeb_app é escrita como koyeb_app.public.orders e realiza um JOIN com uma pasta de arquivos CSV, um sistema de registro local ou uma API de faturamento em uma única instrução somente leitura — sem nenhuma cópia ou agendamento.

Documentação do fornecedor: www.koyeb.com

Perguntas frequentes

Perguntas sobre Koyeb

Quais ferramentas conseguem ler dados do Koyeb por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte o banco de dados uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para meu banco de dados Koyeb?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e o banco de dados mantém suas regras de firewall existentes.

É possível alterar dados usando Query Streams no Koyeb?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao Koyeb?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado no banco de dados. Host: ep-<nome>-<id>.<região>.pg.koyeb.app — observe o .pg., que o diferencia de um aplicativo para um banco de dados. Porta: 5432. Driver: Npgsql, carregado pelo agente — nada a ser instalado no Koyeb. Banco de dados: koyebdb em um serviço novo e preenchido automaticamente.

Posso adicionar Koyeb a outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar Koyeb e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — SELECT, WITH e EXPLAIN apenas — e há um limite para a quantidade de dados que uma origem pode fornecer para uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas contém os limites atuais de origem e tamanho.

Conectar-se ao Koyeb é diferente de conectar-se ao PostgreSQL?

Apenas a string de conexão. O Koyeb utiliza o protocolo de comunicação do PostgreSQL, portanto, filtros, agendamento, compartilhamento, os complementos do Excel e do Google Sheets e o servidor MCP funcionam de maneira idêntica. O cartão Koyeb preenche automaticamente as configurações de host, porta e SSL que o provedor espera.

Existe algum guia de Koyeb para Excel?

Sim, é o guia do PostgreSQL e está correto para o Koyeb conforme descrito. O Koyeb utiliza o protocolo de comunicação do PostgreSQL, portanto, a integração do Koyeb com o Excel, com o Google Sheets e com qualquer outro destino segue os mesmos passos. A única parte específica do Koyeb é a string de conexão, e o cartão Koyeb a preenche automaticamente.

Coloque Koyeb onde o trabalho acontece.

Instale o agente, aponte-o para seu banco de dados e escolha um destino.

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.