Logotipo do Heroku Postgres

Postgres gerenciado fala PostgreSQL

Conectar Heroku Postgres para Excel, Planilhas Google, IA e REST

Heroku Postgres a partir do seu DATABASE_URL. Os bancos de dados do Heroku ficam em hosts EC2 sem nome, então o cartão é como a conexão sabe que é o Heroku.

Uma conexão, todas as superfícies

Para onde seus dados do Heroku podem ir

O Query Streams lê dados do PostgreSQL do Heroku 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. O Heroku é o caso atípico entre os servidores PostgreSQL gerenciados predefinidos: seus bancos de dados respondem por meio de nomes de host EC2 simples, sem qualquer especificação de provedor. Assim, diferentemente dos demais servidores aqui apresentados, a conexão não pode ser reconhecida como sendo do Heroku pelo endereço. A escolha deste servidor é o que o torna confiável, e é por isso que vale a pena escolhê-lo em vez do servidor PostgreSQL genérico.

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

  1. Para sua equipe, fornecedores e parceiros.
  2. Do Heroku ao Excel Microsoft Excel · Suplemento do Excel

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

    Guia do PostgreSQL
  3. Heroku para Planilhas Google Suplemento de planilhas

    Execute uma consulta Heroku 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 à Nova sobre o Heroku. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas do Heroku, 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. Heroku para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado do Heroku em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma grade 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 do Heroku endpoint HTTP

    Publique uma consulta Heroku 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. Heroku 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 Heroku em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI
  9. Do Heroku para o Airtable Plataforma de automação

    Sincronize linhas do Heroku 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. Heroku para Baserow Plataforma de automação

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

    Guia do PostgreSQL
  11. Heroku para SeaTable Plataforma de automação

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

    Guia do PostgreSQL
  12. Do Heroku para o Smartsheet Plataforma de automação

    Integre os resultados do Heroku 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. Heroku para Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com o Heroku 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 Heroku MCP Clientes Claude, Cursor e MCP

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

    Guia do PostgreSQL
  16. Entregue às pessoas
  17. Alertas e relatórios do Heroku Slack · Discord · E-mail · Webhook

    Agende uma consulta no Heroku e receba os resultados no Slack, Discord, por e-mail ou por meio de 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 fica em modo de escuta, então o Heroku o vê como um cliente comum e sua rede não precisa de nenhuma regra de entrada.

02

Copie o DATABASE_URL das Configurações do aplicativo, depois de "Variáveis de Configuração", e cole-o no primeiro campo. O host, a porta, o banco de dados, o nome de usuário e a senha serão lidos automaticamente a partir dele.

03

Deixe a opção "Usar SSL" ativada antes de executar o teste. O Heroku espera uma conexão criptografada e, em uma conexão nova, essa caixa de seleção é o que a fornece.

04

Salvar. O selo do Heroku é gravado nesse momento, o que permite que a conexão seja reconhecida posteriormente.

05

Volte e cole novamente após a rotação das credenciais do Heroku. Enquanto isso, o Microsoft Excel, o Google Sheets, o Power BI, o MCP e a API REST leem tudo através dessa mesma conexão.

Análise detalhada do recurso

O que o Heroku te oferece

Nada no nome do host indica que seja Heroku.

Todas as outras placas Postgres gerenciadas aqui conseguem reconhecer seu próprio serviço pelo endereço. Esta não consegue, e vale a pena entender essa diferença.

  • O Heroku Postgres responde a nomes EC2 simples no formato ec2-12-34-56-78.compute-1.amazonaws.com. Não há "heroku" no nome do host para fazer a correspondência.
  • Assim, a identidade do provedor é registrada quando você salva a partir deste cartão, em vez de ser inferida a partir de onde você se conectou. É isso que gera o selo e o ícone posteriormente.
  • A consequência prática: uma conexão PostgreSQL simples que você tenha feito anteriormente com um banco de dados Heroku não incorporará a marca Heroku retroativamente. Cartões como Neon e Koyeb fazem exatamente isso a partir de seus nomes de host. — Heroku é um caso em que não funciona.
  • Se você deseja manter a identidade visual em uma conexão mais antiga, recrie-a a partir deste cartão. Nada muda em relação ao caminho dos dados; trata-se apenas de uma diferença na rotulagem.

Certificados autoassinados e o que significa criptografado aqui.

O Heroku protege seus bancos de dados com seus próprios certificados, o que define o que o agente pode verificar de forma eficaz.

  • O uso de SSL está ativado por padrão e a conexão é criptografada. O agente exige TLS, em vez de apenas oferecê-lo.
  • A cadeia de certificados não foi verificada. Os certificados do Heroku são autoassinados, portanto, uma verificação completa rejeitaria uma conexão perfeitamente correta. — exigir criptografia sem validar a cadeia é a configuração que corresponde ao serviço.
  • Leia isso como uma proteção contra qualquer pessoa que esteja lendo o tráfego, não como prova do que você alcançou. É a mesma postura que o cartão ferroviário adota, e pelo mesmo motivo.
  • Deixe a caixa de seleção como está antes do primeiro teste. Em uma conexão que ainda não foi salva, essa caixa de seleção é a única coisa que ativa a criptografia.

