Bancos de dados de desenvolvimento e produção

​

Como eles se comparam

​

Crie um banco de dados de produção ao publicar

• Infraestrutura atual (Helium): o Replit cria automaticamente um banco de dados de produção quando você publica, desde que seu banco de dados de desenvolvimento contenha dados.
• Bancos de dados de desenvolvimento legados do Neon: você cria o banco de dados de produção a partir das configurações de publicação. Abra Database settings ao publicar, ative Create production database e, opcionalmente, ative Set up your production database with your current development data para copiar seus dados de desenvolvimento.

​

Descubra qual banco de dados seu app usa

• Project Editor: no seu workspace, no Shell e nas sessões do Agent, DATABASE_URL aponta para o banco de dados de desenvolvimento. O Replit a conecta automaticamente, então, na infraestrutura atual, ela não aparece em Secrets.
• App publicado: quando você publica, seu app recebe um DATABASE_URL separado que aponta para o banco de dados de produção.

​

Peça ao Agent para verificar

Check which database my app uses, without showing any secret values or changing anything:
1. Find the environment variable my code reads to connect to its database (for example DATABASE_URL) and show me the file and line.
2. Check whether my Secrets include a DATABASE_URL I added myself or any other database connection, and list only the names.
3. Run a read-only query on my production database: list its tables and show the five newest rows in my main table, so I can compare them with my live app.

​

Verifique na ferramenta Database e em Publishing

1

Abra seu banco de dados de produção

Na ferramenta Database, abra o menu de bancos de dados ao lado de All Databases e selecione Production.

2

Encontre um registro do seu app em produção

Abra My Data e procure algo que você criou recentemente no seu app publicado, como uma nova conta ou pedido. Se você conseguir vê-lo, seu app publicado grava neste banco de dados. A produção abre em modo somente leitura, então navegar por ela é seguro.

3

Compare as configurações de conexão

Abra a aba Settings do banco de dados de produção e encontre Connection string. Depois abra Publishing, selecione Adjust settings e encontre DATABASE_URL em Production app secrets. Revele cada valor e verifique se ambos apontam para o mesmo host. Para a maioria dos apps, isso significa o mesmo ID de endpoint, a parte que começa com ep-. Um endereço com pooling adiciona -pooler depois do ID, então as strings completas não precisam ser exatamente iguais.

Ambos os valores incluem a senha do seu banco de dados. Compare-os você mesmo; não os cole em um chat, ticket de suporte ou captura de tela.

4

Verifique os Secrets em busca de outro banco de dados

Abra Secrets. A conexão integrada do Replit não aparece ali. Se você vir um DATABASE_URL que você mesmo adicionou, ou outra conexão de banco de dados, como SUPABASE_DATABASE_URL, seu app pode usar esse banco de dados. Pergunte ao Agent qual deles seu código lê. Um secret NEON_DATABASE_URL é a conexão anterior do seu banco de dados de desenvolvimento, salva durante a atualização da infraestrutura do banco de dados. Seu app só o usa se o seu código o ler.

​

O que os resultados significam

​

Pooling de conexões

​

Fazendo alterações seguras no seu banco de dados de produção

• Remover colunas ou tabelas que ainda contêm dados
• Alterar tipos de dados de colunas, o que pode falhar se os valores existentes não forem convertidos
• Adicionar campos obrigatórios sem valores padrão a tabelas que já têm linhas
• Renomear tabelas ou colunas: confirme a renomeação quando o Publish perguntar, ou os dados serão descartados
• Adicionar restrições de unicidade a tabelas cujas linhas existentes possam violá-las

​

Teste as alterações com uma prévia de publicação

• Verificar se seu app ainda funciona com as alterações de banco de dados aplicadas, em todos os seus principais fluxos de usuário
• Confirmar que os dados existentes foram migrados corretamente e que os novos campos contêm os valores esperados
• Observar regressões de desempenho nos tempos de resposta das consultas

​

Faturamento e uso de recursos

​

Removendo um banco de dados de produção

​

Banco de dados de desenvolvimento legado

​

Atualização da infraestrutura do banco de dados

• Menor latência e mais armazenamento: seu banco de dados roda na infraestrutura do Replit junto com seu app, e seu limite de armazenamento aumenta de 10 GB para 20 GB, ou para 50 GB nos planos Pro e Enterprise.
• 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 atualizada automaticamente: DATABASE_URL é atualizado para apontar para o Helium. Sua string de conexão anterior do Neon é salva como NEON_DATABASE_URL nos seus Secrets para referência.
• Variáveis PG individuais removidas: PGHOST, PGPORT, PGUSER e PGPASSWORD são removidas. Use DATABASE_URL em vez disso.

• Strings de conexão do Neon fixas no código: atualize o código que referencia diretamente uma string de conexão neon.tech para usar a variável de ambiente DATABASE_URL em vez disso.
• Funções (roles) personalizadas do PostgreSQL: as funções e permissões são migradas automaticamente, mas as senhas das funções não podem ser copiadas. Redefina as senhas de qualquer função personalizada no novo banco de dados.

​

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,
});

​

Apps bifurcados que compartilhavam um banco de dados

​

Próximos passos

• Como o Publish atualiza seu banco de dados de produção: Revise, teste e aprove alterações de esquema ao publicar.
• Recuperação de dados: Restaure dados de desenvolvimento ou produção.
• Detalhes de conexão: Encontre a string de conexão do seu banco de dados.
• Trabalhe com seus dados: Navegue, edite e consulte seus dados.