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.

O Replit está atualizando os bancos de dados de desenvolvimento do Neon (um provedor PostgreSQL serverless de terceiros) para o Helium, a própria infraestrutura PostgreSQL gerenciada do Replit. Esta atualização é automática, acontece uma vez por aplicativo e preserva todos os seus dados.
Esta atualização aplica-se apenas aos bancos de dados de desenvolvimento. Os bancos de dados de produção usados pelos seus aplicativos implantados não são afetados na maioria dos casos. No entanto, se o seu aplicativo implantado compartilha um banco de dados de desenvolvimento com outro aplicativo (comum em aplicativos mais antigos bifurcados ou remixados), veja Corrigir um aplicativo 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 do Replit. Isso significa:
  • Menor latência: Seu banco de dados é executado na infraestrutura do Replit junto com seu aplicativo, 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 que o Neon — suas consultas, schemas e dados funcionam da mesma maneira
  • Conexão transparente: Sua variável de ambiente DATABASE_URL é atualizada automaticamente para apontar para o Helium
  • String de conexão Neon salva: Sua string de conexão Neon anterior é salva como NEON_DATABASE_URL nos seus Secrets para referência. O banco de dados Neon antigo não é mais usado pelo seu aplicativo após a atualização e está agendado para remoção após um período de tolerância temporário.
Para uma comparação completa entre o banco de dados Neon legado e o novo banco de dados do Replit — incluindo diferenças em cobrança, capacidades de restauração, segurança de conexão e comportamento de remix — veja 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 Project Editor.
  1. Uma tela de progresso aparece com a mensagem “Upgrading your database”
  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, um diálogo de confirmação aparece: “We’ve upgraded your database!”
Se a atualização encontrar um problema, ela é automaticamente ignorada para que você possa continuar trabalhando. A atualização será repetida da próxima vez que você abrir seu aplicativo.

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

Para a maioria dos construtores, nenhuma ação é necessária. Seu aplicativo continua funcionando como antes.
Se 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 é automaticamente atualizada para apontar para o novo banco de dados Helium.
Revise o seguinte se qualquer um se aplicar ao seu aplicativo:
  • Strings de conexão Neon codificadas: Se seu código referencia diretamente uma string de conexão neon.tech, atualize-a para usar a variável de ambiente DATABASE_URL — process.env.DATABASE_URL em JavaScript ou os.environ['DATABASE_URL'] em Python. Veja Conectar seu aplicativo a um banco de dados SQL para exemplos.
  • Funções PostgreSQL personalizadas: Se você criou funções de banco de dados personalizadas no Neon, essas funções e suas permissões são migradas automaticamente. No entanto, as senhas das funções não podem ser copiadas — você precisará redefinir as senhas para quaisquer funções 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 em vez disso, 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 a desconexão inesperada do socket. 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 aplicativo e não usa SSL. Para corrigir isso, torne a configuração SSL na conexão do banco de dados condicional ao ambiente. Isso garante que seu aplicativo se conecte sem SSL em desenvolvimento (Helium) e com SSL em produção (onde seu banco de dados de produção ainda pode exigir). 
// 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ê usar um ORM como Drizzle, Prisma ou Sequelize, consulte sua documentação para saber como configurar as configurações SSL condicionalmente. O mesmo princípio se aplica — desative SSL para o banco de dados de desenvolvimento e ative para produção.

​
Aplicativo implantado usando um banco de dados compartilhado

Aplicativos mais antigos que foram bifurcados ou remixados no Replit podem compartilhar um banco de dados de desenvolvimento com o aplicativo original. No sistema Neon legado, bifurcar um aplicativo copiava o DATABASE_URL do aplicativo original, o que significava que ambos os aplicativos 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 aplicativo original é desativado. Se seu aplicativo publicado ainda usa essa URL de banco de dados compartilhado, seu aplicativo publicado pode parar de funcionar ou perder acesso aos seus dados.
O banco de dados compartilhado será encerrado em 15 de maio de 2026. Atualize seu aplicativo publicado antes disso para evitar perda permanente de dados.

​
O que fazer a seguir

Se seu aplicativo publicado for afetado, siga o guia passo a passo dedicado: Esse guia cobre:
  • Como confirmar se seu aplicativo publicado ainda está usando a conexão Neon antiga
  • Quando usar Publish ou Republish com Create production database
  • Como exportar e importar dados manualmente se seu aplicativo publicado ainda depende do banco de dados compartilhado antigo
  • Precauções importantes sobre tempo de inatividade, gravações ativas e funções 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 aplicativo.
Se a atualização falhar, ela é automaticamente ignorada para que você possa continuar usando seu aplicativo com o banco de dados Neon existente. O sistema repetirá a atualização na próxima vez que você abrir seu aplicativo. Se o problema persistir em várias tentativas, entre em contato com o suporte para obter ajuda.
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 Secrets do seu aplicativo. Se 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 seus detalhes de conexão por meio da variável de ambiente DATABASE_URL, que contém todas as informações que seu aplicativo precisa para se conectar. Atualize qualquer código que referencie essas variáveis individuais para usar DATABASE_URL em vez disso.
Sua string de conexão Neon anterior é salva como NEON_DATABASE_URL nos Secrets do seu aplicativo para referência. Na maioria dos casos, o banco de dados Neon antigo não é mais usado após a atualização e está agendado para remoção em 15 de maio de 2026.Se seu aplicativo implantado estava usando um banco de dados Neon compartilhado mais antigo de um aplicativo bifurcado ou remixado, esse banco de dados Neon ainda pode estar temporariamente disponível para que você possa exportar dados e migrar para o seu próprio banco de dados de produção. Esse acesso é temporário, e o banco de dados compartilhado ainda será removido em 15 de maio de 2026, então atualize seu aplicativo publicado o mais rápido possível.Se NEON_DATABASE_URL não estiver disponível nos seus Secrets 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 seu aplicativo 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 aplicativo publicado. Isso é mais comum em aplicativos mais antigos que foram bifurcados ou remixados, onde o fork compartilhava o banco de dados do aplicativo original. Veja Corrigir um aplicativo publicado usando um banco de dados compartilhado para como corrigir isso.

​
Próximos passos