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>Lo mejor es gestionar las consultas en una ruta API. Para obtener más información sobre cómo utilizar Prisma ORM en tu proyecto de Astro, consulta la Guía de Astro + Prisma ORM y la guía de Prisma para leer datos.
Conectar con otros ORMs y bibliotecas
Sección titulada «Conectar con otros ORMs y bibliotecas»Puedes conectarte a Prisma Postgres a través de TCP directo usando cualquier otro ORM, biblioteca de base de datos o herramienta de tu preferencia. Crea una cadena de conexión directa en tu Prisma Console para empezar.
Requisitos previos
Sección titulada «Requisitos previos»- Un proyecto de Astro con un adaptador instalado para habilitar el renderizado bajo demanda (SSR).
- Una base de datos de Prisma Postgres con una cadena de conexión con TCP habilitado.
Instalar dependencias
Sección titulada «Instalar dependencias»Este ejemplo usa pg, un cliente PostgreSQL para Node.js para realizar una conexión TCP directa.
Ejecuta el siguiente comando para instalar el paquete pg:
npm install pgConsulta tu cliente de base de datos
Sección titulada «Consulta tu cliente de base de datos»Proporciona tu cadena de conexión al cliente pg para comunicarse con tu servidor SQL y obtener datos de tu base de datos.
El siguiente ejemplo de creación de una tabla e inserción de datos se puede utilizar para validar la URL de consulta y la conexión TCP:
---import { Client } from 'pg';const client = new Client({ connectionString: import.meta.env.DATABASE_URL, ssl: { rejectUnauthorized: false }});await client.connect();
await client.query(` CREATE TABLE IF NOT EXISTS posts ( id SERIAL PRIMARY KEY, title TEXT UNIQUE, content TEXT );
INSERT INTO posts (title, content) VALUES ('Hello', 'World') ON CONFLICT (title) DO NOTHING;`);
const { rows } = await client.query('SELECT * FROM posts');await client.end();---
<h1>Artículos</h1><p>{rows[0].title}: {rows[0].content}</p>