LiçõesComo salvar envios de formulário em um banco de dados

Minilição 10 de 30 · Tornar seu site útil

Defina o que significa salvar

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.

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

Objetivo desta lição

  • 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.
Explicação, exemplo resolvido e prática

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.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como publicar seu site pelo GitHub

    Conecte um repositório de prática à hospedagem.

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.

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Onde você procurará para verificar se sua mensagem foi realmente salva?

Mostrar uma solução comentada

Resposta de exemplo: Vou enviar o texto fictício “D1 — blue notebook”, localizar essa mensagem exata na tabela feedback do responsável, fechar e reabrir a aplicação e conferir que ela continua lá. Um rótulo no formulário é só a primeira resposta visível.

O que uma boa resposta inclui

  • Identifica o registro correspondente no provedor do banco como prova de armazenamento.
  • Inclui reabrir/recarregar, em vez de confiar em uma mensagem temporária de sucesso.
Como funciona (opcional)

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

Exercício técnico complementar

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 1 · Como salvar envios de formulário em um banco de dados

Prepare o projeto de armazenamento isolado

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Qual projeto de prática você preparou e consegue identificar sua visualização de tabela do proprietário?

Mostrar uma solução comentada

Registro de configuração de exemplo: O assistente aplicou schema.sql somente no meu projeto descartável, definiu os valores privados e iniciou a aplicação fornecida. Como responsável, posso inspecionar feedback no Table Editor. Visitantes públicos continuam sem poder consultar a tabela.

O que uma boa resposta inclui

  • Identifica o projeto descartável e se a preparação do esquema/servidor foi concluída ou bloqueada.
  • Localiza o Table Editor de feedback do responsável sem liberar a leitura aos visitantes.
Como funciona (opcional)

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

Exercício técnico complementar

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 2 · Como salvar envios de formulário em um banco de dados

Envie um registro pela página

Deixe o servidor pronto realizar a gravação.

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que apareceu no formulário e no provedor para D1?

Mostrar uma solução comentada

Registro de gravação de exemplo: O formulário informou que salvou a mensagem. Na tabela feedback do provedor de prática, achei “D1 — blue notebook” com ID e data de criação gerados. Guardei o ID nas minhas notas privadas para reconhecer a mesma linha depois.

O que uma boa resposta inclui

  • Relaciona o texto D1 exato enviado a uma linha com identidade/data geradas pelo provedor.
  • Relata separadamente página e armazenamento, sem compartilhar configuração privada.
Como funciona (opcional)

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.

Exercício técnico complementar

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 3 · Como salvar envios de formulário em um banco de dados

Verifique persistência e falha

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Quais registros permaneceram após reabrir e o que aconteceu nas tentativas inválidas?

Mostrar uma solução comentada

Registro de teste negativo de exemplo: Depois de fechar e reabrir a página, D1 permaneceu na tabela. Tentativas vazias, grandes demais e com código incorreto não criaram linhas. A tentativa que falhou mostrou erro, em vez de manter a mensagem Saved anterior como se também valesse para ela.

O que uma boa resposta inclui

  • Verifica que o registro válido identificado continua presente após reabrir.
  • Confere que entradas/acessos inválidos não criam linhas nem deixam um estado de sucesso enganoso.
Como funciona (opcional)

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.

Exercício técnico complementar

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 4 · Como salvar envios de formulário em um banco de dados

Adicione um assunto sem abrir os dados

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

Explicação, exemplo resolvido e prática

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Apresente a alteração de assunto e os resultados observados de armazenamento válido e inválido.

O que entregar: Um registro de armazenamento com dados sensíveis ocultados mostrando persistência válida e tentativas inválidas rejeitadas.

Mostrar uma solução comentada

Registro de extensão de exemplo: “D2 — project test” persistiu com topic project; “D3 — question test” com topic question. O valor não permitido other foi rejeitado e não criou linha. Inspecionei como responsável; o acesso dos visitantes à tabela completa permaneceu restrito.

O que uma boa resposta inclui

  • Salva os valores Project e Question com os registros controlados correspondentes.
  • Rejeita um assunto não permitido e mantém os visitantes sem acesso à tabela completa.
Como funciona (opcional)

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'));

Exercício técnico complementar

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.