Clase 03 · Módulo 07
Supabase y Postgres desde cero
Supabase y Postgres desde cero
Qué logras en esta clase
Dejas una base de datos Postgres funcionando en Supabase, con una tabla bien definida y sabiendo qué incluye el plan gratis.
- Creas un proyecto y tu primera tabla.
- Eliges el tipo correcto para cada columna.
- Entiendes la seguridad de filas y las claves.
- Conoces los límites y las dos trampas del plan gratis.
02
Motor y servicio no son lo mismo
Postgres es el motor de base de datos. Supabase te lo entrega instalado, en la nube y con un panel web.
03
Las cuatro palabras que necesitas
| Palabra | Qué es |
|---|---|
| Postgres | Motor de base de datos de código abierto |
| Supabase | Servicio que aloja un Postgres por ti |
| SQL | Lenguaje para consultar y modificar la base |
| Table Editor | Pantalla de Supabase para ver tablas como planilla |
Lo que aprendas de Postgres aquí sirve igual si mañana lo instalas en tu propio servidor.
04
Una base se parece a una planilla estricta
| En la planilla | En la base | Diferencia |
|---|---|---|
| Hoja | Tabla | Tiene nombre fijo y reglas |
| Columna | Columna | Tiene un tipo obligatorio |
| Fila | Fila | Se identifica por una clave, no por su posición |
| Número de fila | Clave primaria | No cambia aunque ordenes o borres |
Esa última fila de la tabla es el cambio de mentalidad: en una base nunca dices «la fila 14».
05
Crear el proyecto
- Crea una cuenta en supabase.com.
- Crea una organización y, dentro, un proyecto nuevo.
- Ponle un nombre que identifique el producto.
- Define la contraseña de la base de datos.
- Elige la región más cercana a donde corre tu n8n.
06
Un proyecto por producto
Cada proyecto de Supabase es una base separada. No mezcles en una misma base los datos de dos negocios o productos distintos.
07
Por qué separar
- Un error o un borrado en un producto no toca al otro.
- Puedes entregar, pausar o eliminar un producto sin desarmar el resto.
- Los permisos quedan claros: quien entra a un proyecto ve solo eso.
El plan gratis permite hasta 2 proyectos activos. Si necesitas un tercero, la salida correcta es pagar el plan o instalar tu propio Postgres, no meterlo dentro de la base de otro producto.
08
Crear la primera tabla
- En el panel, abre Table Editor.
- Haz clic en New table.
- Escribe el nombre en Name, en minúsculas y sin espacios:
pedidos. - En Columns, usa Add column para cada dato, con su tipo.
- Deja las columnas
idycreated_atcomo vienen. - Haz clic en Save.
09
Las dos columnas que vienen hechas
id: la clave primaria. Un valor único por fila que la base asigna sola.created_at: la fecha y hora en que se creó la fila, también automática.
10
Tipos de columna recomendados
| Dato | Tipo | Por qué |
|---|---|---|
| Texto | text | Sin largo máximo que adivinar |
| Fecha y hora | timestamptz | Guarda la zona horaria |
| Plata y decimales exactos | numeric | No redondea mal |
| Identificadores numéricos | bigint | No se queda corto |
| Sí o no | boolean | Solo acepta verdadero o falso |
Son las preferencias que da la documentación de Supabase.
11
El tipo es una regla
Si la columna es numeric y el flujo manda «doce mil», la base rechaza la fila en vez de guardar basura.
12
Una tabla de ejemplo
| Columna | Tipo |
|---|---|
id | bigint, automática |
id_externo | text |
correo | text |
total | numeric |
estado | text |
created_at | timestamptz, automática |
id_externo guarda el número de pedido que viene del formulario o de la tienda. En la clase 5 verás por qué es la columna más importante.
13
Clave primaria: dos estilos
| Estilo | Cómo se ve | Cuándo conviene |
|---|---|---|
| Número que la base asigna | 1, 2, 3… | Caso general; fácil de leer |
uuid | Texto largo aleatorio | Cuando el identificador se muestra en una dirección web |
Cualquiera sirve mientras toda tabla tenga una clave primaria. Para automatizaciones internas, el número automático basta.
14
Relacionar dos tablas
Una clave foránea es una columna que guarda el id de una fila de otra tabla. El pedido no copia el nombre del cliente: apunta a él.
Si el cliente cambia de correo, lo cambias en un solo lugar.
15
Seguridad de filas (RLS)
RLS (Row Level Security) son reglas dentro de la base que deciden qué filas puede leer o escribir cada quien.
- Las tablas creadas en el Table Editor nacen con RLS activada.
- Las creadas con SQL exigen activarla a mano.
- Con RLS activada y sin reglas, la API pública de Supabase no devuelve filas.
Es el comportamiento seguro por defecto: no lo desactives para «hacerlo funcionar».
16
Dos tipos de clave de API
| Clave | Empieza con | Respeta RLS | Dónde va |
|---|---|---|---|
| Publicable | sb_publishable_ | Sí | Páginas y apps públicas |
| Secreta | sb_secret_ | No, la salta | Solo en servidores, como tu n8n |
Están en Settings > API Keys. Las claves antiguas anon y service_role siguen funcionando, pero Supabase anunció su retiro: revisa el plazo vigente en su página de claves de API.
17
La clave secreta lo puede todo
Va solo en una credencial de n8n. Si se filtra, cámbiala de inmediato en el panel y actualiza la credencial.
18
Qué incluye el plan gratis
| Recurso | Límite |
|---|---|
| Precio | 0 USD |
| Proyectos activos | 2 |
| Base de datos | 500 MB por proyecto |
| Archivos | 1 GB |
| Transferencia de salida | 5 GB |
Para dimensionar: una tabla de pedidos con texto corto ocupa poco. Lo que llena una base son archivos e imágenes guardados dentro; esos van en almacenamiento de archivos, no en columnas.
19
Las dos trampas del plan gratis
- Pausa: un proyecto gratuito se pausa tras una semana sin actividad. Un flujo diario lo mantiene vivo; un proyecto de pruebas abandonado se detiene.
- Sin respaldos automáticos: si borras una tabla por error, nadie la guardó por ti.
20
Cuándo pagar y qué otra opción hay
| Gratis | Pro | |
|---|---|---|
| Precio al mes | 0 USD | 25 USD, incluye el primer proyecto |
| Disco por proyecto | 500 MB | 8 GB |
| Respaldos | No incluye | Diarios, guardados 7 días |
| Pausa por inactividad | Sí | No |
Pro trae un tope de gasto activado por defecto. Conviene cuando un cliente depende de esos datos. La alternativa sin pago es instalar Postgres en tu propio servidor: no hay límite de proyectos, pero los respaldos y las actualizaciones son tarea tuya.
21
Errores comunes al partir
- Nombres de tablas o columnas con espacios, tildes o mayúsculas: complican todas las consultas. Usa
minusculas_con_guion_bajo. - Guardar todo como
text, también montos y fechas. Pierdes las reglas y los cálculos. - Crear una sola tabla gigante con cliente, pedido y producto repetidos en cada fila.
22
Lo que te llevas
- Postgres es el motor; Supabase lo aloja y le pone panel.
- Toda tabla tiene clave primaria y cada columna, su tipo.
- RLS viene activada desde el Table Editor y se deja así.
- La clave secreta salta la RLS: solo vive en credenciales de n8n.
- Plan gratis: 2 proyectos, 500 MB, pausa a la semana y sin respaldos.
23
Hazlo ahora
En 15 minutos:
- Crea un proyecto en Supabase y guarda la contraseña de la base.
- En Table Editor, crea la tabla
pedidoscon las columnas del ejemplo. - Agrega a mano dos filas desde el mismo editor.
- Intenta escribir un texto en
totaly mira cómo lo rechaza. - Ubica en Settings > API Keys dónde están las claves, sin copiarlas a ningún lado.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026