Minilição · Português

Como salvar envios de formulário em um banco de dados

Salve um formulário de site num projeto de banco de dados de prática fornecido e confirme que o registro permanece após reabrir a página.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer salvar envios de um site. Um assistente de programação pode aplicar a configuração fornecida e conectar o formulário; não precisa escrever SQL nem código de servidor.

Antes de começar

Você precisa do seu projeto Supabase descartável e de um projeto Netlify Functions de prática. Use os arquivos completos e um assistente para configurar. Mantenha credenciais privadas do banco no servidor e teste apenas mensagens fictícias. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.

Tempo estimado: 20–37 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A configuração da conta é adicional. Este laboratório restrito não é um serviço público de comentários anônimos; revise limites duradouros contra abuso antes de adaptar ao uso público.

O que você vai aprender

  • Envie um registro de formulário para armazenamento real.
  • Verifique a persistência na visualização de tabela do provedor.
  • Rejeite entradas inválidas sem expor os registros de todas as pessoas.

Arquivos da oficina

Etapa 1

Defina o que significa salvar

O registro precisa existir fora da página atual do navegador.

Abra o formulário pronto com seu assistente e escolha uma mensagem fictícia distinta. Vamos salvá-la pelo servidor fornecido num banco de prática separado.

Um valor ainda visível na página não comprova armazenamento no banco. Planeje encontrar a mesma mensagem no provedor e após reabrir.

Um exemplo concreto

A tabela do provedor e a página atual do navegador são lugares diferentes. Uma mensagem que permanece na tabela depois de fechar a aplicação demonstra mais do que uma frase ainda exibida ao lado de enviar.

Use o projeto fornecido de armazenamento de comentários. Ajude a aplicar seu esquema apenas ao meu banco Supabase de prática separado e configurar o ambiente privado do servidor. Mantenha restrito o acesso dos visitantes à tabela de comentários. Inicie o formulário, mostre a visualização de tabela do provedor e ajude a verificar que dados válidos persistem e solicitações inválidas não criam linhas. Explique minhas verificações, não a sintaxe SQL.

Supabase: banco de dados

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Armazene um registro fora do navegador

Uma linha salva deve continuar existindo depois de fechar a página.

Uma variável JavaScript desaparece ao fechar a página. O armazenamento local fica naquele navegador. Um banco guarda registros em um serviço que a aplicação acessa sob permissões explícitas.

Usaremos uma tabela privada Supabase e uma função de servidor. O navegador envia uma mensagem pequena; o servidor valida e escreve a linha. Esta lição não expõe um endpoint público que lista as mensagens de todos.

Exemplo resolvido

Depois de enviar “Database test D1”, feche a página e encontre a mensagem exata no editor de tabelas do projeto. Uma mensagem exibida só na página não prova armazenamento.

Supabase: banco de dados

Extra implementation exercise

A página mostra a mensagem enviada a partir de uma variável local. Isso prova que o banco salvou?

Mostrar uma solução comentada

Não. Verifique a linha real no banco. O navegador poderia mostrar a entrada mesmo sem uma solicitação ao servidor.

  • Separa estado exibido de armazenamento.
  • Verifica a linha correspondente por uma visualização autorizada do banco.

Etapa 2

Prepare o projeto de armazenamento isolado

Peça ao assistente para aplicar a configuração fornecida com segurança.

Crie ou escolha seu projeto Supabase descartável. Peça ao assistente para revisar e ajudar a aplicar schema.sql nele, configurar os valores privados e executar o projeto completo usando run-locally.txt.

Confirme o projeto correto antes de aplicar alterações. Não permita que visitantes públicos consultem todos os comentários; use o Table Editor do proprietário para examinar a linha de teste.

Um exemplo concreto

A tabela feedback fornecida tem mensagem, ID gerado e data de criação. O responsável pelo projeto pode inspecioná-la no provedor; os visitantes não precisam de permissão para ler todas as mensagens para esse teste funcionar.

Supabase: segurança em nível de linha · Node.js: estado de suporte das versões

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Crie uma tabela privada de prática

