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.

Os bancos de dados de produção são dedicados aos seus dados ao vivo que alimentam seus Replit Apps publicados. Ao contrário dos bancos de dados de desenvolvimento onde você experimenta e cria recursos, os bancos de dados de produção mantêm seus dados do mundo real em segurança enquanto você continua desenvolvendo, garantindo confiabilidade e desempenho. Entender como trabalhar com bancos de dados de produção é essencial para criar aplicações robustas que possam evoluir e escalar sem interromper seus usuários.
Production database management interface

O que são Bancos de Dados de Produção?

Os bancos de dados de produção são os bancos de dados operacionais e ao vivo que servem usuários reais e seus dados. Eles diferem significativamente dos bancos de dados de desenvolvimento de várias maneiras importantes:

Bancos de Dados de Produção vs. Desenvolvimento

AspectoBanco de Dados de DesenvolvimentoBanco de Dados de Produção
PropósitoExperimentação e desenvolvimento de recursosServir usuários reais e armazenar dados de negócios
DadosDados de teste, registros fictícios, pequenos conjuntos de dadosDados de usuários reais, informações críticas para os negócios
DesempenhoOtimizado para velocidade de desenvolvimentoOtimizado para confiabilidade e experiência do usuário
AlteraçõesAlterações frequentes de schema, iteração rápidaAlterações cuidadosas e planejadas por meio de migrações de dados e estratégias de rollback
Tempo de inatividadeAceitável durante o desenvolvimentoDeve ser minimizado ou eliminado
BackupOpcional para testesCrítico para a continuidade dos negócios
O Agent não consegue modificar o banco de dados de produção; essa restrição existe para que seu banco de dados de produção permaneça seguro.O Agent pode fazer edições no seu banco de dados de desenvolvimento. No momento da publicação, quaisquer alterações feitas com o Agent na estrutura do seu banco de dados de desenvolvimento (ou seja, adição e exclusão de colunas/tabelas) serão aplicadas ao seu banco de dados de produção.Você pode editar manualmente seus dados de produção a qualquer momento acessando o painel do banco de dados > banco de dados de produção > My data e ativando Edit

Tecnologia e Infraestrutura do Banco de Dados

Os bancos de dados de produção no Replit usam as mesmas ferramentas de Banco de Dados e fluxo de publicação que nossa oferta padrão de Banco de Dados SQL. Eles executam PostgreSQL 16 ou 17 hospedado no Neon, fornecendo confiabilidade e desempenho em nível empresarial.

Relação com o Banco de Dados SQL do Replit

Os bancos de dados de produção se integram à mesma experiência do Banco de Dados do Replit enquanto usam infraestrutura específica para produção:
  • PostgreSQL 16 ou 17: Banco de dados relacional padrão do setor com recursos avançados
  • Infraestrutura Neon: Plataforma de banco de dados serverless que fornece escalonamento automático e otimização de custos
  • Ferramentas integradas: Acesso ao SQL runner, Drizzle Studio e ferramentas de gerenciamento visual de dados
  • Variáveis de ambiente: Gerenciamento seguro de conexão por meio de credenciais geradas automaticamente
Para informações detalhadas sobre recursos do banco de dados, configuração de conexão e especificações técnicas, veja a documentação do Banco de Dados SQL.
Os bancos de dados de produção são executados no Neon, enquanto os bancos de dados de desenvolvimento (desde 4 de dezembro de 2025) são executados na própria infraestrutura do Replit. Os dois ambientes diferem em variáveis de ambiente disponíveis, limites de armazenamento e comportamento de conexão. Veja a seção Banco de Dados de Desenvolvimento Legado para detalhes sobre a pilha do lado do desenvolvimento.

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

Ao publicar atualizações no seu Replit App que incluem alterações no banco de dados, você pode encontrar cenários onde o planejamento cuidadoso é essencial para evitar tempo de inatividade ou perda de dados.

Alterações Não Retrocompatíveis

Algumas alterações no banco de dados podem quebrar a compatibilidade com o código do aplicativo existente. Essas alterações requerem tratamento especial para garantir implantações tranquilas.
Você pode notar um breve tempo de inatividade para seu aplicativo publicado durante a publicação. Esse tempo de inatividade ocorre porque as alterações no banco de dados às vezes requerem a interrupção temporária do seu aplicativo para evitar conflitos e garantir atualizações seguras. Interromper o aplicativo durante essas atualizações ajuda a proteger seus dados contra perda ou corrupção enquanto as alterações são aplicadas.

Alterações Não Retrocompatíveis Comuns

Os seguintes tipos de alterações normalmente requerem estratégias de publicação cuidadosas:
  • Remover colunas do banco de dados que o código do aplicativo ainda referencia
  • Alterar tipos de dados de colunas de maneiras que o código existente não consegue lidar
  • Adicionar campos obrigatórios sem valores padrão a tabelas existentes
  • Renomear tabelas ou colunas que quebram as consultas existentes
  • Modificar restrições que poderiam rejeitar a lógica do aplicativo existente

Visualizações de Implantação

