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)

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.

Prerrequisitos

Un proyecto de Astro con un adaptador instalado para habilitar el renderizado bajo demanda (SSR).

Instalar dependencias e inicializar Prisma

Ejecuta los siguientes comandos para instalar las dependencias necesarias de Prisma:

npm install prisma tsx --save-dev
npm install @prisma/adapter-pg @prisma/client

Una vez instalado, inicializa Prisma en tu proyecto con el siguiente comando:

npx prisma init --db --output ./generated

Deberás responder algunas preguntas mientras configuras tu base de datos Prisma Postgres. Selecciona la región más cercana a tu ubicación y un nombre fácil de recordar para tu base de datos, como “Mi proyecto Astro”.

Esto creará:

Un directorio prisma/ con un archivo schema.prisma.
Un archivo .env con un campo DATABASE_URL ya configurado.

Define un Modelo

Aunque aún no necesites ningún modelo de datos específico, Prisma requiere al menos un modelo en el esquema para generar un cliente y aplicar migraciones.

El siguiente ejemplo define un modelo Post como marcador. Añade el modelo a tu esquema para empezar. Puedes eliminarlo o sustituirlo más adelante por modelos que reflejen tus datos reales.

generator client {
  provider = "prisma-client"
  output   = "./generated"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model Post {
  id        Int     @id @default(autoincrement())
  title     String
  content   String?
  published Boolean @default(false)
}

Más información sobre cómo configurar Prisma ORM en la referencia del esquema de Prisma.

Generar cliente

Ejecuta el siguiente comando para generar el Prisma Client a partir de tu esquema:

npx prisma generate

Generar archivos de migración

Ejecuta el siguiente comando para crear las tablas de la base de datos y generar el Prisma Client a partir de tu esquema. Esto también creará un directorio prisma/migrations/ con los archivos del historial de migraciones.

npx prisma migrate dev --name init

Crear un Prisma Client

Dentro de /src/lib, crea un archivo prisma.ts. Este archivo inicializará y exportará tu instancia de Prisma Client para que puedas consultar tu base de datos en todo tu proyecto de Astro.

import { PrismaPg } from '@prisma/adapter-pg';
import { PrismaClient } from '../../prisma/generated/client';

const connectionString = import.meta.env.DATABASE_URL;
const adapter = new PrismaPg({ connectionString });
const prisma = new PrismaClient({ adapter });

export default prisma;

Consulta y visualización de datos

El siguiente ejemplo muestra cómo recuperar solo tus publicaciones con Prisma Client ordenadas por id y, a continuación, mostrar los títulos y el contenido de las publicaciones en tu plantilla de Astro:

---
import prisma from '../lib/prisma';

const posts = await prisma.post.findMany({
  where: { published: true },
  orderBy: { id: 'desc' }
});
---

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

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

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

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 pg

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>