
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.
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.
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.Arquivos desta etapa
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.
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.
Erro comum
Equiparar o texto de sucesso da página a armazenamento durável.
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
Experimente
Qual projeto de prática você preparou e consegue identificar sua visualização de tabela do proprietário?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Desativar segurança para sumir com um erro sem considerar quem ganha acesso.
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.
Experimente
O que apareceu no formulário e no provedor para D1?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Deixar o navegador escolher uma tabela ou coluna privilegiada arbitrária.
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.
Experimente
Quais registros permaneceram após reabrir e o que aconteceu nas tentativas inválidas?
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
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.
Erro comum
Testar várias solicitações com mensagens indistinguíveis.
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.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
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.
Converse com o tutor sobre sua resposta
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.
- 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.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- schema.sqlBaixar este arquivo
- netlify/functions/mini-feedback.mjsBaixar este arquivo
- storage-record.txtBaixar este arquivo
- worksheet.htmlBaixar este arquivo
- reference/assignment-walkthrough.txtBaixar este arquivo
- reference/START-HERE.txtBaixar este arquivo
- reference/public/index.htmlBaixar este arquivo
- reference/public/app.jsBaixar este arquivo
- reference/netlify/functions/mini-feedback.mjsBaixar este arquivo
- reference/add-topic.sqlBaixar este arquivo
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.
Erro comum
Atualizar apenas o formulário sem servidor e banco conhecerem o campo novo.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar