Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

A Replit está atualizando os bancos de dados de desenvolvimento do Neon (um provedor de PostgreSQL serverless terceirizado) para o Helium, a infraestrutura PostgreSQL gerenciada pela própria Replit. Essa atualização é automática, ocorre uma vez por app e preserva todos os seus dados.
Esta atualização se aplica apenas aos bancos de dados de desenvolvimento. Os bancos de dados de produção usados pelos seus apps implantados não são afetados na maioria dos casos. No entanto, se o seu app implantado compartilha um banco de dados de desenvolvimento com outro app (comum em apps mais antigos copiados ou remixados), consulte Corrigir um app publicado usando um banco de dados compartilhado para etapas importantes.

​
O que está mudando

A atualização move seu banco de dados de desenvolvimento da infraestrutura do Neon para o Helium, que é executado diretamente na plataforma da Replit. Veja o que isso significa para você:
  • Menor latência: Seu banco de dados é executado na infraestrutura da Replit junto com seu app, reduzindo os tempos de conexão
  • Mais armazenamento: Seu limite de armazenamento aumenta de 10 GB para 20 GB
  • Mesmo mecanismo de banco de dados: O Helium usa PostgreSQL 16, a mesma versão do Neon — suas consultas, esquemas e dados funcionam da mesma forma
  • Conexão contínua: Sua variável de ambiente DATABASE_URL é atualizada automaticamente para apontar para o Helium
  • Conexão Neon salva: Sua string de conexão Neon anterior é salva como NEON_DATABASE_URL nos seus Segredos para referência. O banco de dados Neon antigo não é mais usado pelo seu app após a atualização e está programado para remoção após um período de carência temporário.
Para uma comparação completa entre o banco de dados Neon legado e o novo banco de dados Replit — incluindo diferenças em faturamento, capacidades de restauração, segurança de conexão e comportamento de remixagem — consulte Banco de Dados de Desenvolvimento Legado.

​
O que esperar durante a atualização

A atualização é executada automaticamente quando você abre seu Replit App no Editor de Projetos.
  1. Uma tela de progresso aparece com a mensagem “Atualizando seu banco de dados”
  2. Seus dados são copiados com segurança do Neon para o Helium. Nenhum dado é alterado ou perdido durante a transferência.
  3. A duração depende do tamanho do seu banco de dados — pode levar de alguns minutos a algumas horas para bancos de dados grandes
  4. Você pode manter a aba aberta ou fechá-la e voltar mais tarde
  5. Quando a atualização for concluída, uma caixa de diálogo de confirmação aparece: “Atualizamos seu banco de dados!”
Se a atualização encontrar um problema, ela é automaticamente ignorada para que você possa continuar trabalhando. A atualização será repetida na próxima vez que você abrir seu app.

​
O que fazer após a atualização

Para a maioria dos usuários, nenhuma ação é necessária. Seu app continua funcionando como antes.
Se o seu código se conecta ao banco de dados usando a variável de ambiente DATABASE_URL, nenhuma alteração é necessária. A variável é atualizada automaticamente para apontar para o seu novo banco de dados Helium.
Revise os itens a seguir se algum deles se aplicar ao seu app:
  • Strings de conexão Neon hardcoded: Se o seu código faz referência direta a uma string de conexão neon.tech, atualize-o para usar a variável de ambiente DATABASE_URL — process.env.DATABASE_URL em JavaScript ou os.environ['DATABASE_URL'] em Python. Consulte Conectar seu app a um banco de dados SQL para exemplos.
  • Roles PostgreSQL personalizadas: Se você criou roles de banco de dados personalizadas no Neon, essas roles e suas permissões são migradas automaticamente. No entanto, as senhas das roles não podem ser copiadas — você precisará redefinir as senhas de quaisquer roles personalizadas no novo banco de dados Helium.
  • Variáveis de ambiente PG individuais: As variáveis de ambiente PGHOST, PGPORT, PGUSER e PGPASSWORD são removidas após a atualização. Use a string de conexão DATABASE_URL, que contém todas as informações necessárias para se conectar.

​
Solução de problemas

​
Erros de conexão SSL após a atualização

