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 Banco de Dados do Replit usa um banco de dados SQL totalmente gerenciado que permite adicionar armazenamento de dados persistente ao seu Replit App a partir do Project Editor.
A maneira mais rápida de começar é pedir ao Agent para adicionar um banco de dados ao seu aplicativo. O Agent configurará a integração, criará o schema do banco de dados e atualizará seu aplicativo para armazenar e recuperar dados.
screenshot of the database editor

​
Recursos

A ferramenta Banco de Dados do Replit 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. Veja a seção Banco de Dados de Desenvolvimento Legado Neon para mais detalhes.

​
Uso

Você pode acessar a ferramenta Banco de Dados do Replit diretamente no Project Editor. As seções a seguir orientam você na configuração e gerenciamento do seu Banco de Dados.
No Tool dock à esquerda:
  1. Selecione All tools icon All tools para ver a lista de ferramentas do Project Editor.
  2. Selecione PostgresSQL database icon Database.
Na barra de pesquisa:
  1. Selecione a magnifying glass icon 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 PostgresSQL database icon Database no Project Editor. Você pode integrar o banco de dados com 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 schema do banco de dados e atualizará seu aplicativo para se comunicar com o banco de dados.

​
Restaurar seu banco de dados para um estado anterior

Você pode reverter seu aplicativo e banco de dados para um estado anterior usando o recurso de rollback. Este recurso permite restaurar seu banco de dados para qualquer checkpoint criado pelo Agent.
Checkpoint rollback interface showing rollback options
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.
Na ferramenta Replit Database:
  1. Selecione a aba My Data
  2. Selecione SQL runner icon SQL runner
Para executar uma consulta, insira a instrução SQL na área de texto e selecione o botão sql run icon executar adjacente como mostrado abaixo:
screenshot of the SQL runner and run button
A ferramenta Banco de Dados do Replit 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 linhas
  • 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 Drizzle Studio:
image of the table structure editor
Você pode conectar ao seu banco de dados usando qualquer cliente SQL compatível com PostgreSQL usando a string de conexão encontrada nas suas variáveis de ambiente.

​
Visualizar credenciais de conexão e uso

Suas credenciais de conexão do banco de dados são armazenadas como variáveis de ambiente no seu Replit App. Essas credenciais são usadas pelo seu aplicativo para se conectar com segurança ao banco de dados e executar comandos.
  1. Navegue até a ferramenta PostgresSQL database icon Replit Database no Project Editor
  2. Selecione o banco de dados de Desenvolvimento ou Produção
  3. Selecione a aba gear icon 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 conexão 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 aplicativo e, mesmo que vazado, não pode ser usado por ninguém mais para acessar e modificar seu banco de dados.
Se o seu banco de dados de desenvolvimento ainda está 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 saber como usar essas credenciais no seu código, veja Conectar seu aplicativo a um banco de dados SQL.
Como este DATABASE_URL tem escopo para o seu aplicativo, seu banco de dados de desenvolvimento não pode ser acessado por outros aplicativos, mesmo os que você possui ou visualizadores de banco de dados externos. Essa separação segue as melhores práticas de segurança e evita 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. Veja o tutorial sobre compartilhamento de banco de dados entre vários aplicativos para aprender como configurar um serviço de API de banco de dados seguro.
Se você ainda está no banco de dados de desenvolvimento Neon legado, não compartilhe seu DATABASE_URL. Ele contém suas credenciais do banco de dados que podem ser usadas por qualquer pessoa para acessar e modificar seu banco de dados. Nunca cole-o em locais públicos ou 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. Esta camada ORM, combinada com a implementação de melhores práticas de segurança do Agent, protege seu aplicativo de 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. Este banco de dados agora está obsoleto 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 o seu banco de dados de desenvolvimento está hospedado no Neon verificando 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, então seu banco de dados de desenvolvimento agora está hospedado no Replit.
As seguintes sã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)
CobrançaIncluído gratuitamente em cada Replit AppCobrança baseada em uso. Veja Cobrança 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 ponto a ponto (PITR) — recuperação para qualquer ponto dentro da janela de retenção de backup.
Segurança de conexãoAcessível apenas de dentro do seu aplicativo; nunca exposto publicamente.Usava uma string de conexão completa — se vazada, qualquer pessoa poderia acessar e modificar seu banco de dados.
Comportamento de remixRemixar 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 nos remixes poderiam afetar o aplicativo original.
Criação do banco de dadosCriado automaticamente para cada Replit App.Requereu configuração explícita.
Fluxo de publicaçãoImplantar 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 de desenvolvimento poderiam afetar aplicativos em produção.
Se seu aplicativo foi bifurcado ou remixado enquanto usava o banco de dados Neon legado, seu aplicativo publicado pode ainda referenciar a URL do banco de dados do aplicativo original. Após a atualização do banco de dados, essa conexão compartilhada deixará de funcionar. Veja Corrigir um aplicativo publicado usando um banco de dados compartilhado para saber como atualizar seu aplicativo publicado.