Prisma Postgres y Astro
Prisma Postgres es una base de datos Postgres totalmente gestionada y sin servidor, diseñada para aplicaciones web modernas.
Conectar con Prisma ORM (recomendado)
Sección titulada «Conectar con Prisma ORM (recomendado)»Prisma ORM es la forma recomendada de conectarse a tu base de datos Prisma Postgres. Proporciona consultas seguras en cuanto a tipos, migraciones y rendimiento global.
Esta guía utiliza Prisma ORM 8. Si estás en Prisma ORM 7, sigue la guía de Prisma ORM 7 para Astro en la documentación de Prisma en su lugar.
Prerrequisitos
Sección titulada «Prerrequisitos»- Un proyecto de Astro con un adaptador instalado para habilitar el renderizado bajo demanda (SSR).
- Una versión de Node.js que cumpla con los requisitos mínimos de Astro. Si estás en Node.js v24, asegúrate de usar
v24.11.0o superior para cumplir con los requisitos de Prisma ORM 8.
Instalar dependencias e inicializar Prisma
Sección titulada «Instalar dependencias e inicializar Prisma»Ejecuta el siguiente comando en tu proyecto para instalar Prisma ORM y crear sus archivos iniciales:
npx prisma@latest orm init --target postgres --authoring pslEsto instala la CLI de prisma, @prisma/orm-postgres y dotenv, y crea:
- Un archivo
prisma.config.tsque carga tuDATABASE_URLdesde.env - Un archivo
src/prisma/contract.prismacon un modelo de datos inicial - Un archivo
src/prisma/db.tsque exporta el cliente de Prisma ORM - Un archivo
.env.example
Si ya tienes una base de datos Prisma Postgres, añade su cadena de conexión a .env como DATABASE_URL. De lo contrario, ejecuta el siguiente comando para crear una base de datos y escribir automáticamente su cadena de conexión:
npx create-db@latest --env .envEl comando muestra una URL de reclamación. Ábrela e inicia sesión para conservar la base de datos. Prisma elimina las bases de datos no reclamadas después de 24 horas.
Define un Modelo
Sección titulada «Define un Modelo»Prisma requiere al menos un modelo en el contrato para crear las tablas de la base de datos. El siguiente ejemplo define un modelo Post como marcador de posición. Reemplaza el contenido de src/prisma/contract.prisma con él para comenzar. Puedes eliminarlo o sustituirlo más adelante por modelos que reflejen tus datos reales.
// use prisma-8
model Post { id Int @id @default(autoincrement()) title String content String? published Boolean @default(false)}Mantén la línea // use prisma-8 en la parte superior del archivo: le indica a Prisma qué sintaxis de contrato utiliza el archivo. Obtén más información sobre cómo configurar tu instalación de Prisma ORM en la referencia de contratos de Prisma.
Emitir el contrato
Sección titulada «Emitir el contrato»Ejecuta el siguiente comando para generar los archivos tipados que importa src/prisma/db.ts. Ejecútalo nuevamente cada vez que cambies tu contrato:
npx prisma contract emitCrear las tablas de la base de datos
Sección titulada «Crear las tablas de la base de datos»Ejecuta el siguiente comando para crear las tablas a partir de tu contrato. Esto también crea un directorio migrations/ que registra el estado de tu base de datos:
npx prisma db initSi el comando se detiene con Connection terminated unexpectedly, una base de datos que acabas de crear aún se está iniciando. Espera unos segundos y ejecútalo de nuevo.
Después de cambiar tu contrato, ejecuta npx prisma db update nuevamente para aplicar el cambio a tu base de datos.
Consulta y visualización de datos
Sección titulada «Consulta y visualización de datos»El cliente db exportado desde src/prisma/db.ts se crea una vez y se reutiliza en todo tu proyecto. Los modelos se agrupan por su esquema de PostgreSQL, por lo que el modelo Post está disponible como db.orm.public.Post.
El siguiente ejemplo muestra cómo recuperar solo tus publicaciones publicadas, ordenadas por id y, a continuación, mostrar los títulos y el contenido de las publicaciones en tu plantilla de Astro:
---import { db } from '../prisma/db';
const posts = await db.orm.public.Post .where({ published: true }) .orderBy((post) => post.id.desc()) .all();---
<html> <head> <title>Artículos publicados</title> </head> <body> <h1>Artículos publicados</h1> <ul> {posts.map((post) => ( <li> <h2>{post.title}</h2> {post.content && <p>{post.content}</p>} </li> ))} </ul> </body></html>