Após a atualização, você pode ver erros de conexão como The server does not support SSL connections ou o socket desconectando inesperadamente. Isso acontece quando o código de conexão do seu banco de dados força um handshake SSL. O Neon exigia SSL para todas as conexões, mas o Helium é executado localmente junto com seu app e não usa SSL. Para corrigir isso, torne a configuração de SSL no seu código de conexão de banco de dados condicional ao ambiente. Isso garante que seu app se conecte sem SSL em desenvolvimento (Helium) e com SSL em produção (onde seu banco de dados de produção pode ainda exigir SSL). 
// Antes (quebra após a atualização)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// Depois (funciona em desenvolvimento e produção)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});
Se você usa um ORM como Drizzle, Prisma ou Sequelize, consulte sua documentação para saber como configurar as definições de SSL de forma condicional. O mesmo princípio se aplica — desative o SSL para o banco de dados de desenvolvimento e ative-o para a produção.

​
App implantado usando um banco de dados compartilhado

Apps mais antigos que foram copiados ou remixados na Replit podem compartilhar um banco de dados de desenvolvimento com o app original. No sistema Neon legado, fazer uma cópia de um app copiava o DATABASE_URL do app original, o que significava que ambos os apps e suas versões publicadas se conectavam ao mesmo banco de dados. Após a atualização do banco de dados, o banco de dados Neon do app original é desativado. Se o seu app publicado ainda usar essa URL de banco de dados compartilhada, ele pode parar de funcionar ou perder acesso aos seus dados.
O banco de dados compartilhado será desativado em 1 de junho de 2026. Atualize seu app publicado antes dessa data para evitar perda permanente de dados.

​
O que fazer a seguir

Se o seu app publicado for afetado, siga o guia dedicado passo a passo: Esse guia abrange:
  • Como confirmar se o seu app publicado ainda está usando a conexão Neon antiga
  • Quando usar Publicar ou Republicar com Criar banco de dados de produção
  • Como exportar e importar dados manualmente se o seu app publicado ainda depende do banco de dados compartilhado antigo
  • Considerações importantes sobre tempo de inatividade, gravações ativas e roles PostgreSQL personalizadas

​
Perguntas frequentes

Sim. Seus dados são copiados do Neon para o Helium — eles não são movidos ou excluídos durante a transferência. O banco de dados Neon original é preservado até que a atualização seja concluída com sucesso. Nenhum dado é alterado ou perdido.
A atualização é executada automaticamente quando você abre seu Replit App. Se encontrar algum problema, ela é automaticamente ignorada e você pode continuar trabalhando normalmente. A atualização será repetida na próxima vez que você abrir o app.
Se a atualização falhar, ela é automaticamente ignorada para que você possa continuar usando seu app com o banco de dados Neon existente. O sistema repetirá a atualização na próxima vez que você abrir o app. Se o problema persistir em várias tentativas, entre em contato com o suporte para obter assistência.
Após a atualização, DATABASE_URL aponta para o seu novo banco de dados Helium em vez do Neon. Sua string de conexão Neon anterior é salva como NEON_DATABASE_URL nos Segredos do seu app. Se o seu código usa DATABASE_URL para se conectar, nenhuma alteração é necessária — a variável é atualizada automaticamente.
Essas variáveis de ambiente individuais são removidas após a atualização. O Helium fornece os detalhes de conexão por meio da variável de ambiente DATABASE_URL, que contém todas as informações que seu app precisa para se conectar. Atualize qualquer código que faça referência a essas variáveis individuais para usar DATABASE_URL.
Sua string de conexão Neon anterior é salva como NEON_DATABASE_URL nos Segredos do seu app para referência. Na maioria dos casos, o banco de dados Neon antigo não é mais usado após a atualização e está programado para remoção em 1 de junho de 2026.Se o seu app implantado estava usando um banco de dados Neon compartilhado mais antigo de um app copiado ou remixado, esse banco de dados Neon pode ainda estar temporariamente disponível para que você possa exportar dados e migrar para seu próprio banco de dados de produção. Esse acesso é temporário, e o banco de dados compartilhado ainda será removido em 1 de junho de 2026, portanto, atualize seu app publicado o quanto antes.Se NEON_DATABASE_URL não estiver disponível nos seus Segredos e você precisar de ajuda para recuperar a string de conexão antiga, entre em contato com o suporte.
Na maioria dos casos, não — os bancos de dados de produção são gerenciados separadamente e não fazem parte desta atualização. No entanto, se o seu app publicado usa a URL do banco de dados de desenvolvimento diretamente (em vez de um banco de dados de produção separado), a atualização pode afetar seu app publicado. Isso é mais comum em apps mais antigos que foram copiados ou remixados, onde a cópia compartilhava o banco de dados do app original. Consulte Corrigir um app publicado usando um banco de dados compartilhado para saber como corrigir isso.

​
Próximos passos