リレーショナルデータベース (JavaScriptとSQL Server)

JavaScript

SQL Server

Prisma ORMをデータベースに接続し、データベースアクセス用のPrisma Clientを生成して、Node.jsまたはTypeScriptプロジェクトをゼロから新規作成する方法を学びます。このチュートリアルでは、Prisma CLI、Prisma Client、Prisma Migrateについて紹介します。

前提条件

このガイドを正常に完了するには、以下が必要です。

• マシンにNode.jsがインストールされていること（公式にサポートされているバージョンはシステム要件を参照）
• Microsoft SQL Serverデータベース
  • Docker用Linux版Microsoft SQL Server
  • Windows (ローカル)版Microsoft SQL Server

正確なバージョン要件については、システム要件を参照してください。

データベースの接続URLを手元に用意してください。データベースサーバーが実行されておらず、Prisma ORMを試してみたいだけであれば、クイックスタートを参照してください。

プロジェクトのセットアップを作成

まず、プロジェクトディレクトリを作成し、その中に移動します。

mkdir hello-prisma
cd hello-prisma

次に、Node.jsプロジェクトを初期化し、Prisma CLIを開発依存として追加します。

npm init -y
npm install prisma --save-dev

これにより、Node.jsアプリケーションの初期設定を含むpackage.jsonが作成されます。

情報

別のパッケージマネージャーを使用して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を以下に設定します。SQL Serverそして、それぞれ出力をカスタムの場所に設定します。
• プロジェクトのルートディレクトリに.envファイルを作成します。これは、環境変数（データベース接続など）を定義するために使用されます。

prisma initによって作成されるデフォルトのスキーマは、providerとしてPostgreSQLを使用します。datasource-providerオプションでプロバイダーを指定しなかった場合、datasourceブロックを編集して代わりにsqlserverプロバイダーを使用する必要があります。

prisma/schema.prisma

datasource db {
  provider = "sqlserver"
  url      = env("DATABASE_URL")
}