A maneira mais rápida de começar é pedir ao Agent para adicionar um banco de dados ao seu app. O Agent configurará a integração, criará o esquema do banco de dados e atualizará seu app para armazenar e recuperar dados.
Recursos
A ferramenta Replit Database oferece os seguintes recursos:- Ferramentas de banco de dados: execute consultas, gerencie o esquema 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 tinha algumas diferenças cruciais.
Veja a seção Legacy Neon Development Database para mais detalhes.
Uso
Você pode acessar a ferramenta Replit Database diretamente no Project Editor. As seções a seguir orientam você na configuração e no gerenciamento do seu Database.Como acessar a ferramenta Replit Database
Como acessar a ferramenta Replit Database
No Tool dock à esquerda:
- Selecione
All tools para ver uma lista das ferramentas do Project Editor. - Selecione
Database.
- Selecione a
lupa no topo para abrir a ferramenta de pesquisa - 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 Database no Project Editor.
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 criará o esquema do banco de dados
e atualizará seu app para se comunicar com o banco de dados.
Restaurar seu banco de dados para um estado anterior
Você pode revertar seu app e banco de dados para um estado anterior usando o recurso de rollback. Esse recurso permite restaurar seu banco de dados para qualquer checkpoint criado pelo Agent.
Certifique-se de selecionar “Database” em “Additional rollback options” ao restaurar para o estado de um checkpoint. Isso restaurará seu banco de dados para o estado em que estava no momento do checkpoint.
Executar comandos de banco de dados
O SQL runner é uma ferramenta do Project Editor que permite executar comandos SQL no seu banco de dados e visualizar os resultados.Como acessar o SQL runner
Como acessar o SQL runner
Na ferramenta Replit Database:
- Selecione a aba My Data
- Selecione
SQL runner
adjacente,
como mostrado abaixo:
Navegar e modificar dados visualmente
A ferramenta Replit Database inclui o Drizzle Studio, uma ferramenta que permite navegar e modificar dados visualmente. Essas ferramentas visuais ajudam você 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 linhas
- Criar e gerenciar esquemas, tabelas, views e enums
Ver 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 de forma segura ao banco de dados e executar comandos.Como acessar as credenciais de conexão do seu banco de dados
Como acessar as credenciais de conexão do seu banco de dados
- Navegue até a ferramenta Replit Database no Project Editor
- Selecione o banco de dados de Development ou Production
- Selecione a aba
Settings (o ícone de engrenagem). Essa 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-se ao seu banco de dados de desenvolvimento:DATABASE_URL: como conectar e autenticar no banco de dados
DATABASE_URL só pode ser usado pelo seu app, e mesmo se for exposto, não pode ser usado por mais ninguém para acessar e modificar seu banco de dados.
Se o seu banco de dados de desenvolvimento ainda estiver na infraestrutura legada do Neon, 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.Como esse
DATABASE_URL é restrito ao seu app, seu banco de dados de desenvolvimento não pode ser acessado por outros apps, mesmo os que você possui, ou por visualizadores externos de banco de dados.
Essa separação segue as melhores práticas de segurança e evita acesso não autorizado ao seu banco de dados.Recursos de segurança
Quando você adiciona uma integração de banco de dados usando o Agent, ele adiciona um mapeador objeto-relacional (ORM) que gerencia todas as comunicações com o banco de dados com segurança integrada. Essa camada de ORM, combinada com a implementação de boas práticas de segurança do Agent, protege seu app contra exploits através dos seguintes recursos:- Validação de esquema: verifica se os dados estão em conformidade com os formatos esperados
- Sanitização de dados: limpa automaticamente a entrada do criador para evitar ataques de injeção SQL
Legacy Development Database
Antes de 4 de dezembro de 2025, o banco de dados de desenvolvimento era hospedado no Neon. Esse banco de dados agora está descontinuado, e todos os novos bancos de dados de desenvolvimento são hospedados na infraestrutura de banco de dados própria do Replit. Você pode verificar se o seu banco de dados de desenvolvimento é hospedado no Neon verificando a variável de ambienteDATABASE_URL environment variable.
Se
DATABASE_URL contém neon.tech/neondb, então o seu banco de dados de desenvolvimento ainda está hospedado no Neon.
Caso contrário, se contém helium/heliumdb, seu banco de dados de desenvolvimento agora está hospedado no Replit.| Recurso | Replit (atual) | Neon (legado) |
|---|---|---|
| Hospedagem | Hospedado na infraestrutura própria do Replit | Hospedado no Neon (provedor terceirizado) |
| Faturamento | Incluído gratuitamente em cada Replit App | Cobrança baseada em uso. Veja Publishing and Database Billing para mais detalhes. |
| Capacidade de restauração | Restaure seu banco de dados para qualquer checkpoint usando o recurso de rollback | Restauração para um ponto no tempo (PITR) — recupere para qualquer ponto dentro da janela de retenção de backup. |
| Segurança de conexão | Acessível apenas a partir do seu app; nunca exposto publicamente. | Usava uma string de conexão completa — se exposta, qualquer pessoa poderia acessar e modificar seu banco de dados. |
| Comportamento ao remixar | Remixar 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 podiam afetar o app original. |
| Criação do banco de dados | Criado automaticamente para cada Replit App. | Exigia configuração explícita. |
| Fluxo de publicação | Implantar ou publicar requer a criação de 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 não intencionais no desenvolvimento podiam afetar os apps em produção. |