Name: Prisma Sqlserver
Author: BlackDonut

Skills suchen.../

Prisma Sqlserver | Skills Pool

import { Injectable, OnModuleInit, OnModuleDestroy } from "@nestjs/common";
import { PrismaClient } from "@prisma/client";

@Injectable()
export class PrismaService
  extends PrismaClient
  implements OnModuleInit, OnModuleDestroy
{
  async onModuleInit(): Promise<void> {
    await this.$connect();
  }

  async onModuleDestroy(): Promise<void> {
    await this.$disconnect();
  }
}

// prisma.module.ts
import { Global, Module } from "@nestjs/common";
import { PrismaService } from "./prisma.service";

@Global()
@Module({
  providers: [PrismaService],
  exports: [PrismaService],
})
export class PrismaModule {}

DATABASE_URL="sqlserver://localhost:1433;database=task_manager;user=sa;password=YourPassword123;trustServerCertificate=true"

// schema.prisma — Prisma 7 以降は url を書かない
datasource db {
  provider = "sqlserver"
}

generator client {
  provider = "prisma-client-js"
}

// prisma.config.ts（プロジェクトルートに配置）
import path from "node:path";
import { defineConfig } from "prisma/config";

export default defineConfig({
  earlyAccess: true,
  schema: path.join(__dirname, "prisma", "schema.prisma"),
  migrate: {
    async url(): Promise<string> {
      return process.env["DATABASE_URL"] ?? "";
    },
  },
});

DATABASE_URL="sqlserver://...;connection_limit=10"

項目	PostgreSQL との差異
`jsonb` 型	非対応。`String` 型で代替
`uuid()` デフォルト値	`@default(uuid())` 使用可能
`autoincrement()`	使用可能。本プロジェクトは文字列 ID 採用
`@@unique` 複合制約	使用可能
ケースセンシティビティ	Collation 依存。デフォルトは大小文字不区別の場合あり

model Task {
  id        String @id
  // ... 他フィールド
  deleteFlg Int    @default(0) @map("DELETE_FLG") // 0: 有効 / 1: 削除済み
}

// 有効レコードのみ（必ず deleteFlg: 0）
const tasks = await this.prisma.task.findMany({
  where: { deleteFlg: 0 },
});

// 論理削除（updatedAt/updatedById も更新）
await this.prisma.task.update({
  where: { id },
  data: {
    deleteFlg: 1,
    updatedAt: this.clock.now(),
    updatedById: userId,
  },
});

// 削除済み含む全件（監査用）
const allTasks = await this.prisma.task.findMany();

// packages/backend/src/clock/clock.ts
export interface Clock {
  now(): Date;
}

export class SystemClock implements Clock {
  now(): Date {
    return new Date(); // UTC
  }
}

// app.module.ts
import { SystemClock } from "./clock/clock";

@Module({
  providers: [{ provide: "Clock", useClass: SystemClock }],
})
export class AppModule {}

@Injectable()
export class TasksService {
  constructor(
    private readonly prisma: PrismaService,
    @Inject("Clock") private readonly clock: Clock,
  ) {}

  async softDelete(id: string): Promise<Result<void>> {
    await this.prisma.task.update({
      where: { id },
      data: {
        deleteFlg: 1,
        updatedAt: this.clock.now(),
      },
    });
    return { ok: true, value: undefined };
  }
}

const mockClock: Clock = { now: () => new Date("2026-04-10T00:00:00Z") };

// 複数テーブル操作は $transaction
const result = await this.prisma.$transaction(async (tx) => {
  const task = await tx.task.findUnique({ where: { id } });
  if (!task) return { ok: false, error: { type: "NOT_FOUND", message: "..." } };

  await tx.taskHistory.create({
    data: { ...task, archivedAt: this.clock.now() },
  });
  await tx.task.update({ where: { id }, data: patch });

  return { ok: true, value: task };
});

# スキーマ変更後マイグレーション作成・適用
pnpm --filter backend prisma migrate dev --name <変更内容>

# Prisma Client 再生成
pnpm --filter backend prisma generate

# シード投入
pnpm --filter backend prisma db seed

# 未適用マイグレーションのみ適用
pnpm --filter backend prisma migrate deploy

prisma/
├── schema.prisma
├── seed.ts        ← シードエントリポイント
└── migrations/    ← 自動生成（手動編集禁止）

{
  "prisma": {
    "seed": "ts-node prisma/seed.ts"
  }
}

// NG: ループ内 findUnique（N+1）
const tasks = await this.prisma.task.findMany({ where: { deleteFlg: 0 } });
for (const task of tasks) {
  const products = await this.prisma.taskProduct.findMany({
    where: { taskId: task.id },
  });
  // ...
}

// OK: include で一括取得
const tasks = await this.prisma.task.findMany({
  where: { deleteFlg: 0 },
  include: {
    products: { include: { product: true } },
    dependencies: true,
  },
});

import { PrismaClientKnownRequestError } from "@prisma/client/runtime/library";