A rotação é algo que você encontrará

O Heroku altera as credenciais do banco de dados durante a manutenção, e o agente armazena as informações que você forneceu.

  • Quando o Heroku realiza uma rotação, o DATABASE_URL muda e as credenciais armazenadas param de funcionar. O aviso é exibido na tela de login, em vez de deixar você descobrir por conta própria.
  • A solução é colar novamente o DATABASE_URL atual no lugar do antigo. Tudo o que estiver a jusante — consultas salvas, agendamentos, compartilhamentos — continuam funcionando, porque apontam para a conexão em vez de para as credenciais.
  • Não há sincronização automática. O Query Streams não lê suas variáveis de configuração do Heroku, portanto, a colagem repetida é uma etapa manual e é importante saber disso para evitar surpresas.
  • A sequência de caracteres colada em si nunca é armazenada. Ela é lida uma única vez para preencher o formulário e depois descartada, portanto a senha fica armazenada em um único local, em vez de dois.
-- Postgres comum, somente leitura, sobre TLS 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-se ao Heroku para acessar o restante dos seus dados.

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

3 conexões · 3 agentes

Heroku Postgres Postgres gerenciado
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 heroku.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

O que a Heroku precisa

Hospedar
Um nome EC2 simples como ec2-12-34-56-78.compute-1.amazonaws.com — nada nele identifica o Heroku.
Porto
5432
Motorista
O Npgsql é fornecido pelo agente — nada precisa ser instalado no Heroku.
Colar formato
DATABASE_URL das Configurações e, em seguida, das Variáveis de Configuração, como um URI postgres://
TLS
Obrigatório. Criptografado; a cadeia de certificados não é verificada, que é o que os certificados autoassinados do Heroku exigem.
Agrupamento
Nenhuma. O agente não aplica nenhuma adaptação de pool para o Heroku.
Credenciais
Rotacionado pelo Heroku durante a manutenção. Cole novamente o DATABASE_URL atual quando isso acontecer — não há sincronização automática.
Salvo como
PostgreSQL, com Heroku mantido como um emblema. Como o nome do host é anônimo, esse emblema só existe se você salvou a partir deste cartão.
Esquema padrão
público, que é o que uma referência federada carrega.

O Heroku é a configuração predefinida que torna o design subjacente visível. Cada cartão aqui salva como seu mecanismo real e mantém o provedor como um rótulo, e para a maioria deles o rótulo é uma garantia extra — o nome do host já teria revelado tudo de qualquer maneira. O Heroku não possui essa alternativa, então o rótulo é o único registro. É por isso que recriar uma conexão antiga por meio deste cartão é a solução para a falta de identidade visual, e por isso não há como fazer isso retroativamente.

O aviso de rotação é o recurso mais útil na prática. A rotação de credenciais do Heroku durante a manutenção é uma operação normal, não uma falha, e o erro resultante é um erro de autenticação que se parece exatamente com alguém que alterou a senha. Saber de antemão que basta colar novamente o DATABASE_URL transforma uma interrupção confusa em uma tarefa de trinta segundos.

Para uma consulta entre fontes diferentes, o Heroku usa o Postgres padrão. Uma conexão chamada `heroku_app` é escrita como `heroku_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.heroku.com

Perguntas frequentes

Perguntas sobre o Heroku Postgres

Quais ferramentas conseguem ler dados do Heroku Postgres por meio de Query Streams?

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 Heroku Postgres?

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 com o Query Streams no Heroku Postgres?

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 Heroku Postgres?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado no banco de dados. Host: Um nome EC2 simples, como ec2-12-34-56-78.compute-1.amazonaws.com — nada nele identifica o Heroku. Porta: 5432. Driver: Npgsql, carregado pelo agente — nada para instalar no Heroku. Formato de colagem: DATABASE_URL das Configurações e, em seguida, Variáveis de Configuração, como um URI postgres://.

Posso fazer um join entre o Heroku Postgres e outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Heroku Postgres e suas outras conexões simultaneamente, escrita 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 — apenas SELECT, WITH e EXPLAIN — 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 Heroku Postgres é diferente de conectar-se ao PostgreSQL?

Apenas a string de conexão. O Heroku Postgres utiliza o protocolo de comunicação 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 do Heroku preenche automaticamente as configurações de host, porta e SSL que o provedor espera.

Existe algum guia de migração do Heroku para o Excel?

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

Instale o Heroku onde o trabalho acontece.

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

Somente leitura Apenas envio As credenciais permanecem com o agente.