Minilección · Español

Cómo guardar envíos de formularios en una base de datos

Guarda un formulario en el proyecto de base de datos de práctica y verifica que el registro persiste al reabrir la página.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para quienes quieren guardar envíos del sitio. El asistente puede aplicar la configuración y conectar el formulario; no necesitas escribir SQL ni código servidor.

Antes de empezar

Necesitas tus proyectos desechables de Supabase y funciones Netlify. Usa los archivos completos y un asistente. Conserva las credenciales privadas de base en el servidor y prueba solo mensajes ficticios. Las respuestas resueltas son ejemplos, no pruebas realizadas en tu cuenta. Sustituye sus observaciones por tus resultados o indica el paso bloqueado.

Tiempo estimado: 20–37 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. La configuración de cuenta es adicional. Este laboratorio restringido no es un servicio público de comentarios anónimos; revisa límites persistentes contra abusos antes de adaptarlo al uso público.

Qué aprenderás

  • Envía un registro de formulario a almacenamiento real.
  • Verifica persistencia en la tabla del proveedor.
  • Rechaza datos inválidos sin exponer los registros de todos.

Archivos del taller

Paso 1

Define qué significa guardar

El registro debe existir fuera de la página actual del navegador.

Abre el formulario con el asistente y elige un mensaje ficticio reconocible. Lo guardaremos mediante el servidor en una base de práctica independiente.

Que un valor siga en pantalla no prueba almacenamiento en base. Prevé encontrar el mismo mensaje en el proveedor y después de reabrir.

Un ejemplo concreto

La tabla del proveedor y la página abierta son lugares distintos. Un mensaje que sigue en la tabla tras cerrar la aplicación demuestra más que una frase junto al botón.

Usa el proyecto de almacenamiento de comentarios. Ayúdame a aplicar su esquema solo en mi base Supabase de práctica y configurar el entorno servidor privado. Restringe el acceso de visitantes a la tabla. Inicia el formulario, guíame a la tabla del proveedor y ayúdame a comprobar que los datos válidos persisten y las peticiones inválidas no crean filas. Explica mis comprobaciones, no la sintaxis SQL.

Supabase: base de datos

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Almacena un registro fuera del navegador

Una fila guardada debe seguir existiendo después de cerrar la página.

Una variable JavaScript desaparece al cerrar su página. El almacenamiento local permanece en ese navegador. Una base guarda registros en un servicio al que la aplicación accede con permisos explícitos.

Utilizaremos una tabla Supabase privada y una función de servidor. El navegador envía un mensaje pequeño; el servidor lo valida y escribe la fila. No exponemos un endpoint público que enumere los mensajes de todos.

Ejemplo resuelto

Tras enviar “Database test D1”, cierra la página y encuentra ese mensaje exacto en el editor de tablas del proyecto. Mostrarlo solo en la página no demuestra almacenamiento.

Supabase: base de datos

Extra implementation exercise

Tu página muestra el mensaje enviado desde una variable local. ¿Demuestra eso que lo guardó la base?

Mostrar una solución desarrollada

No. Verifica la fila real. El navegador podría mostrar la entrada aunque nunca se realizara una solicitud al servidor.

  • Distingue el estado mostrado del almacenamiento.
  • Comprueba la fila correspondiente mediante una vista autorizada de la base.

Paso 2

Prepara el proyecto aislado de almacenamiento

Pide aplicar la configuración de forma segura.

Crea o elige tu proyecto Supabase desechable. Pide revisar y aplicar allí schema.sql, configurar valores privados y ejecutar el proyecto completo con run-locally.txt.

Confirma el proyecto antes de cambiar nada. Impide que los visitantes consulten todos los comentarios; usa el Table Editor del propietario para ver la fila de prueba.

Un ejemplo concreto

La tabla feedback proporcionada contiene un mensaje, un ID generado y una fecha de creación. El propietario del proyecto puede inspeccionarla en el proveedor; los visitantes no necesitan permiso para leer los comentarios de todos para que funcione esta prueba.

