Alguns aplicativos publicados mais antigos ainda podem estar conectados a um banco de dados de desenvolvimento que foi criado originalmente para um aplicativo diferente. Isso pode acontecer com aplicativos mais antigos que foram bifurcados ou remixados no Replit. No sistema Neon legado, um fork podia continuar usando a conexão de banco de dados do aplicativo original. Como parte do movimento do Replit para isolar completamente os bancos de dados de desenvolvimento e produção, os bancos de dados de desenvolvimento compartilhados mais antigos estão sendo removidos e os aplicativos publicados precisam migrar para seus próprios bancos de dados de produção. Use este guia se seu aplicativo publicado estiver mostrando erros de conexão de banco de dados, ou seDocumentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
DATABASE_URL no painel de Secrets ainda apontar para neon.tech.
Antes de começar
Seu aplicativo publicado precisa do seu próprio banco de dados de produção. O banco de dados de desenvolvimento mostrado no painel Database não deve ser usado diretamente por aplicativos publicados.
- Caso 1: Os dados que você quer já estão presentes no banco de dados mostrado no painel Database do seu aplicativo.
- Caso 2: O painel Database não mostra os dados que você precisa, porque seu aplicativo publicado ainda está usando o banco de dados de desenvolvimento compartilhado mais antigo.
Como saber se seu aplicativo publicado está usando um banco de dados compartilhado?
Seu aplicativo publicado é afetado se qualquer um dos seguintes for verdadeiro:- Seu aplicativo publicado mostra erros de conexão de banco de dados após a atualização do banco de dados
- Seu aplicativo foi remixado de outro aplicativo que tinha um banco de dados antes de 9 de janeiro de 2026
Como verificar se seu aplicativo publicado está usando o banco de dados compartilhado do aplicativo de origem?
Etapa 1: Abra o painel Database no aplicativo de origem
NEON_DATABASE_URL ou de DATABASE_URL se NEON_DATABASE_URL não existir.
Nem todo aplicativo afetado terá
NEON_DATABASE_URL. Se estiver faltando, isso
geralmente significa que você deve usar o DATABASE_URL atual nos Secrets do aplicativo
publicado se ainda apontar para neon.tech.Etapa 2: Abra o painel Publish no aplicativo publicado
- Abra seu aplicativo no Replit
- Abra o painel Publishing
- Abra Adjust Settings
- Abra Secrets
- Procure por
DATABASE_URL
Etapa 3: Compare a URL do banco de dados do aplicativo de origem na Etapa 1 e do aplicativo remix na Etapa 2
Se forem iguais, seu aplicativo publicado está usando um banco de dados de desenvolvimento Neon compartilhado do aplicativo de origem.Como copiar dados do aplicativo de origem para o aplicativo publicado?
Após confirmar que seu aplicativo publicado está usando o banco de dados de desenvolvimento compartilhado do aplicativo de origem, a próxima etapa é transferir os dados necessários para o aplicativo publicado. Há dois cenários a considerar:- Caso 1: O painel Database no aplicativo publicado já contém os dados necessários.
- Caso 2: O painel Database no aplicativo publicado não contém os dados necessários.
Caso 1: O painel Database já mostra os dados que você precisa
Este é o caminho mais fácil se os dados que você precisa já estiverem visíveis no painel Database do seu aplicativo.Etapa 1: Confirme que os dados estão presentes
Etapa 2: Publique ou republique com um banco de dados de produção
- Abra seu aplicativo no Project Editor
- Selecione Publish ou Republish
- Ative Create production database
- Ative Set up your production database with your current development data
- Complete o fluxo de publicação
DATABASE_URL para o novo banco de dados de produção. Você não precisa atualizar esse secret manualmente durante este fluxo.
Etapa 3: Verifique o aplicativo publicado
Abra seu aplicativo publicado e confirme que seus dados estão acessíveis e que o aplicativo funciona corretamente.Caso 2: O painel Database no aplicativo publicado não mostra os dados que você precisa
Siga estas etapas para exportar os dados se você não vir os dados necessários no painel Database do seu aplicativo publicado. Se seu aplicativo publicado ainda estiver conectado a um banco de dados de outro aplicativo, você verá um aviso de “external database detected” no painel Database.
Etapa 1: Exporte os dados do banco de dados antigo
database_url é a URL do banco de dados obtida na Etapa 1: Abra o painel Database no aplicativo de origem.
Etapa 2: Remova o DATABASE_URL antigo dos Secrets do seu aplicativo
- Abra a ferramenta Secrets no Project Editor
- Encontre o
DATABASE_URLantigo - Exclua-o
- Atualize a página ou reabra o painel Database
Etapa 3: Importe os dados para o banco de dados de desenvolvimento atual do seu aplicativo
DATABASE_URL antigo for removido, o banco de dados de desenvolvimento atual do seu aplicativo deve estar disponível novamente como $DATABASE_URL no Project Editor.
Retorne ao Shell no Project Editor e execute:
Etapa 5: Siga o Caso 1 para publicar ou republicar com um banco de dados de produção
Assim que o painel Database mostrar os dados corretos, siga o Caso 1 para publicar ou republicar com Create production database e copiar esses dados para produção.Etapa 6: Verifique o aplicativo publicado
Solução de problemas
A importação falha porque as tabelas já existem
O comandopg_restore --clean --if-exists acima descarta e recria os objetos correspondentes do dump antes de restaurá-los.
A importação falha com erros de função ou política
Se o seu banco de dados usa funções PostgreSQL personalizadas ou políticas baseadas em funções, a importação pode falhar porque essas funções ainda não existem no novo banco de dados. A migração automática Helium do Replit tenta recriar stubs de funções antes de restaurar, mas o processo manual acima não faz isso. Se você encontrar erros relacionados a funções durante opg_restore, entre em contato com o suporte para obter ajuda.