Ative segurança em nível de linha e mantenha fechado o acesso direto do navegador neste caminho.

Execute este esquema apenas no projeto Supabase isolado identificado na configuração. O acesso do navegador é restrito de propósito; verifique como proprietário em Dashboard → Table Editor. Não execute este esquema em produção.

Crie um projeto Supabase separado e execute schema.sql no editor SQL. A tabela tem ID gerado, mensagem com restrições e data e hora do servidor. Não execute mudanças de exemplo em um banco de produção sem relação.

O script ativa segurança de linha e remove privilégios da tabela dos papéis de navegador. A chave secreta/service-role pode fazer a escrita privilegiada e deve continuar no servidor. Uma chave publicável é diferente e não concede essas permissões administrativas.

Abra Table Editor no painel Supabase para examinar a linha; não é o console do navegador. Se a inserção falhar, examine a resposta do servidor e a configuração de banco e esquema. Não ative SELECT anônimo apenas para ver se inseriu.

Para a sequência local completa, abra run-locally.txt: prepare o ambiente privado da raiz, vincule apenas o projeto de prática e inicie o proxy de funções do Netlify. server-env.example.txt lista nomes de variáveis sem segredos reais. Abrir apenas o HTML não executa o servidor.

Exemplo resolvido

Nenhuma política ampla que permite tudo é necessária neste laboratório mediado por servidor. Abrir SELECT anônimo para investigar também exporia mensagens enviadas.

