Prisma 2.0 ベータ版公開：Prisma Client によるタイプセーフなデータベースアクセス

目次

• Prisma Client 2.0 による最新のデータベースアクセス
• 今回のリリース内容
• prisma2 リポジトリから prisma へのリネーム
• prisma2 CLI のリネーム
• 現在 Prisma 1 を使用していますが、どうすればよいですか？
• Prisma 2.0 を試してフィードバックを共有してください

---

TL;DR（要約）

• Prisma 2.0 ベータ版がリリースされました。新しいウェブサイトとドキュメントにより、Prisma を使い始める新しい開発者にとってデフォルトとなりました。
• Prisma 2.0 は主に、Node.js および TypeScript 用の自動生成されたタイプセーフなクエリビルダーである Prisma Client で構成されています。Prisma Migrate は実験的な機能と見なされています。
• prisma/prisma2 リポジトリは prisma/prisma にリネームされました（以前の Prisma 1 リポジトリ prisma/prisma リポジトリは prisma/prisma1 と呼ばれるようになりました）。

新しいドキュメントのクイックスタートに従って、新しい Prisma Client を 5 分でお試しください。

---

Prisma Client 2.0 による最新のデータベースアクセス

新しいバージョンの Prisma Client は、Node.js および TypeScript 向けの最新のデータベースアクセスライブラリです。従来の ORM や SQL クエリビルダーの代替として、データベース内のデータの読み取りと書き込みに使用できます。

セットアップするには、Prisma スキーマファイルが必要で、Prisma Client をプロジェクトの依存関係として追加する必要があります。

Prisma Client は、あらゆる Node.js または TypeScript バックエンドアプリケーション（サーバーレスアプリケーションやマイクロサービスを含む）で使用できます。これは、REST API、GraphQL API、gRPC API、またはデータベースを必要とするその他のものにすることができます。

データベースの生産性を向上させる

Prisma Client の主な目標は、データベースを扱うアプリケーション開発者の生産性を向上させることです。これは、プレーンな JavaScript オブジェクトを返すクリーンなデータアクセス API を提供することで実現します。

このアプローチにより、データベースクエリに関する推論が簡素化され、予測可能（かつタイプセーフ）なクエリ結果に対する信頼性が高まります。Prisma Client が提供する主な利点をいくつかご紹介します。

• コードエディタでの自動補完により、ドキュメントを参照する必要がなくなります。
• リレーショナルデータをマッピングする代わりに、オブジェクトで考えることができます。
• コンパイル時に検証できるタイプセーフなデータベースクエリを実現します。
• データベースとアプリケーションモデルの単一の真実の情報源を提供します。
• 一般的な落とし穴やアンチパターンを防ぐ健全な制約を提供します。
• 正しいことを簡単にする抽象化（「成功への落とし穴」）を提供します。
• 複雑なモデルオブジェクトを避けるために、クラスではなくクエリを使用します。
• ボイラープレートの削減により、開発者はアプリの重要な部分に集中できます。

Prisma が開発者の生産性をどのように向上させるかについて詳しくは、概要をご覧ください。または、ウェブサイトでコード例を確認して、Prisma Client API の概要をご覧ください。

「スマート」Node モジュール 🤓

@prisma/client モジュールは、「従来の」Node モジュールとは異なります。従来の Node モジュール（例：lodash）では、パッケージ全体が node_modules ディレクトリにダウンロードされ、パッケージを再インストールした場合にのみ更新されます。

@prisma/client Node モジュールは異なります。これは、機能コードを含まない「ファサードパッケージ」（基本的にスタブ）です。

npm install @prisma/client で一度インストールする必要がありますが、アプリケーションを開発するにつれて、node_modules/@prisma/client ディレクトリ内のコードはより頻繁に変更される可能性があります。これは、Prisma スキーマを変更するたびに、Prisma Client を再生成する必要があるため、@prisma/client Node モジュールのコードが更新されるためです。

node_modules/@prisma/client ディレクトリには、プロジェクトに合わせたコードが含まれているため、「スマート Node モジュール」と呼ばれることがあります。

プレーンな JavaScript でも自動補完とタイプセーフのメリット

自動補完は、開発者にとって非常に強力なツールです。ドキュメントを参照する代わりに、エディタで直接 API を調べることができます。Prisma Client は、データベースクエリに自動補完をもたらします！

@prisma/client モジュールの index.d.ts に含まれている Prisma Client の生成された型のおかげで、この機能は TypeScript 開発者だけでなく、プレーンな JavaScript でアプリケーションを開発する場合にも利用できます。

部分的なデータベースクエリのタイプセーフ

他の ORM やデータベースツールと比較した Prisma Client の主な利点は、完全なタイプセーフを提供することです。これは、「部分的な」データベースクエリ（つまり、モデルのフィールドのサブセットのみをクエリする場合や、リレーションを含める場合）でも同様です。

例として、次の Prisma Client クエリを考えてみましょう（タブを切り替えて、対応するPrisma モデルを表示できます）。

結果の usersWithPartialPosts は、静的に型付けされることに注意してください。

これは、データベースから要求されなかったプロパティにタイプミスや誤ってアクセスした場合、TypeScript がエラーを検出することを意味します！

