Prismaは、データベースの構造から、TypeScriptで扱いやすい操作用コードを生成するORMです。SQLを書く量を減らせますが、入力チェックやアクセス権の確認まで自動で済ませるものではありません。この記事では、学習用の空のフォルダーからSQLiteの小さな商品データベースを作ります。
更新:2026年10月24日。対象はPrisma ORM 7.10.0・Node.js 24系・npm・TypeScriptです。別のメジャーバージョン向け手順とは混ぜません。
Client・Migrate・Studioの役割
schema.prisma
データの形を定義
Migrate
DBの構造を変更
Client
アプリから読み書き
図1:スキーマをもとに、DB構造の変更と操作用Clientの生成をそれぞれ行う。Studioはデータを画面で確認する別のツールです。Prisma 7では、生成先を指定するprisma-clientと、DBに対応したドライバーアダプターを使います。移行の背景はPrisma 7の公式発表に説明されています。
1.プロジェクトを準備する
既存の本番DBではなく、新しい学習用フォルダーで実行してください。CLI・Client・アダプターは同じバージョンにそろえます。
mkdir prisma-learning
cd prisma-learning
npm init -y
npm pkg set type=module
npm install --save-dev --save-exact prisma@7.10.0 typescript@5.9.3 tsx@4 @types/node@24 @types/better-sqlite3
npm install --save-exact @prisma/client@7.10.0 @prisma/adapter-better-sqlite3@7.10.0 dotenv@17
npx prisma init --datasource-provider sqlite --output ../generated/prisma
生成されたファイルに加え、以下のtsconfig.jsonをプロジェクト直下に用意します。
{
"compilerOptions": {
"target": "ES2023",
"module": "ESNext",
"moduleResolution": "Bundler",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"noEmit": true
}
}
2.接続先とデータの形を設定する
.envの接続先を次にします。SQLiteなので、この例に外部DBの契約やパスワードは不要です。
DATABASE_URL="file:./dev.db"
プロジェクト直下のprisma.config.tsを次の内容にします。Prisma 7.10以降の初期化ではprisma7.config.tsが生成される場合がありますが、以下のコマンドでは使用する設定ファイルを明示します。
import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'
export default defineConfig({
schema: 'prisma/schema.prisma',
migrations: { path: 'prisma/migrations' },
datasource: { url: env('DATABASE_URL') }
})
prisma/schema.prismaを次に置き換えます。skuは商品の識別コードで、同じ値を重複登録できないようにしています。
generator client {
provider = "prisma-client"
output = "../generated/prisma"
}
datasource db {
provider = "sqlite"
}
model Item {
id Int @id @default(autoincrement())
sku String @unique
name String
stock Int @default(0)
}
3.テーブルを作り、Clientを生成する
npx prisma migrate dev --config prisma.config.ts --name init
npx prisma generate --config prisma.config.ts
DBのテーブルを変更することと、Clientのコードを生成することは別です。Prisma 7の手順では両方を明示的に実行します。初期化・設定・生成の流れはPrisma 7のSQLite公式ガイドと照合しています。
4.商品を登録して読み出す
プロジェクト直下にmain.tsを作成します。
import 'dotenv/config'
import { PrismaBetterSqlite3 } from '@prisma/adapter-better-sqlite3'
import { PrismaClient } from './generated/prisma/client'
const url = process.env.DATABASE_URL
if (!url) throw new Error('DATABASE_URLが未設定です')
const adapter = new PrismaBetterSqlite3({ url })
const db = new PrismaClient({ adapter })
async function main() {
await db.item.upsert({
where: { sku: 'NOTE-001' },
update: {},
create: { sku: 'NOTE-001', name: 'ノート', stock: 10 }
})
const items = await db.item.findMany({ orderBy: { id: 'asc' } })
console.log(items)
}
main()
.catch((error) => {
console.error(error)
process.exitCode = 1
})
.finally(async () => {
await db.$disconnect()
})
upsertは、対象があれば更新し、なければ作成する操作です。この例では更新内容を空にし、何度実行しても同じ商品を増殖させない構成にしています。生成したClientの使い方は公式のClient設定資料も確認してください。
うまく動かないときの確認表
| 症状 | 確認する場所 |
|---|
| Clientが見つからない | generateを実行したか。生成先とimport先が一致するか。 |
| テーブルがない | migrate devを実行したか。CLIとアプリが同じDBファイルを見ているか。 |
| adapterが必要と表示される | アダプターを作り、PrismaClientに渡しているか。 |
| ネイティブモジュールの読み込みエラー | Node.jsとOSの組合せ、better-sqlite3の導入結果を確認する。 |
本番に持ち込む前に
migrate devは開発用です。既存データのあるDBに安易に実行したり、リセット要求を承認したりしないでください。変更SQL、バックアップ、復元方法、適用手順を確認します。型安全なClientがあっても、外部入力の妥当性、ユーザーの権限、検索件数、インデックス、トランザクションの設計は必要です。
この記事は公式資料に基づく学習例で、すべてのOSでの実行を保証するものではありません。関連:ORMと手書きSQLの違い/HonoでAPIを作る。