create table public.feedback (
 id uuid primary key default gen_random_uuid(),
 message text not null check (char_length(message) between 1 and 1000),
 created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.

Supabase: segurança em nível de linha · Node.js: estado de suporte das versões

Extra implementation exercise

Uma consulta do navegador é negada. Você deve permitir que anônimos leiam toda a tabela de comentários para corrigir?

Mostrar uma solução comentada

Não. O desenho nega leituras do navegador intencionalmente. Confira a escrita do servidor e examine a tabela como proprietário.

  • Preserva o limite pretendido de dados privados.
  • Usa a rota do servidor ou painel autorizado em vez de abrir leitura global.

Etapa 3

Envie um registro pela página

Deixe o servidor pronto realizar a gravação.

Abra o aplicativo de prática local ou hospedado real e envie uma mensagem como D1. Peça ao assistente para manter apenas os campos de visitante pretendidos no registro salvo.

Encontre o texto exato D1 na tabela do provedor e examine sua identificação e horário gerados. Mantenha valores secretos da conta fora de capturas e notas compartilhadas.

Um exemplo concreto

Envie D1 e localize esse texto exato em feedback. O ID gerado distingue a linha de uma mensagem antiga parecida; o visitante não deve escolher nem substituir essa identidade.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Conecte uma escrita validada de servidor

O servidor escolhe tabela e campos permitidos; quem chama fornece só a mensagem.

Configure as três variáveis nomeadas e implante ou execute o projeto separado. Quem testa digita o código de acesso. Ele autoriza este endpoint restrito, não a conta Supabase.

Leia mini-feedback.mjs: a função verifica método, código, tamanho e mensagem antes de chamar o provedor. Ignora IDs e nomes de tabela do cliente e só retorna sucesso de armazenamento após uma inserção bem-sucedida.

Exemplo resolvido

Uma solicitação com um campo admin extra não vira atualização administrativa: o servidor constrói outro objeto contendo apenas message.

Extra implementation exercise

Por que construir {message} em vez de encaminhar todo o JSON do navegador ao banco?

Mostrar uma solução comentada

Isso mantém explícito o esquema aceito e impede campos inesperados de virarem escritas. Valide a mensagem também; só selecionar campos não basta.

  • Limita os campos graváveis.
  • Não confia em IDs, datas ou privilégios controlados pelo cliente.

Etapa 4

Verifique persistência e falha

Repita a ação após fechar a primeira página.

Feche e reabra o aplicativo e confirme que D1 continua no armazenamento. Experimente entradas ausentes ou grandes demais e um código de prática errado na configuração descartável.

Tentativas inválidas não devem criar novas linhas. Uma mensagem de sucesso anterior não deve permanecer como se uma tentativa posterior com falha também tivesse sido salva.

Um exemplo concreto

Registre a linha válida antes dos testes negativos e depois confira a tabela. “O formulário mostrou erro” e “nenhuma linha inválida foi adicionada” são duas partes úteis da verificação.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Verifique persistência e falhas

Use registros distintos e examine o banco independentemente da página.

Envie D1 com o código correto e examine a linha correspondente. Feche e reabra a página e confirme que a linha continua existindo. Registre ID e data e hora sem compartilhar segredos de conta.

Tente mensagem ausente, grande demais e código incorreto. Nenhum deve criar linha. Em um ambiente descartável, verifique se configuração ausente do servidor produz falha honesta.

Exemplo resolvido

Um registro válido e duas solicitações inválidas rejeitadas informam mais que três cliques bem-sucedidos repetidos. Evite comentários pessoais reais no primeiro laboratório.

Extra implementation exercise

O endpoint retorna erro, mas o navegador ainda diz “Saved” (salvo) de uma tentativa anterior. O que verificar?

Mostrar uma solução comentada

Confira se o valor novo tem uma linha. A interface deve mostrar a falha atual e um sucesso anterior não deve contar como resultado desta tentativa.

  • Verifica a resposta atual e um novo valor distinto de teste.
  • Não reutiliza um sucesso antigo como evidência de solicitação com falha.

Etapa 5

Adicione um assunto sem abrir os dados

Use um assistente para alterar o campo e examine o resultado.

Peça ao assistente para adicionar Project e Question ao formulário, à preparação do armazenamento e à validação do servidor. Os valores são project e question. A referência fornecida é uma comparação para abrir depois da tentativa, não o lugar em que você precisa descobrir o requisito.

Crie um registro controlado por assunto e tente o assunto não permitido other com a ajuda do assistente. Verifique os dois valores salvos e a rejeição, mantendo feedback privado para os visitantes.

Um exemplo concreto

Adicione dois assuntos permitidos, Project e Question. Cada valor escolhido deve ser salvo junto da mensagem. Other é um teste de rejeição; só um seletor bonito não conclui a mudança de armazenamento.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: armazenar um assunto validado

Amplie o modelo e o servidor juntos sem abrir permissões do navegador.

Acrescente uma coluna topic restrita a project ou question. Atualize o servidor para validar a lista permitida e construir explicitamente o objeto inserido. Acrescente o controle correspondente no formulário.

Crie um registro por assunto permitido e rejeite um valor não aceito. Mantenha IDs e datas gerados sob controle do banco.

DEFAULT atribui question às linhas existentes neste exercício. Sem valor ou padrão, acrescentar uma coluna NOT NULL pode falhar se já há linhas. Em uma migração real, escolha o preenchimento conforme os dados, não copiando este padrão.

Exemplo resolvido

A restrição do banco reforça a validação do servidor. Nenhuma substitui o papel da outra em erros claros e integridade dos dados.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
 check (topic in ('project','question'));

Extra implementation exercise

Acrescente o assunto e prove que dados válidos persistem e inválidos são rejeitados.

Mostrar uma solução comentada

As três camadas precisam concordar: select no navegador, lista permitida no servidor e coluna e restrição no banco. ALTER TABLE da referência trata linhas existentes atribuindo o assunto padrão documentado antes de aplicar a restrição.

O servidor escreve apenas {message,topic}. Precisa rejeitar um assunto não aceito antes de usar a credencial secreta. Também ignora IDs e tabelas do cliente e informa uma falha de escrita do provedor como falha.

Examine mensagem e assunto exatos em Table Editor do Supabase, não em um parágrafo de sucesso do cliente. Recarregue ou feche o navegador e verifique o mesmo registro. Use diagnósticos da sua conta; não exponha leituras anônimas para investigar.

  • A validação do assunto existe no servidor e no banco.
  • Linhas válidas correspondentes persistem e valores não aceitos não criam linhas.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições