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.

O Replit Database usa um banco de dados SQL totalmente gerenciado que permite adicionar armazenamento persistente de dados ao seu Replit App diretamente do Editor de Projeto.
A maneira mais rápida de começar é pedir ao Agent para adicionar um banco de dados ao seu app. O Agent irá configurar a integração, criar o schema do banco de dados e atualizar seu app para armazenar e recuperar dados.
captura de tela do editor de banco de dados

​
Recursos

A ferramenta Replit Database oferece os seguintes recursos:
  • Ferramentas de banco de dados: Execute consultas, gerencie o schema do banco de dados e visualize dados com as ferramentas SQL integradas
  • Viagem no tempo: Restaure seu banco de dados para qualquer checkpoint do Agent usando o recurso de rollback
  • Armazenamento gratuito: Inclui 20 GB de armazenamento gratuito para cada Replit App.
  • Variáveis de ambiente: Use variáveis de ambiente no seu Replit App para acessar o banco de dados com segurança
Antes de 4 de dezembro de 2025, o banco de dados de desenvolvimento era hospedado no Neon e tem algumas diferenças importantes. Consulte a seção Banco de Dados de Desenvolvimento Neon Legado para mais detalhes.

​
Uso

Você pode acessar a ferramenta Replit Database diretamente no Editor de Projeto. As seções a seguir orientam você na configuração e no gerenciamento do seu Banco de Dados.
Na barra lateral de ferramentas à esquerda:
  1. Selecione Ícone de todas as ferramentas All tools para ver uma lista de ferramentas do Editor de Projeto.
  2. Selecione Ícone do banco de dados PostgresSQL Database.
Na barra de pesquisa:
  1. Selecione a ícone de lupa lupa no topo para abrir a ferramenta de pesquisa
  2. Digite “Replit Database” para localizar a ferramenta e selecione-a nos resultados.

​
Adicionar um banco de dados

Todos os Replit Apps vêm com um banco de dados por padrão. Você pode acessá-lo selecionando a ferramenta Ícone do banco de dados PostgresSQL Database no Editor de Projeto. Você pode integrar o banco de dados ao seu Replit App pedindo ao Agent para adicionar um banco de dados PostgreSQL ao seu Replit App, incluindo detalhes sobre quais dados seu Replit App deve armazenar. O Agent irá criar o schema do banco de dados e atualizar seu app para se comunicar com o banco de dados.

​
Restaurar seu banco de dados a um estado anterior

Você pode reverter seu app e banco de dados a um estado anterior usando o recurso de rollback. Esse recurso permite restaurar seu banco de dados para qualquer checkpoint criado pelo Agent.
Interface de rollback de checkpoint mostrando opções de rollback
Certifique-se de selecionar “Database” em “Additional rollback options” ao restaurar para o estado de um checkpoint. Isso restaurará seu banco de dados ao estado em que estava no momento do checkpoint.

​
Executar comandos de banco de dados

O SQL runner é uma ferramenta do Editor de Projeto que permite executar comandos SQL no seu banco de dados e visualizar os resultados.
Na ferramenta Replit Database:
  1. Selecione a aba My Data
  2. Selecione Ícone do SQL runner SQL runner
Para executar uma consulta, insira a instrução SQL na área de texto e selecione o botão ícone de execução do sql executar adjacente, conforme mostrado abaixo:
captura de tela do SQL runner e do botão executar
A ferramenta Replit Database inclui o Drizzle Studio, uma ferramenta que permite navegar e modificar dados visualmente. Essas ferramentas visuais ajudam a evitar erros de sintaxe e oferecem as seguintes funcionalidades:
  • Filtrar e ordenar dados para focar em informações específicas
  • Exportar dados para um arquivo para uso externo
  • Inserir ou modificar dados de linha
  • Criar e gerenciar schema, tabelas, views e enums
Você pode acessar essas ferramentas na aba My Data na ferramenta Replit Database. A imagem a seguir mostra uma visão da interface do construtor Drizzle Studio:
imagem do editor de estrutura de tabela
Você pode se conectar ao seu banco de dados usando qualquer cliente SQL compatível com PostgresSQL usando a string de conexão encontrada nas suas variáveis de ambiente.

​
Visualizar credenciais de conexão e uso

As credenciais de conexão do seu banco de dados são armazenadas como variáveis de ambiente no seu Replit App. Essas credenciais são usadas pelo seu app para se conectar com segurança ao banco de dados e executar comandos.
  1. Navegue até a ferramenta Ícone do banco de dados PostgresSQL Replit Database no Editor de Projeto
  2. Selecione o banco de dados de Desenvolvimento ou Produção
  3. Selecione a aba ícone de engrenagem Settings (o ícone de engrenagem). Esta aba mostra as credenciais de conexão e o uso de armazenamento do seu banco de dados.