Antes de publicar alterações no banco de dados para produção, o Replit fornece ferramentas para testar suas alterações com segurança em um ambiente de visualização. Uma visualização de implantação é uma cópia temporária e isolada do seu ambiente de produção onde você pode testar alterações no banco de dados e atualizações do aplicativo antes que afetem usuários reais. Este ambiente de visualização espelha sua configuração de produção, mas opera de forma independente. Ele pode ajudá-lo a identificar possíveis problemas antecipadamente e garantir que suas alterações funcionem corretamente antes de entrar em produção. Testar sua implantação no ambiente de visualização é crucial para identificar problemas antes que impactem seus usuários. Siga estas etapas para garantir que suas alterações no banco de dados funcionem corretamente: 1. Teste Funcional
  • Verifique se seu aplicativo ainda funciona corretamente com as alterações no banco de dados aplicadas
  • Teste todos os principais fluxos de usuário para garantir que a funcionalidade permanece intacta
  • Verifique se os dados são exibidos corretamente após as modificações de schema
2. Verificação de Integridade dos Dados
  • Confirme que os dados existentes foram adequadamente migrados ou transformados
  • Verifique se os novos campos contêm valores esperados ou padrões adequados
  • Teste casos extremos onde os dados podem não estar em conformidade com as novas restrições
3. Validação de Desempenho
  • Monitore os tempos de resposta das consultas no ambiente de visualização
  • Verifique se os novos índices estão sendo usados efetivamente
  • Confirme que as alterações não introduzem regressões de desempenho

Restauração ponto a ponto

Para bancos de dados de produção, você pode restaurar seu banco de dados para um ponto específico no tempo usando o recurso de restauração ponto a ponto.
Database rollbacks interface showing rollback options
Observe que isso só restaurará seu banco de dados de produção para o estado em que estava no momento do checkpoint. Não restaurará seu aplicativo para o estado em que estava no momento do checkpoint. Para restaurar seu aplicativo para o estado em que estava no momento do checkpoint, você precisará fazer rollback para o checkpoint usando o recurso de rollback e republicar seu aplicativo.

Cobrança e uso de recursos

Os bancos de dados de produção são cobrados com base no uso por meio do Neon, um provedor de banco de dados serverless. Os recursos serverless do Neon incluem o seguinte:
  • Sem configuração ou manutenção de infraestrutura
  • Escalonamento automático para lidar com suas necessidades de uso
  • Cobrança de tempo de computação apenas quando o banco de dados está ativo
O banco de dados entra em um estado ocioso após cinco minutos de inatividade, pausando a cobrança de tempo de computação. Ele é reativado instantaneamente quando recebe uma consulta.
Para saber mais sobre esta tecnologia de banco de dados serverless, veja a documentação do ciclo de vida de Computação do Neon.
O Replit fornece rastreamento em tempo real do uso do seu banco de dados. Você pode visualizar o detalhamento do tempo de computação e uso de armazenamento para o Replit App atual ou para cada Replit App na sua conta.
Para visualizar o tempo de computação e uso de armazenamento do banco de dados para o período de cobrança atual, siga as etapas abaixo:Na ferramenta Replit Database:
  1. Navegue até a ferramenta PostgresSQL database icon Replit Database no Project Editor
  2. No menu suspenso do banco de dados, selecione Production
  3. Selecione a aba gear icon Settings
  4. A seção Storage Used mostra o armazenamento total usado pelo seu banco de dados para o período de cobrança atual.
Para visualizar para cada Replit App em SettingsAccountAccount usage, siga as etapas abaixo:
  1. Abra Settings e acesse AccountAccount usage (ou View account resource limits / Usage).
  2. Role até a seção Resource usage.
  3. Expanda as linhas PostgresSQL Storage e PostgresSQL Compute para detalhes sobre cada Replit App.
Para saber como o Replit cobra pelo uso do banco de dados, veja Cobrança de Implantações e Banco de Dados.

Solução de Problemas Comuns

Falhas de Publicação

Se a sua publicação falhar devido a problemas no banco de dados:
  1. Verifique os logs de publicação para mensagens de erro específicas sobre conectividade do banco de dados ou conflitos de schema
  2. Verifique suas credenciais de conexão do banco de dados estão corretas e acessíveis no ambiente do aplicativo publicado
  3. Revise as alterações recentes de schema para possíveis conflitos com o código do aplicativo existente
  4. Teste suas alterações em um ambiente de visualização antes de tentar republicar

Removendo um banco de dados de produção

A ação de remoção é irreversível após um período de retenção de 7 dias. Certifique-se de fazer backup de quaisquer dados importantes antes de prosseguir. Os bancos de dados têm um período de exclusão suave de 7 dias onde podem ser restaurados. Entre em contato com o suporte se precisar de ajuda. Após 7 dias, o banco de dados é excluído permanentemente e será irrecuperável.
Se você não precisar mais de um banco de dados para o seu Replit App, você pode removê-lo junto com todos os seus dados.
Na ferramenta Replit Database:
  1. Selecione a aba gear icon Settings
  2. Selecione Remove database e confirme selecionando Yes, Remove database

Próximos Passos

Para saber mais sobre gerenciamento de banco de dados no Replit:
  • Banco de Dados SQL: Saiba mais sobre o serviço de banco de dados PostgreSQL gerenciado do Replit
  • Implantações: Entenda como as implantações funcionam com alterações no banco de dados
  • App Storage: Saiba mais sobre armazenamento de arquivos e assets na nuvem (anteriormente chamado de Object Storage)