Netlify Database

O que é Netlify Database?

Netlify Database é um banco de dados Postgres totalmente gerenciado integrado à plataforma Netlify. Ele provisiona e gerencia o banco para você, incluindo a aplicação de migrações e a criação de ramificações de banco que se integram ao fluxo de deploy do Netlify.

O propósito principal é permitir que você construa aplicações full-stack com um banco de dados relacional que permanece alinhado às mudanças no seu código — sem gerenciar manualmente bancos de staging separados ou aplicar atualizações de schema manualmente.

Principais Recursos

• Postgres totalmente gerenciado no Netlify: Netlify cuida do provisionamento para que sua aplicação possa usar um banco Postgres sem configurar infraestrutura.
• Migrações automatizadas vinculadas a deploys: Um sistema de migração integrado rastreia mudanças de schema no seu repositório e as aplica automaticamente durante deploys de produção e previews de deploy.
• Ramificação dinâmica de banco integrada a previews de deploy: Previews de deploy recebem sua própria ramificação de banco, criada a partir de uma cópia dos dados de produção no momento da criação do preview.
• Acesso à produção protegido por design: Apenas deploys de produção podem acessar o banco principal, reduzindo o risco de experimentos impactarem dados ao vivo.
• Ambientes isolados para fluxos de IA: Execuções de agentes recebem sua própria ramificação de banco automaticamente, e Netlify fornece um contexto de integração “Agent Runners” para que agentes trabalhem com mudanças de schema e consultas em isolamento.

Como Usar Netlify Database

1. Crie ou selecione um plano Netlify baseado em créditos que suporte Netlify Database (Netlify Database está disponível apenas em planos baseados em créditos).
2. Implemente schema e migrações no seu repositório usando a abordagem de migrações documentada; Netlify rastreará mudanças de schema e as aplicará no momento certo do ciclo de deploy.
3. Faça deploy da sua aplicação normalmente para produção e crie previews de deploy pelo seu fluxo habitual (por exemplo, abrindo um pull request).
4. Use previews de deploy para testar mudanças com segurança: Netlify conectará cada preview de deploy à sua própria ramificação de banco, copiada da produção quando o preview for criado.

Casos de Uso

• Valide mudanças de schema sem desviar da produção: Migrações automatizadas rodam em deploys de produção e previews de deploy, ajudando a garantir que o schema do banco corresponda à versão do código sendo implantada.
• Teste com segurança um novo recurso que altera dados: Por exemplo, você pode validar um fluxo de exclusão de artigos em uma ramificação de preview de deploy sem remover conteúdo do banco de produção principal.
• Evite interferências entre equipes durante desenvolvimento paralelo: Se múltiplas mudanças forem trabalhadas simultaneamente, ramificações separadas de preview de deploy permitem que cada preview evolua sem gargalos em um único banco de staging compartilhado.
• Recupere rapidamente de uma migração ou consulta ruim: Se uma mudança experimental incluir uma consulta que afeta dados involuntariamente, você pode resetar a ramificação de banco afetada sem impactar o site ao vivo.
• Execute agentes de IA com acesso isolado a dados: Ao usar Agent Runners, cada execução de agente recebe sua própria ramificação de banco para que experimentos (incluindo mudanças de schema) não arrisquem corromper dados de produção.

Perguntas Frequentes

Netlify Database está disponível em todos os planos Netlify?

Netlify Database está disponível apenas em planos baseados em créditos.

O armazenamento de banco de dados consome créditos?

Quando um banco está ativo, ele consome créditos por computação e largura de banda usadas. A documentação também afirma que o espaço de armazenamento de banco de dados é gratuito até 1º de julho de 2026.

Como as migrações de schema são aplicadas?

Netlify Database inclui um sistema de migração automático que rastreia mudanças de schema no seu repositório e as aplica automaticamente em deploys de produção e previews de deploy.

Como funciona o isolamento de dados em previews de deploy?

Quando um preview de deploy é criado pela primeira vez, Netlify faz uma cópia dos dados de produção para a ramificação de banco desse preview. Mudanças feitas durante o ciclo de vida do preview não afetam o banco de produção.

Qual é o papel da ramificação de banco para agentes de IA?

Execuções de agentes são conectadas automaticamente à sua própria ramificação de banco, permitindo experimentos e iterações de schema em ambientes isolados.

Alternativas

• Postgres gerenciado por você com staging: Execute suas próprias instâncias de Postgres (produção + staging) e gerencie migrações manualmente ou via CI/CD. Isso pode se assemelhar ao fluxo de trabalho do Netlify Database, mas você geralmente lida com deriva de esquema e sincronização de ambientes por conta própria.
• Database-as-a-service (Postgres gerenciado) com ambientes separados: Use um provedor de Postgres gerenciado e crie bancos de dados/esquemas separados para staging e testes. Você ainda precisará orquestrar isolamento semelhante a ramificações e temporização de migrações.
• Ferramentas de migrações com fluxos gerenciados pela aplicação: Use frameworks de migração e aplique migrações por meio do pipeline de deploy. Isso dá controle sobre quando as migrações executam, mas você não obtém automaticamente ramificações de banco de dados para previews de deploy como descrito aqui.