> ## 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.

# Banco de Dados

> Aprenda como usar o banco de dados SQL integrado do Replit para armazenar e recuperar dados do seu app.

export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => {
  if (!videoId) {
    return null;
  }
  let url = "https://www.youtube.com/embed/" + videoId;
  if (startAt) {
    url = url + "?start=" + startAt;
  }
  return <Frame>
      <iframe src={url} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen></iframe>
    </Frame>;
};

O Replit Database usa um banco de dados SQL totalmente gerenciado que permite adicionar armazenamento de dados persistente ao seu Replit App diretamente do Project Editor.

<Note>
  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.
</Note>

<Frame>
  <img src="https://mintcdn.com/replit/tlGd6oyGOaUUeRxr/images/databases/database-editor.jpg?fit=max&auto=format&n=tlGd6oyGOaUUeRxr&q=85&s=18a9293165cc5d42db6c61ea572780d1" alt="captura de tela do editor de banco de dados" width="1389" height="871" data-path="images/databases/database-editor.jpg" />
</Frame>

## 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**. Veja [Recuperação de dados](/pt/features/data-and-storage/data-recovery)
* **Armazenamento gratuito**: inclui 20 GB de armazenamento gratuito para cada Replit App, ou 50 GB nos planos Pro e Enterprise.
* **Variáveis de ambiente**: use variáveis de ambiente no seu Replit App para acessar o banco de dados com segurança

<Info>
  Antes de 4 de dezembro de 2025, o banco de dados de desenvolvimento era hospedado no Neon e tinha algumas diferenças cruciais. Veja [Desenvolvimento e produção](/pt/features/data-and-storage/development-and-production#banco-de-dados-de-desenvolvimento-legado) para mais detalhes.
</Info>

## Uso

<YouTubeEmbed videoId="zbyRuoPNIc8" title="Como usar bancos de dados no Replit" />

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.

<Accordion title="Como acessar a ferramenta Database">
  1. Abra o painel **Tools** e selecione **Database** em **Replit Cloud**.
  2. A visão inicial lista seus bancos de dados. Selecione um, como **Development Database**, para abri-lo.
</Accordion>

A ferramenta Database é organizada em torno da sua lista de bancos de dados. A visão inicial mostra cada banco de dados com seu uso de armazenamento, além do seu **Billing Period** e **Hours of Compute Used** atuais. Abrir um banco de dados dá a você as seguintes abas:

* **Overview**: As tabelas do seu banco de dados.
* **My Data**: Navegue e edite linhas, ou execute consultas SQL.
* **Monitoring**: As consultas em execução agora e as que mais consomem tempo. Somente bancos de dados de produção.
* **Settings**: A string de conexão, o uso de armazenamento e os detalhes de conexão.

### 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 <img class="icon-svg" src="https://mintcdn.com/replit/rJldsgYVucXB_6kW/images/icons/postgres.svg?fit=max&auto=format&n=rJldsgYVucXB_6kW&q=85&s=68fc78519888560040eb7096f68e76df" alt="Ícone de banco de dados PostgreSQL" width="24" height="24" data-path="images/icons/postgres.svg" /> **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.

### Recursos de segurança

Quando você adiciona uma integração de banco de dados usando **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

## Próximos passos

* [Desenvolvimento e produção](/pt/features/data-and-storage/development-and-production): Seus dois bancos de dados, a atualização de infraestrutura e a comparação com o Neon legado.
* [Trabalhe com seus dados](/pt/features/data-and-storage/work-with-your-data): Navegue, edite e consulte seus dados.
* [Detalhes de conexão](/pt/features/data-and-storage/connection-details): Credenciais e ferramentas externas.
* [Recuperação de dados](/pt/features/data-and-storage/data-recovery): Restaure dados de desenvolvimento ou produção.