​
Variáveis de ambiente

A seguinte variável de ambiente está disponível para conectar ao seu banco de dados de desenvolvimento:
  • DATABASE_URL: como se conectar e autenticar no banco de dados
Este DATABASE_URL só pode ser usado pelo seu app e, mesmo que seja vazado, não pode ser usado por outra pessoa para acessar e modificar seu banco de dados.
Se o seu banco de dados de desenvolvimento ainda estiver na infraestrutura Neon legada, as seguintes variáveis de ambiente adicionais também estão disponíveis: PGHOST, PGUSER, PGPASSWORD, PGDATABASE e PGPORT. Essas variáveis de conexão individuais não são fornecidas para bancos de dados hospedados na infraestrutura atual do Replit — use DATABASE_URL em vez disso.
Para aprender a usar essas credenciais no seu código, consulte Conectar seu app a um banco de dados SQL.
Como este DATABASE_URL é limitado ao seu app, seu banco de dados de desenvolvimento não pode ser acessado por outros apps, nem mesmo por aqueles que você possui ou por visualizadores de banco de dados externos. Essa separação segue as melhores práticas de segurança e impede o acesso não autorizado ao seu banco de dados.Se você precisar que vários Replit Apps compartilhem um único banco de dados, você pode expô-lo como uma API REST. Consulte o tutorial sobre compartilhar um banco de dados entre vários apps para aprender como configurar um serviço de API de banco de dados seguro.
Se você ainda estiver usando o banco de dados de desenvolvimento Neon legado, não compartilhe seu DATABASE_URL. Ele contém suas credenciais de banco de dados que podem ser usadas por qualquer pessoa para acessar e modificar seu banco de dados. Nunca o cole em lugares públicos ou em tickets de suporte.

​
Recursos de segurança

Quando você adiciona uma integração de banco de dados usando o Agent, ele adiciona um Object-Relational Mapper (ORM) que gerencia todas as comunicações do banco de dados com segurança integrada. Essa camada ORM, combinada com a implementação de boas práticas de segurança do Agent, protege seu app contra exploits por meio dos seguintes recursos:
  • Validação de schema: Verifica se os dados estão em conformidade com os formatos esperados
  • Sanitização de dados: Limpa automaticamente a entrada do construtor para prevenir ataques de injeção SQL

​
Banco de Dados de Desenvolvimento Legado

Antes de 4 de dezembro de 2025, o banco de dados de desenvolvimento era hospedado no Neon. Esse banco de dados está agora depreciado e todos os novos bancos de dados de desenvolvimento são hospedados na própria infraestrutura de banco de dados do Replit. Você pode verificar se seu banco de dados de desenvolvimento está hospedado no Neon conferindo a variável de ambiente DATABASE_URL.
Se DATABASE_URL contiver neon.tech/neondb, então seu banco de dados de desenvolvimento ainda está hospedado no Neon. Caso contrário, se contiver helium/heliumdb, seu banco de dados de desenvolvimento agora está hospedado no Replit.
A seguir estão as principais diferenças entre o banco de dados de desenvolvimento Neon legado e o novo banco de dados de desenvolvimento do Replit:
RecursoReplit (atual)Neon (legado)
HospedagemHospedado na própria infraestrutura do ReplitHospedado no Neon (provedor terceirizado)
FaturamentoIncluído gratuitamente em cada Replit AppFaturamento baseado em uso. Consulte Faturamento de Publicação e Banco de Dados para mais detalhes.
Capacidade de restauraçãoRestaure seu banco de dados para qualquer checkpoint usando o recurso de rollbackRestauração para um ponto no tempo (PITR) — recupere para qualquer ponto dentro da janela de retenção de backup.
Segurança de conexãoAcessível apenas de dentro do seu app; nunca exposto publicamente.Usava uma string de conexão completa — se vazada, qualquer pessoa poderia acessar e modificar seu banco de dados.
Comportamento ao remixarRemixar cria um novo banco de dados de desenvolvimento com dados copiados para isolamento e segurança.Remixar reutilizava o mesmo banco de dados para todas as cópias, então alterações em remixes poderiam afetar o app original.
Criação do banco de dadosCriado automaticamente para cada Replit App.Exigia configuração explícita.
Fluxo de publicaçãoImplantar ou publicar requer criar um banco de dados de produção para isolamento entre ambientes.Desenvolvimento e produção compartilhavam o mesmo banco de dados, então alterações de desenvolvimento não intencionais poderiam afetar apps em produção.
Se seu app foi copiado (fork) ou remixado enquanto usava o banco de dados Neon legado, seu app publicado pode ainda referenciar a URL do banco de dados do app original. Após a atualização do banco de dados, essa conexão compartilhada deixará de funcionar. Consulte Corrigir um app publicado que usa um banco de dados compartilhado para saber como atualizar seu app publicado.