メインコンテンツへスキップ

ORMのリリースと成熟度レベル

このページでは、Prisma ORMのリリースプロセス、バージョン管理方法、およびリリース全体で発生する可能性のある破壊的変更への対処方法について説明します。

リリース​

Prisma ORMのリリースは通常3週間ごとに行われます。ただし、これは*厳密な*ルールではなく、内部的な理由でリリースが延期される場合があることに注意してください。

GitHubですべてのリリースノートを確認してください.

製品の成熟度レベル​

1つのリリースには、異なる成熟度レベルの製品または機能が含まれる場合があります。成熟度レベルは、製品または機能の完成度と、ユーザーが破壊的変更に関して何を期待できるかを示します。

注：バージョン2.13.0以降、「Experimental」は製品の成熟度スケールの一部ではなくなりました。

早期アクセス​

機能または製品が早期アクセスの場合は

  • 私たちは問題を検証し、その解決策を検討していますが、その解決策が完全であるか、完璧に適合するかは確信していません。
  • ユーザーが重大な破壊的変更に対応できることを理解した上で、より多くのフィードバックを収集し、必要に応じてソリューションを調整したいと考えています。

早期アクセス機能または製品を本番環境で使用することはお勧めしません。

プレビュー​

機能または製品がプレビューの場合は

  • 方向性と表面に関して、機能または製品を検証しました。
  • リリースノートとドキュメントで特に明記されていない限り、ユーザーは機能または製品および関連するAPIがほぼ安定していると考えることができます。
  • 重大な既知の問題はありませんが、軽微なバグが存在する可能性があります。
  • ソリューションをできるだけ早く安定させるために、これらに関するフィードバックをお待ちしています。

プレビューは通常、フィーチャーフラグの背後にあるか、何らかのオプトインが必要です（たとえば、CLIで`--preview-feature`フラグを指定するか、PrismaスキーマのPrisma Clientの`generator`ブロックに`previewFeatures`プロパティを追加するなど）。

プレビュー機能または製品を本番環境で使用することはお勧めしません。

参照：現在利用可能なすべてのプレビュー機能。

一般提供 (GA)​

機能または製品が一般提供の場合は

  • ソリューションはしばらくの間テストされており、安定していて本番環境での使用準備が整っていると見なすのに十分なフィードバックを受け取りました。
  • 99％のケースでバグがないはずです（完全にバグのないソフトウェアは保証できません）

バージョニング​

Prisma ORMのリリーススキームは、バージョン3.x.x以降、セマンティックバージョニング（SemVer）に準拠しています。

Prisma ORMとセマンティックバージョニング（SemVer）​

SemVerバージョニングはどのように機能しますか？​

セマンティックバージョニング（SemVer）は、バージョンアップグレードに次のルールを使用します（SemVer仕様から引用）。

バージョン番号 MAJOR.MINOR.PATCH が与えられた場合、以下をインクリメントします。

  1. MAJORバージョン：互換性のないAPI変更を行う場合
  2. MINORバージョン：後方互換性のある方法で機能を追加する場合
  3. PATCHバージョン：後方互換性のあるバグ修正を行う場合

Prisma ORMのバージョニングはどのようにSemVerに従いますか？​

バージョン3.x.x以降、Prisma ORMはSemVerバージョニングスキームに厳密に準拠しています。

Prisma ORMがSemVerにどのように従うかの簡単な概要を以下に示します

  • 安定版サーフェス（つまり一般提供）の破壊的変更は、新しいMAJORリリースでのみ導入されます。
  • 破壊的変更はMINORでも展開できますが、デフォルトでアクティブでないオプトインプレビューおよび早期アクセス機能（例：プレビューフィーチャーフラグ、特定のオプトインオプション、または新しいCLIコマンド経由）に限ります。
  • MINORでリリースされたオプトインの破壊的変更（つまりプレビューと早期アクセス）は、新しいMAJORリリースでのみ一般提供（オプトインの要件なし）に昇格されます。

バージョン番号 MAJOR.MINOR.PATCH が与えられた場合、Prisma ORMのバージョン番号は次のようにインクリメントされます

  1. MAJORバージョン：破壊的変更を伴う主要な製品アップデートが一般提供にリリースされる場合にインクリメントされます。
  2. MINORバージョン：後方互換性のある新機能を追加する製品アップデートがリリースされる場合にインクリメントされます。破壊的変更のある機能は、オプトイン（つまり早期アクセスとプレビュー）の場合にのみ導入できます。
  3. PATCHバージョン：機能のバグが修正され、常に後方互換性がある場合にインクリメントされます。

注：バージョン2.28.0まで、Prisma ORMはSemVerバージョニングに厳密に従っていませんでした。これは、2.MINOR.PATCH範囲のリリース、MINORバージョンに破壊的変更が含まれている可能性があることを意味します。Prisma ORMのSemVerの採用の詳細については、ブログ記事を確認してください。