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 em tempo real 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 seguros 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.
Interface de gerenciamento de banco de dados de produção

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

Bancos de dados de produção são os bancos de dados ativos e operacionais que servem usuários reais e seus dados. Eles diferem significativamente dos bancos de dados de desenvolvimento em vários aspectos importantes:

Bancos de Dados de Produção vs. Desenvolvimento

AspectoBanco de Dados de DesenvolvimentoBanco de Dados de Produção
FinalidadeExperimentação e desenvolvimento de recursosServir usuários reais e armazenar dados de negócio
DadosDados de teste, registros fictícios, conjuntos pequenosDados reais de usuários, informações críticas para o negócio
DesempenhoOtimizado para velocidade de desenvolvimentoOtimizado para confiabilidade e experiência do usuário
AlteraçõesMudanças frequentes de schema, iteração rápidaAlterações cuidadosas e planejadas via 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 manter seu banco de dados de produção seguro.O Agent pode fazer edições no seu banco de dados de desenvolvimento. No momento da publicação, quaisquer alterações que você fez com o Agent na estrutura do seu banco de dados de desenvolvimento (ou seja, adicionar e excluir 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 > Meus dados e ativando Editar

Tecnologia e Infraestrutura de 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 da nossa oferta padrão de Banco de Dados SQL. Eles executam PostgreSQL 16 ou 17 hospedado no Neon, proporcionando confiabilidade e desempenho de 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 de Banco de Dados do Replit enquanto usam infraestrutura específica para produção:
  • PostgreSQL 16 ou 17: Banco de dados relacional padrão da indústria com recursos avançados
  • Infraestrutura Neon: Plataforma de banco de dados serverless que oferece escalabilidade automática e otimização de custos
  • Ferramentas Integradas: Acesso ao SQL runner, Drizzle Studio e ferramentas visuais de gerenciamento 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, consulte 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. Consulte a seção Banco de Dados de Desenvolvimento Legado para detalhes sobre a stack do lado de desenvolvimento.

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

Quando você publica atualizações no seu Replit App que incluem alterações no banco de dados, pode se deparar com cenários em que um planejamento cuidadoso é essencial para evitar tempo de inatividade ou perda de dados.

Alterações Não Compatíveis com Versões Anteriores

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

Alterações Comuns Não Compatíveis com Versões Anteriores

Os seguintes tipos de alterações geralmente exigem estratégias cuidadosas de publicação:
  • Remover colunas do banco de dados que o código da sua aplicação 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 consultas existentes
  • Modificar restrições que podem rejeitar a lógica da aplicação existente

Pré-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 pré-visualização. Uma pré-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 da aplicação antes que elas afetem usuários reais. Esse ambiente de pré-visualização espelha sua configuração de produção, mas opera de forma independente. Ele pode ajudá-lo a detectar problemas potenciais com antecedência e garantir que suas alterações funcionem corretamente antes de serem publicadas. Testar sua implantação no ambiente de pré-visualização é fundamental para identificar problemas antes que eles afetem seus usuários. Siga estas etapas para garantir que suas alterações no banco de dados funcionem corretamente: 1. Testes Funcionais
  • Verifique se o seu app ainda funciona corretamente com as alterações do banco de dados aplicadas
  • Teste todos os fluxos principais de usuário para garantir que a funcionalidade permanece intacta
  • Verifique se os dados são exibidos corretamente após as modificações no schema
2. Verificação de Integridade dos Dados
  • Confirme que os dados existentes foram devidamente migrados ou transformados
  • Verifique se os novos campos contêm os valores esperados ou padrões apropriados
  • 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 pré-visualização
  • Verifique se os novos índices estão sendo usados de forma eficaz
  • Verifique se as alterações não introduzem regressões de desempenho

Restauração para um ponto no tempo

Para bancos de dados de produção, você pode restaurar seu banco de dados para um momento específico usando o recurso de restauração para um ponto no tempo.
Interface de rollbacks do banco de dados mostrando opções de rollback
Observe que isso só restaurará seu banco de dados de produção ao estado em que estava no momento do checkpoint. Não restaurará seu app ao estado em que estava no momento do checkpoint. Para restaurar seu app ao estado em que estava no momento do checkpoint, você precisará reverter para o checkpoint usando o recurso de rollback e republicar seu app.

Faturamento 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. As capacidades serverless do Neon incluem o seguinte:
  • Zero configuração ou manutenção de infraestrutura
  • Escalabilidade automática para atender às suas necessidades de uso
  • Faturamento de tempo de computação somente quando o banco de dados está ativo
O banco de dados entra em estado ocioso após cinco minutos de inatividade, pausando a cobrança do tempo de computação. Ele é reativado instantaneamente quando recebe uma consulta.
Para saber mais sobre essa tecnologia de banco de dados serverless, consulte 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 seu banco de dados no período de faturamento atual, siga as etapas abaixo:Na ferramenta Replit Database:
  1. Navegue até a ferramenta Ícone do banco de dados PostgresSQL Replit Database no Editor de Projeto
  2. No menu suspenso do banco de dados, selecione Production
  3. Selecione a aba ícone de engrenagem Settings
  4. A seção Storage Used mostra o armazenamento total usado pelo seu banco de dados no período de faturamento atual.
Para visualizar todos os Replit Apps em SettingsAccountAccount usage, siga as etapas abaixo:
  1. Abra Settings e vá para 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 ver detalhes de cada Replit App.
Para saber como o Replit cobra pelo uso do banco de dados, consulte Faturamento 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 se suas credenciais de conexão do banco de dados estão corretas e acessíveis a partir do ambiente do app publicado
  3. Revise as alterações recentes de schema em busca de possíveis conflitos com o código da aplicação existente
  4. Teste suas alterações em um ambiente de pré-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, durante o qual podem ser restaurados. Entre em contato com o suporte se precisar de assistência. Após 7 dias, o banco de dados é excluído permanentemente e não poderá ser recuperado.
Se você não precisar mais de um banco de dados para seu Replit App, poderá removê-lo com todos os seus dados.
Na ferramenta Replit Database:
  1. Selecione a aba ícone de engrenagem 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 de banco de dados
  • Armazenamento de App: Saiba como armazenar arquivos e recursos na nuvem (anteriormente chamado de Object Storage)