Supabase: seguridad por filas · Node.js: estado de soporte de versiones

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Crea una tabla privada de práctica

Activa seguridad por filas y mantén cerrado el acceso directo del navegador en esta vía.

Ejecuta este esquema solo en el proyecto aislado de Supabase identificado en tu configuración. El acceso del navegador está restringido deliberadamente; verifica la fila como propietario en Dashboard → Table Editor. No ejecutes este esquema en producción.

Crea un proyecto separado y ejecuta schema.sql en su editor SQL. La tabla tiene ID generado, mensaje con restricciones y fecha y hora del servidor. No ejecutes cambios de esquema de muestra en una base de producción ajena.

El script activa seguridad por filas y retira privilegios de tabla a roles del navegador. La clave secreta/service-role permite la escritura privilegiada y debe permanecer en el servidor. Una clave publicable es distinta y no concede esos permisos administrativos.

Abre Table Editor en el panel del proyecto Supabase para examinar la fila; no es la consola de desarrollo del navegador. Si falla la inserción, examina respuesta del servidor y configuración de base y esquema. No actives SELECT anónimo solo para comprobar si se insertó.

Para la secuencia local completa, abre run-locally.txt: prepara el entorno privado de la raíz, vincula solo el proyecto de práctica e inicia el proxy de funciones de Netlify. server-env.example.txt enumera variables sin secretos reales. Abrir solo el HTML no ejecuta el servidor.

Ejemplo resuelto

Este laboratorio mediado por servidor no necesita políticas amplias que permitan todo. Abrir SELECT anónimo para diagnosticar también expondría los mensajes.

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: seguridad por filas · Node.js: estado de soporte de versiones

Extra implementation exercise

Se deniega una consulta del navegador. ¿Debes permitir que usuarios anónimos lean toda la tabla de comentarios para arreglarla?

Mostrar una solución desarrollada

No. El diseño deniega intencionalmente las lecturas del navegador. Comprueba la escritura del servidor y examina la tabla como propietario.

  • Conserva el límite previsto de datos privados.
  • Utiliza la ruta del servidor o el panel autorizado, no lecturas globales.

Paso 3

Envía un registro desde la página

Deja la escritura al servidor listo.

Abre la aplicación real local o alojada y envía un mensaje como D1. Pide conservar solo los campos de visitante previstos en el registro.

Encuentra el texto D1 exacto en la tabla y examina identidad/hora generadas. Excluye secretos de capturas y notas.

Un ejemplo concreto

Envía D1 y encuentra su texto exacto en feedback. El ID generado distingue la fila de un mensaje antiguo similar; el visitante no debe elegirlo ni sobrescribirlo.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Conecta una escritura validada de servidor

El servidor elige tabla y campos permitidos; quien llama aporta solo el mensaje.

Configura las tres variables indicadas y despliega o ejecuta el proyecto separado. La persona que prueba introduce el código de acceso. Autoriza este endpoint restringido, no la cuenta Supabase.

Lee mini-feedback.mjs: comprueba método, código, tamaño y mensaje antes de llamar al proveedor. Ignora ID y nombres de tabla del cliente y devuelve éxito de almacenamiento solo tras una inserción correcta.

Ejemplo resuelto

Añadir un campo admin a la solicitud no crea una actualización administrativa: el servidor construye otro objeto que contiene solo message.

Extra implementation exercise

¿Por qué construir {message} en vez de reenviar a la base todo el objeto JSON del navegador?

Mostrar una solución desarrollada

Mantiene explícito el esquema aceptado y evita que campos inesperados se conviertan en escrituras. Valida también el mensaje; seleccionar campos no basta.

  • Limita los campos que se pueden escribir.
  • No confía en ID, fechas o privilegios controlados por el cliente.

Paso 4

Comprueba persistencia y fallo

Repite tras cerrar la primera página.

Cierra y reabre la aplicación y verifica D1 en almacenamiento. Prueba datos ausentes/excesivos y código incorrecto en el entorno desechable.

