Clase 04 · Módulo 07
Leer y escribir desde la app
Leer y escribir desde la app
Qué logras en esta clase
Tu app lee y guarda datos reales en Supabase, y sabes interpretar lo que vuelve cuando algo falla.
- Instalas y configuras un único cliente
- Lees filas con filtros y datos relacionados
- Insertas, modificas y borras con cuidado
- Distingues un error de una lista vacía por RLS
02
El recorrido de una consulta
El cliente es una librería, @supabase/supabase-js, que traduce una línea de TypeScript en una petición a la Data API de tu proyecto.
Tú escribes qué tabla y qué filtro. El cliente arma la petición, adjunta la clave publicable y la sesión del usuario, y te devuelve el resultado.
03
Instalar el cliente
npx expo install @supabase/supabase-js expo-secure-storeUsa npx expo install, no npm install: elige versiones compatibles con tu SDK, como viste en el módulo 3.
expo-secure-store es el almacenamiento cifrado del teléfono. El cliente lo usa para guardar la sesión del usuario.
04
Un solo cliente para toda la app
export const supabase = createClient(
process.env.EXPO_PUBLIC_SUPABASE_URL!,
process.env.EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY!,
{ auth: { storage, autoRefreshToken: true,
persistSession: true, detectSessionInUrl: false } }
);Se crea una vez, en un archivo propio, y el resto de la app lo importa. storage es un adaptador sobre expo-secure-store que muestra la guía oficial.
Las opciones de auth controlan la sesión: se explican en el módulo 8.
05
Lo que devuelve toda consulta
Toda consulta devuelve dos cosas: data y error. Revisa siempre el error antes de usar los datos.
06
Leer filas: select
const { data, error } = await supabase
.from('productos')
.select('id, nombre, precio')
.eq('disponible', true)
.order('nombre');Se lee de arriba abajo: de la tabla productos, trae tres columnas, solo las filas disponibles, ordenadas por nombre.
data es una lista de objetos, uno por fila. Si nada coincide, es una lista vacía, no un error.
07
Pide solo las columnas que usas
select() sin argumentos trae todas las columnas. Es cómodo y casi nunca es lo que necesitas.
- Menos datos viajando: la pantalla carga antes con mala señal
- Menos egreso consumido de tu plan
- Menos riesgo de mostrar una columna que no debía salir
08
Filtros y modificadores frecuentes
| Método | Qué hace |
|---|---|
.eq('col', valor) | Filas donde la columna es igual al valor |
.order('col') | Ordena el resultado |
.limit(n) | Trae como máximo n filas |
.range(desde, hasta) | Trae un tramo, para paginar |
.single() | Espera exactamente una fila |
Hay muchos más. No los memorices: la referencia oficial los lista con ejemplos, y Claude Code los conoce.
09
Traer datos relacionados en una consulta
const { data, error } = await supabase
.from('pedidos')
.select('id, estado, pedido_items(cantidad, productos(nombre))');Los paréntesis siguen las claves foráneas que definiste en la clase 3. Cada pedido llega con sus líneas adentro, y cada línea con el nombre de su producto.
Una consulta en vez de tres. Por eso valía la pena declarar bien las relaciones.
10
Escribir: las tres operaciones
| Operación | Forma | Cuidado |
|---|---|---|
| Crear | .insert({ ... }) | Envía solo las columnas sin default |
| Modificar | .update({ ... }).eq('id', id) | Siempre con filtro |
| Borrar | .delete().eq('id', id) | Siempre con filtro |
Las tres devuelven { data, error }, igual que una lectura.
11
Insertar y recuperar la fila creada
const { data, error } = await supabase
.from('pedidos')
.insert({ nota: 'Sin azúcar' })
.select()
.single();La base completa lo que no enviaste: el id, la fecha, los valores por defecto. Al encadenar .select() recibes la fila tal como quedó guardada, con su id listo para navegar al detalle.
Comprueba el comportamiento exacto de tu versión en la referencia de insert.
12
La base tiene la última palabra
Si un dato viola una restricción, la escritura falla completa. Eso no es un problema de la app: es la base haciendo su trabajo.
13
Leer el error
Cuando algo falla, error trae cuatro campos:
message: qué pasó, en una frasecode: el código del errordetails: el dato concreto que lo causóhint: una sugerencia, cuando Postgres tiene una
Muéstrale al usuario un mensaje simple. A Claude Code, pégale el error completo: con el code y el details suele dar con la causa a la primera.
14
Tu primera consulta vuelve vacía
Lista vacía y sin error, con datos en la tabla: casi siempre es RLS haciendo su trabajo, no datos perdidos.
15
Una política temporal para practicar
create policy "temporal: lectura abierta"
on productos for select
to anon, authenticated
using ( true );Con RLS activado y sin políticas, la API no entrega filas. Esta política deja leer productos a cualquiera, lo que es razonable para un catálogo con datos ficticios.
16
Dónde vive la llamada: TanStack Query
const { data, isLoading, error } = useQuery({
queryKey: ['productos'],
queryFn: async () => {
const { data, error } = await supabase
.from('productos').select('id, nombre, precio');
if (error) throw error;
return data;
},
});Supabase devuelve el error, no lo lanza. Si no escribes throw error, TanStack Query (módulo 6) cree que todo salió bien y tu pantalla nunca muestra el estado de error.
17
Lecturas y escrituras, cada una en su lugar
No llames a Supabase directo desde un useEffect. Las lecturas van en useQuery; las escrituras, en useMutation, que al terminar invalida la consulta afectada para que la lista se actualice sola.
Es el mismo patrón del módulo 6, ahora con datos reales.
18
Tres capas de validación
| Capa | Dónde | Para qué |
|---|---|---|
| Formulario | App (módulo 5) | Ayudar al usuario a corregir rápido |
| Restricciones | Base (clase 3) | Garantizar que el dato es válido |
| RLS | Base (módulo 8) | Decidir quién puede hacerlo |
La primera es comodidad. Las otras dos son seguridad. Ninguna reemplaza a la otra.
19
Funciona en desarrollo y no en el build
Si la app conecta en tu computador pero no en un build de EAS, revisa primero las variables de entorno.
Tu .env está fuera de Git, así que no viaja al build en la nube. Las variables EXPO_PUBLIC_ deben existir también en el entorno de EAS, con los valores del proyecto correcto.
20
Errores comunes
- Usar
datasin revisarerror - Crear un cliente nuevo en cada pantalla en vez de importar el único
- Olvidar el
throw errordentro dequeryFn - Creer que faltan datos cuando RLS los está filtrando
- «Arreglar» una lista vacía poniendo una clave secreta en la app
El último convierte un contratiempo en una filtración. No lo hagas nunca.
21
Lo que te llevas
- Un solo cliente, creado con la URL y la clave publicable
- Toda consulta devuelve
datayerror; el error se revisa siempre selectcon columnas nombradas, filtros y tablas relacionadasupdateydeletesiempre con filtro- Lista vacía sin error suele ser RLS, no un fallo
22
Hazlo ahora
Quince minutos, en tu proyecto de pruebas:
- Inserta tres filas ficticias en una tabla desde el panel
- Pídele a Claude Code el cliente y una pantalla que liste esas filas con
useQuery - Ábrela: llega vacía y sin error
- Agrega la política temporal de lectura y recarga
- Escribe mal el nombre de una columna y lee los cuatro campos del error
Anota la política temporal para reemplazarla en el módulo 8.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Supabase Docs: referencia de JavaScript, consultas con selectsupabase.com ↗
- Supabase Docs: referencia de JavaScript, insertsupabase.com ↗
- Supabase Docs: Expo y React Native, cliente y almacenamiento de sesiónsupabase.com ↗
- Supabase Docs: tablas y datos (RLS y políticas)supabase.com ↗
- TanStack Query en React Nativetanstack.com ↗
- Expo Docs: variables de entorno en EASdocs.expo.dev ↗