リレーショナルデータベース (TypeScript と SQL Server)
Prisma ORM をデータベースに接続し、データベースアクセス用の Prisma Client を生成することで、Node.js または TypeScript プロジェクトをゼロから作成する方法を学びます。このチュートリアルでは、Prisma CLI、Prisma Client、および Prisma Migrate を紹介します。
前提条件
このガイドを正常に完了するには、以下が必要です。
- Node.js がマシンにインストールされていること (公式にサポートされているバージョンについてはシステム要件を参照)。
- Microsoft SQL Server データベース
正確なバージョン要件については、システム要件を参照してください。
データベースの接続 URL を手元に用意してください。データベースサーバーが実行されておらず、Prisma ORM を試してみたいだけであれば、クイックスタートを参照してください。
プロジェクトのセットアップを作成
まず、プロジェクトディレクトリを作成し、その中に移動します。
mkdir hello-prisma
cd hello-prisma
次に、TypeScript プロジェクトを初期化し、Prisma CLI を開発依存関係として追加します。
npm init -y
npm install prisma typescript tsx @types/node --save-dev
これにより、TypeScript アプリの初期設定を含む package.json
が作成されます。
次に、TypeScript を初期化します。
npx tsc --init
別のパッケージマネージャーを使用して Prisma をインストールする方法については、インストール手順を参照してください。
これで、npx
をプレフィックスとして付けて Prisma CLI を呼び出すことができます。
npx prisma
次に、以下のコマンドを使用して Prisma Schema ファイルを作成し、Prisma ORM プロジェクトをセットアップします。
npx prisma init --datasource-provider sqlserver --output ../generated/prisma
このコマンドはいくつかのことを行います。
prisma
という新しいディレクトリを作成し、その中にschema.prisma
というファイルを作成します。このファイルには、データベース接続変数とスキーマモデルを含む Prisma Schema が含まれます。datasource
を以下に設定します。SQLServerそして、出力をカスタムの場所にそれぞれ設定します。- プロジェクトのルートディレクトリに
.env
ファイルを作成します。これは環境変数 (データベース接続など) の定義に使用されます。
prisma init
によって作成されるデフォルトのスキーマでは、PostgreSQL が provider
として使用されることに注意してください。datasource-provider
オプションでプロバイダーを指定しなかった場合は、datasource
ブロックを編集して sqlserver
プロバイダーを使用する必要があります。
datasource db {
provider = "sqlserver"
url = env("DATABASE_URL")
}