Atualização do Banco de Dados

​

O que está mudando

• Menor latência: seu banco de dados roda na infraestrutura do 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 o 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 do Neon salva: sua string de conexão anterior do Neon é salva como NEON_DATABASE_URL nos seus Secrets para referência. O banco de dados antigo do Neon 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.

​

O que esperar durante a atualização

1. Uma tela de progresso aparece com a mensagem “Upgrading your database”
2. Seus dados são copiados de forma segura 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 depois
5. Quando a atualização for concluída, uma caixa de diálogo de confirmação aparece: “We’ve upgraded your database!”

​

O que fazer depois da atualização

• Strings de conexão do Neon fixas no código: se o seu código referencia diretamente uma string de conexão neon.tech, atualize-a para usar a variável de ambiente DATABASE_URL em vez disso — process.env.DATABASE_URL em JavaScript ou os.environ['DATABASE_URL'] em Python.
• Funções (roles) personalizadas do PostgreSQL: 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 de qualquer função personalizada no novo banco de dados Helium.
• Variáveis de ambiente individuais do PG: 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 a conexão.

​

Solução de problemas

​

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

// Before (breaks after upgrade)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// After (works in both development and production)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});

​

App publicado usando um banco de dados compartilhado

​

O que fazer a seguir

• Fix a published app using a shared database

• Como confirmar se o seu app publicado ainda está usando a antiga conexão do Neon
• Quando usar Publish ou Republish com Create production database
• Como exportar e importar dados manualmente se o seu app publicado ainda depende do antigo banco de dados compartilhado
• Precauções importantes sobre tempo de inatividade, gravações ativas e funções personalizadas do PostgreSQL

​

Perguntas frequentes

​

Próximos passos

• Database: saiba mais sobre a ferramenta de Banco de Dados do Replit e como gerenciar seu banco de dados
• Production Databases: entenda como os bancos de dados de produção diferem dos bancos de dados de desenvolvimento