Los intentos inválidos no deben crear filas. Un éxito anterior no debe permanecer como si un intento posterior fallido se hubiera guardado.

Un ejemplo concreto

Registra la fila válida antes de pruebas negativas y revisa la tabla después. «El formulario mostró error» y «no añadió una fila inválida» son dos partes útiles de la comprobación.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Verifica persistencia y fallos

Usa registros distintivos y examina la base independientemente de la página.

Envía D1 con el código correcto y examina la fila correspondiente. Cierra y vuelve a abrir la página y confirma que sigue existiendo. Registra ID y fecha y hora sin compartir secretos de cuenta.

Prueba mensaje ausente, mensaje demasiado grande y código incorrecto. Ninguno debe crear una fila. En un entorno desechable, comprueba que la configuración de servidor ausente produce un fallo honesto.

Ejemplo resuelto

Un registro válido y dos solicitudes inválidas rechazadas informan más que tres clics correctos repetidos. Evita comentarios personales reales en el primer laboratorio.

Extra implementation exercise

El endpoint devuelve error, pero el navegador sigue diciendo “Saved” (guardado) por un intento anterior. ¿Qué debes verificar?

Mostrar una solución desarrollada

Comprueba si el valor nuevo tiene fila. La interfaz debe mostrar el fallo actual y no contar un éxito anterior como resultado de este intento.

  • Comprueba la respuesta actual y un nuevo valor distintivo.
  • No reutiliza un éxito antiguo como prueba de una solicitud fallida.

Paso 5

Añade un tema sin abrir los datos

Usa el asistente para cambiar el campo y examina el resultado.

Pide añadir Project y Question al formulario, almacenamiento y validación del servidor. Los valores guardados son project y question. La referencia es una comparación posterior a tu intento, no donde debas descubrir el requisito.

Crea un registro controlado por tema y prueba other como no admitido con ayuda del asistente. Verifica ambos valores y el rechazo conservando feedback privado para los visitantes.

Un ejemplo concreto

Añade los dos temas permitidos Project y Question. Cada selección debe guardarse con su mensaje. Other prueba rechazo: un selector atractivo no completa por sí solo el almacenamiento.

Archivos de este paso

Start hereArchivos del taller

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

How it works (optional)

Tu tarea: almacenar un tema validado

Amplía conjuntamente el modelo y el servidor sin abrir permisos del navegador.

Añade una columna topic limitada a project o question. Actualiza el servidor para validar la lista permitida y construir explícitamente el objeto insertado. Añade el control correspondiente al formulario.

Crea un registro por tema permitido y rechaza un valor no admitido. Mantén ID y fechas generados bajo control de la base.

DEFAULT asigna question a filas existentes en este ejercicio. Sin valor ni predeterminado, añadir una columna NOT NULL puede fallar si ya hay filas. En una migración real, elige el valor de relleno según los datos, no copiando este predeterminado.

Ejemplo resuelto

La restricción de base respalda la validación del servidor. Ninguna sustituye el papel de la otra en errores claros e integridad de datos.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

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

Añade el campo de tema y demuestra que persisten los datos válidos y se rechazan los inválidos.

Mostrar una solución desarrollada

Las tres capas deben coincidir: select del navegador, lista permitida del servidor y columna y restricción de base. ALTER TABLE de referencia gestiona las filas existentes asignando el tema predeterminado documentado antes de aplicar la restricción.

El servidor escribe solo {message,topic}. Debe rechazar un tema no admitido antes de utilizar la credencial secreta de la base de datos. También debe ignorar los ID y los nombres de tabla que aporte quien hace la solicitud, e informar de un fallo si el proveedor no puede escribir el registro.

Examina el mensaje y tema exactos guardados en Table Editor de Supabase, no un párrafo de éxito del cliente. Recarga o cierra el navegador y verifica el mismo registro. Utiliza diagnósticos de tu cuenta; no expongas lecturas anónimas para investigar.

  • La validación del tema existe en servidor y base de datos.
  • Las filas válidas correspondientes persisten y los valores no admitidos no crean filas.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones