> ## 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.
# Corrigir um app publicado que usa um banco de dados compartilhado
> Instruções passo a passo para atualizar um app publicado que ainda usa um banco de dados originalmente criado para outro app.
Alguns apps publicados mais antigos podem ainda estar conectados a um banco de dados de desenvolvimento que foi originalmente criado para um app diferente.
Isso pode acontecer com apps mais antigos que foram bifurcados ou remixados no Replit. No sistema legado do Neon, um fork podia continuar usando a conexão de banco de dados do app original. Como parte da mudança do Replit para isolar totalmente os bancos de dados de desenvolvimento e produção, bancos de dados de desenvolvimento compartilhados mais antigos estão sendo removidos e os apps publicados precisam migrar para seus próprios bancos de dados de produção.
Use este guia se o seu app publicado estiver exibindo erros de conexão com o banco de dados, ou se `DATABASE_URL` no painel Secrets ainda apontar para `neon.tech`.
O banco de dados compartilhado mais antigo será desativado em **8 de junho de 2026**. Atualize seu
app publicado antes dessa data para evitar tempo de inatividade ou perda permanente de dados.
## Antes de começar
Seu app publicado precisa do seu próprio **banco de dados de produção**. O banco de dados de desenvolvimento exibido no painel **Database** não deve ser usado diretamente por apps publicados.
Para corrigir isso, primeiro descubra em qual situação você se encontra:
* **Caso 1:** os dados que você deseja já estão presentes no banco de dados exibido no painel **Database** do seu app.
* **Caso 2:** o painel **Database** não mostra os dados que você precisa, porque seu app publicado ainda está usando o banco de dados de desenvolvimento compartilhado mais antigo.
## Como saber se o seu app publicado está usando um banco de dados compartilhado?
Seu app publicado é afetado se qualquer uma das seguintes situações for verdadeira:
* Seu app publicado mostra erros de conexão com o banco de dados após a atualização do banco de dados
* Seu app foi remixado a partir de outro app que tinha um banco de dados **antes de 9 de janeiro de 2026**
## Como verificar se o seu app publicado está usando o banco de dados compartilhado do app de origem?
### Passo 1: Abra o painel Database no app de origem
Obtenha o valor de `NEON_DATABASE_URL` ou de `DATABASE_URL` se `NEON_DATABASE_URL` não existir.
Nem todo app afetado terá `NEON_DATABASE_URL`. Se estiver ausente, isso
geralmente significa que você deve usar o `DATABASE_URL` atual dos Secrets do app
publicado, se ele ainda apontar para `neon.tech`.
### Passo 2: Abra o painel Publish no app publicado
Para verificar a URL do banco de dados do seu app publicado:
1. Abra seu app no Replit
2. Abra o painel **Publishing**
3. Abra **Adjust Settings**
4. Abra **Secrets**
5. Procure por `DATABASE_URL`
### Passo 3: Compare a URL do banco de dados do app de origem no Passo 1 com a do app remixado no Passo 2
Se forem iguais, seu app publicado está usando um banco de dados de desenvolvimento Neon compartilhado do app de origem.
## Como copiar dados do app de origem para o app publicado?
Depois de confirmar que o seu app publicado está usando o banco de dados de desenvolvimento compartilhado do app de origem, o próximo passo é transferir os dados necessários para o app publicado. Há dois cenários a considerar:
* Caso 1: o painel Database no app publicado já contém os dados necessários.
* Caso 2: o painel Database no app 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 de que você precisa já estiverem visíveis no painel **Database** do seu app.
#### Passo 1: Confirme que os dados estão presentes
Abra o painel **Database** no app publicado e verifique se as tabelas e os dados de que você precisa estão lá.
Se você não vê os dados de que precisa no painel Database, pare aqui. Você vai querer seguir as etapas do [Caso 2](#caso-2-o-painel-database-no-app-publicado-não-mostra-os-dados-que-você-precisa) para migrar seus dados corretamente.
#### Passo 2: Publique ou republique com um banco de dados de produção
1. Abra seu app no Project Editor
2. Selecione **Publish** ou **Republish**
3. Ative **Create production database**
4. Ative **Set up your production database with your current development data**
5. Complete o fluxo de publicação
A publicação cria uma nova versão do seu app publicado e define automaticamente o `DATABASE_URL` dela para o novo banco de dados de produção. Você não precisa atualizar esse secret manualmente durante esse fluxo.
Copiar para a produção sobrescreve quaisquer dados de produção existentes. Veja [Production
Databases](/pt/features/data-and-storage/production-databases) para
mais detalhes sobre como restaurar ou gerenciar seu banco de dados de produção.
#### Passo 3: Verifique o app publicado
Abra seu app publicado e confirme que seus dados estão acessíveis e que o app funciona corretamente.
### Caso 2: o painel Database no app 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 app publicado.
Se o seu app publicado ainda estiver conectado a um banco de dados de outro app, você verá um aviso de "external database detected" no painel Database.
Se pessoas ainda estiverem usando seu app e salvando novos dados, planeje uma
breve janela de manutenção antes de exportar os dados.
#### Passo 1: Exporte os dados do banco de dados antigo
Abra o **Shell** no Project Editor e execute:
```bash theme={null}
pg_dump -Fc "database_url" --no-owner --no-privileges -f backup.dump
```
`database_url` é a URL do banco de dados obtida em [Passo 1: Abra o painel Database no app de origem](#passo-1-abra-o-painel-database-no-app-de-origem).
### Passo 2: Remova o `DATABASE_URL` antigo dos Secrets do seu app
1. Abra a ferramenta **Secrets** no Project Editor
2. Encontre o `DATABASE_URL` antigo
3. Exclua-o
4. Atualize a página ou reabra o painel **Database**
Depois disso, seu app deve deixar de apontar para o banco de dados compartilhado antigo e usar seu banco de dados de desenvolvimento atual novamente.
### Passo 3: Importe os dados para o banco de dados de desenvolvimento atual do seu app
Depois que o secret `DATABASE_URL` antigo for removido, o banco de dados de desenvolvimento atual do seu app deve estar disponível novamente como `$DATABASE_URL` no Project Editor.
Volte ao **Shell** no Project Editor e execute:
```bash theme={null}
pg_restore --clean --if-exists --single-transaction --no-owner --no-privileges --exit-on-error -d "$DATABASE_URL" backup.dump
```
Isso carrega os dados exportados no banco de dados de desenvolvimento atual do seu app.
### Passo 5: Siga o Caso 1 para publicar ou republicar com um banco de dados de produção
Depois que o painel **Database** mostrar os dados corretos, siga o [Caso 1](#caso-1-o-painel-database-já-mostra-os-dados-que-você-precisa) para publicar ou republicar com **Create production database** e copiar esses dados para a produção.
### Passo 6: Verifique o app publicado
Abra seu app publicado e confirme que seus dados estão acessíveis e que o app funciona corretamente.
## Solução de problemas
### A importação falha porque as tabelas já existem
O comando `pg_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 (role) ou política
Se o seu banco de dados usa funções (roles) personalizadas do PostgreSQL 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 do Replit para o Helium 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 o `pg_restore`, [contate o suporte](https://replit.com/support) para obter ajuda.
### Eu já corrigi o app
Se o seu app publicado já tem seu próprio banco de dados de produção e está funcionando corretamente, você não precisa fazer mais nada.
## Precisa de mais ajuda?
Se você não tiver certeza de qual caso se aplica ao seu app, ou se tiver problemas durante a migração, [contate o suporte](https://replit.com/support).
## Documentos relacionados
* [Database upgrade](/pt/features/data-and-storage/database-upgrade)
* [Production databases](/pt/features/data-and-storage/production-databases)
* [Database](/pt/features/data-and-storage/sql-database)