Prisma Postgres & Astro
Prisma Postgres は、モダンなWebアプリ向けに構築された、フルマネージドなサーバーレスPostgresデータベースです。
Prisma ORMでの接続(推奨)
Section titled “Prisma ORMでの接続(推奨)”Prisma Postgresデータベースへの接続には、 Prisma ORM の使用を推奨しています。これにより、型安全なクエリ、マイグレーション、およびグローバルなパフォーマンスが提供されます。
- オンデマンドレンダリング(SSR) を有効にするためのアダプターがインストールされたAstroプロジェクト。
- Prisma ORM 7。Prisma ORM 8はセットアップ手順が異なるため、このガイドではカバーされていません。
依存関係のインストールとPrismaの初期化
Section titled “依存関係のインストールとPrismaの初期化”以下のコマンドを実行して、必要なPrismaの依存関係をインストールします。
npm install prisma@7 tsx dotenv --save-devnpm install @prisma/adapter-pg@7 @prisma/client@7インストールが完了したら、次のコマンドを使用してプロジェクトでPrismaを初期化します。
npx prisma init --db --output ./generatedPrisma Postgresデータベースのセットアップ中に、いくつかの質問に答える必要があります。現在地から最も近いリージョンを選択し、「My Astro Project」のような覚えやすいデータベース名を付けてください。
これにより、以下のファイルが作成されます。
schema.prismaファイルを含むprisma/ディレクトリDATABASE_URLを.envから読み込むprisma7.config.tsファイル- すでに
DATABASE_URLが設定された.envファイル
モデルの定義
Section titled “モデルの定義”現時点で特定のデータモデルが必要なくても、Prisma Clientの生成やマイグレーションの適用には、スキーマ内に少なくとも1つのモデルが必要です。
以下の例では、プレースホルダとしてPostモデルを定義しています。まずはこのモデルをスキーマに追加してください。後ほど、実際のデータ構造を反映したモデルに削除または置換しても問題ありません。
generator client { provider = "prisma-client" output = "./generated"}
datasource db { provider = "postgresql"}
model Post { id Int @id @default(autoincrement()) title String content String? published Boolean @default(false)}Prisma ORMのセットアップ設定の詳細については、 Prismaスキーマリファレンス を参照してください。
クライアントの生成
Section titled “クライアントの生成”以下のコマンドを実行して、スキーマからPrisma Clientを生成します。
npx prisma generateマイグレーションファイルの生成
Section titled “マイグレーションファイルの生成”以下のコマンドを実行して、スキーマからデータベーステーブルを作成します。これにより、マイグレーション履歴ファイルを含むprisma/migrations/ディレクトリも作成されます。
npx prisma migrate dev --name initPrisma Clientの作成
Section titled “Prisma Clientの作成”/src/lib 内に prisma.ts ファイルを作成します。このファイルでPrisma Clientインスタンスを初期化してエクスポートすることで、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;データのクエリと表示
Section titled “データのクエリと表示”以下の例では、Prisma Clientを使用して公開済み(published: true)の投稿のみを id 順に取得し、そのタイトルと内容をAstroテンプレートに表示しています。
---import prisma from '../lib/prisma';
const posts = await prisma.post.findMany({ where: { published: true }, orderBy: { id: 'desc' }});---
<html> <head> <title>公開済みの投稿</title> </head> <body> <h1>公開済みの投稿</h1> <ul> {posts.map((post) => ( <li> <h2>{post.title}</h2> {post.content && <p>{post.content}</p>} </li> ))} </ul> </body></html>