はじめに

Prisma Client を使い始める最良の方法は、ドキュメントのクイックスタートに従うことです。

クイックスタート（5 分）

または、次の方法も使用できます。

• Prisma を使用して新しいプロジェクトをゼロからセットアップする
• 既存のプロジェクトに Prisma を追加する

今回のリリース内容

Prisma 2.0 ベータ版には、次のツールが付属しています。

• Prisma Client：Node.js および TypeScript 用の自動生成されたタイプセーフなクエリビルダー
• Prisma Migrate（実験的）：宣言的なスキーマ移行ツール
• Prisma Studio（実験的）：データベース内のデータを表示および編集するための GUI

新しいドキュメントのクイックスタートに従って、新しい Prisma Client を 5 分でお試しください。

注：ベータ版リリースの詳細については、リリースノートをご覧ください。

prisma2 リポジトリから prisma へのリネーム

最初のリリース以来、Prisma 2.0 のメインリポジトリは prisma2 と呼ばれていました。

Prisma 2.0 が Prisma を使い始める開発者にとってデフォルトになったため、Prisma リポジトリは次のようにリネームされました。

• prisma/prisma2 リポジトリは prisma/prisma にリネームされました。
• prisma/prisma リポジトリは prisma/prisma1 にリネームされました。

prisma2 CLI のリネーム

プレビュー期間中、Prisma 2.0 の CLI は prisma2 コマンドを使用して呼び出されていました。Prisma 2.0 が Prisma を使い始める新しい開発者にとってデフォルトになったため、コマンドは単に prisma に変更されました。既存の Prisma 1 の prisma コマンドは prisma1 にリネームされました。

また、npm パッケージのインストールも変更されることに注意してください。

現在の Prisma 1 ユーザーへの注意

現在 prisma コマンドで Prisma 1 を使用している場合は、これまでどおり使用し続けることができます。Prisma 2.0 にアップグレードしたい場合は、現在の prisma インストールをアンインストールし、必要なプロジェクトに新しい CLI バージョンをローカルにインストールすることをお勧めします。

prisma2 npm パッケージは非推奨

prisma2 npm パッケージは非推奨になりました。インストール時の混乱を防ぐために、インストールしようとすると次の出力が表示されるようになりました。

---

現在 Prisma 1 を使用していますが、どうすればよいですか？

まず、既存のすべての Prisma 1 ユーザーに心から感謝申し上げます！🙏 GitHub とSlackで形成された、協力的で活発なコミュニティに深く感謝しています！

Prisma 2.0 は Prisma 1 とどのように異なりますか？

Prisma 2.0 は、Prisma 1 と比較して多くの変更が加えられています。主な違いの概要を以下に示します。

• Prisma 2.0 では、データベースプロキシサーバー（つまり、Prisma サーバー）をホストする必要はありません。
• Prisma 2.0 は、「データベース用の GraphQL API」を公開しなくなりましたが、Prisma Client API を介したプログラムによるアクセスのみを許可します。
• Prisma 2.0 は、Prisma 1 の機能をよりモジュール化し、専用ツールに分割します。
  • Prisma Client：Prisma client 1.0 の改良版
  • Prisma Migrate：データモデリングと移行（以前の prisma deploy）。
• より強力なイントロスペクションにより、Prisma 2.0 を既存のデータベースに接続できます。
• Prisma 1 データモデルと prisma.yml は、Prisma スキーマに統合されました。
• Prisma 2.0 は、GraphQL SDL に基づくのではなく、独自のモデリング言語を使用します。
• Nexus またはその他の任意のGraphQL ライブラリを使用して、Prisma で GraphQL サーバーを構築できます。

Prisma 1 ドキュメントにアクセスするにはどうすればよいですか？

https://prisma.dokyumento.jp/docs にバージョン番号を追加することで、Prisma 1 ドキュメントの特定のバージョンにアクセスし続けることができます。たとえば、Prisma バージョン 1.34 のドキュメントを表示するには、https://v1.prisma.io/docs/1.34/ にアクセスしてください。

Prisma 1 の例は、prisma1-examples リポジトリに移動されました。

アップグレードすべきですか？

アップグレードすべきかどうかは、プロジェクトのコンテキストによって異なります。一般的に、主な考慮事項の 1 つは、Prisma Migrate がまだ実験的であるという事実です。これは、今後のデータベーススキーマの調整は、SQL または別の移行ツールを使用して行う必要がある可能性が高いことを意味します。

また、今後数週間以内に、アップグレードガイドと専用ツールもまとめます。したがって、Prisma Migrate がまだ準備ができていないにもかかわらずアップグレードしたい場合は、これらのリソースが整うまで待つ価値があるかもしれません。

Prisma 2.0 を試してフィードバックを共有してください

Prisma 2.0 のベータ版をようやく公開できることを非常に嬉しく思っており、皆様がこれで何を構築するのか楽しみにしています。

Prisma 2.0 を始める

フィードバックを残したり、アイデアを共有したり、機能リクエストを作成したり、バグレポートを送信したりする場合は、（リネームされた）GitHub のprismaリポジトリで行い、（リネームされた）#prisma2-betaチャネル（Prisma Slack）にご参加ください！