async findById(id: string): Promise<Result<Task>> {
  try {
    const task = await this.prisma.task.findUnique({
      where: { id, deleteFlg: 0 },
    });
    if (!task) {
      return { ok: false, error: { type: "NOT_FOUND", message: "タスクが見つかりません" } };
    }
    return { ok: true, value: task };
  } catch (err) {
    if (err instanceof PrismaClientKnownRequestError) {
      if (err.code === "P2025") {
        return { ok: false, error: { type: "NOT_FOUND", message: "タスクが見つかりません" } };
      }
    }
    throw err;
  }
}

コード	意味	対応
`P2002`	ユニーク制約違反	CONFLICT エラーとして返す
`P2025`	レコードが見つからない	NOT_FOUND エラーとして返す
`P2003`	外部キー制約違反	INVALID_REFERENCE エラーとして返す

機能	対応方針
Temporal Table	非サポート。監査ログ（ADR-0011）で代替
Full-Text Search (CONTAINS / FREETEXT)	`$queryRaw` + `Prisma.sql` で実装
ROWVERSION (楽観的ロック)	`Bytes` 型で取扱
`NEWSEQUENTIALID()`	`@default(dbgenerated("NEWSEQUENTIALID()"))` または UUID v7

model Task {
  // ... 他フィールド
  // Prisma 7: @db.RowVersion は使用不可。Bytes で定義
  rowVersion Bytes @map("ROW_VERSION")
}

// 楽観的ロック: rowVersion 確認
async update(
  id: string,
  data: TaskPatch,
  expectedRowVersion: Buffer,
): Promise<Result<Task>> {
  const updated = await this.prisma.task.updateMany({
    where: { id, deleteFlg: 0, rowVersion: expectedRowVersion },
    data: { ...data, updatedAt: this.clock.now() },
  });

  if (updated.count === 0) {
    return {
      ok: false,
      error: { type: "CONFLICT", message: "他のユーザーにより変更されています。再読み込みしてください。" },
    };
  }

  return await this.findById(id);
}

// $queryRaw + Prisma.sql で実装（$queryRawUnsafe 禁止）
async searchByContent(keyword: string): Promise<Result<Task[]>> {
  const tasks = await this.prisma.$queryRaw<Task[]>(
    Prisma.sql`
      SELECT * FROM tasks
      WHERE CONTAINS(DESCRIPTION, ${keyword})
        AND DELETE_FLG = 0
    `,
  );
  return { ok: true, value: tasks };
}

// NG: SQL Server で循環カスケードエラー
task Task @relation("TaskSuccessor", fields: [taskId], references: [id])

// OK: NoAction で循環を断つ
task Task @relation("TaskSuccessor", fields: [taskId], references: [id], onDelete: NoAction, onUpdate: NoAction)

Prisma Sqlserver

Prisma + SQL Server Skill

レビュー自己チェックリスト（DB 変更時）

1. PrismaService（NestJS DI）

Prisma Sqlserver

Prisma + SQL Server Skill

レビュー自己チェックリスト（DB 変更時）

1. PrismaService（NestJS DI）

2. SQL Server 接続設定

`schema.prisma` の datasource 設定

接続プール

SQL Server 固有の注意点

3. 論理削除パターン

クエリパターン

4. Clock ファクトリ

実装

NestJS への登録

Service での使用

テストでのモック

5. トランザクション制御

6. マイグレーション・シード

開発時

本番デプロイ時

破壊的変更のルール

`prisma/seed.ts` の実装場所

7. N+1 クエリ防止

8. Prisma エラーハンドリング

よく使う Prisma エラーコード

9. SQL Server 固有の制約・注意事項

9.1 Prisma がサポートしないSQL Server機能

9.2 ROWVERSION

9.3 Full-Text Search

9.4 SQL Server の循環 FK 制約

Postgres Patterns

Postgres Patterns

Database Migrations

Postgres Patterns

Postgres Patterns

Jpa Patterns

Prisma Sqlserver

Prisma + SQL Server Skill

レビュー自己チェックリスト（DB 変更時）

1. PrismaService（NestJS DI）

Prisma Sqlserver

Prisma + SQL Server Skill

レビュー自己チェックリスト（DB 変更時）

1. PrismaService（NestJS DI）

2. SQL Server 接続設定

schema.prisma の datasource 設定

接続プール

SQL Server 固有の注意点

3. 論理削除パターン

クエリパターン

4. Clock ファクトリ

実装

NestJS への登録

Service での使用

テストでのモック

5. トランザクション制御

6. マイグレーション・シード

開発時

本番デプロイ時

破壊的変更のルール

prisma/seed.ts の実装場所

7. N+1 クエリ防止

8. Prisma エラーハンドリング

よく使う Prisma エラーコード

9. SQL Server 固有の制約・注意事項

9.1 Prisma がサポートしないSQL Server機能

9.2 ROWVERSION

9.3 Full-Text Search

9.4 SQL Server の循環 FK 制約

Postgres Patterns

Postgres Patterns

Database Migrations

Postgres Patterns

Postgres Patterns

Jpa Patterns

`schema.prisma` の datasource 設定

`prisma/seed.ts` の実装場所