prisma-database-setup-postgresql

PostgreSQL のセットアップ

Prisma を PostgreSQL で設定します。

前提条件

• PostgreSQL データベース（ローカルまたはクラウド）
• 接続文字列

1. スキーマの設定

prisma/schema.prisma で設定します。

datasource db {
  provider = "postgresql"
}

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

2. 設定ファイルの設定（v7）

prisma.config.ts で設定します。

import { defineConfig, env } from 'prisma/config'

export default defineConfig({
  schema: 'prisma/schema.prisma',
  datasource: {
    url: env('DATABASE_URL'),
  },
})

3. 環境変数

.env で設定します。

DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"

接続文字列の形式

postgresql://USER:PASSWORD@HOST:PORT/DATABASE?schema=SCHEMA

• USER：データベースユーザー
• PASSWORD：パスワード（特殊文字を含む場合は URL エンコード）
• HOST：ホスト名（localhost、IP、またはドメイン）
• PORT：ポート（デフォルトは 5432）
• DATABASE：データベース名
• SCHEMA：スキーマ名（デフォルトは public）

ドライバーアダプター（Prisma ORM 7 で必須）

Prisma ORM 7 はデフォルトでクエリコンパイラーを使用するため、ドライバーアダプターを使用する必要があります。

1. アダプターとドライバーをインストールします：

   npm install @prisma/adapter-pg pg
   

2. アダプターを使って Prisma Client をインスタンス化します：

   import 'dotenv/config'
   import { PrismaClient } from '../generated/client'
   import { PrismaPg } from '@prisma/adapter-pg'
   
   const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })
   const prisma = new PrismaClient({ adapter })
   

よくある問題

「データベースサーバーに接続できません」

• ホストとポートを確認します
• ファイアウォールの設定を確認します
• データベースが稼働していることを確認します

「認証に失敗しました」

• ユーザー名とパスワードを確認します
• パスワードに特殊文字が含まれている場合は、URL エンコードする必要があります

「スキーマが存在しません」

• URL に ?schema=public（または使用するスキーマ）が含まれていることを確認します