MongoDB
Prisma ORMをMongoDBデータベースに接続し、データベースアクセス用のPrisma Clientを生成することにより、新しいNode.jsまたはTypeScriptプロジェクトをゼロから作成する方法を学びます。次のチュートリアルでは、Prisma CLIとPrisma Clientを紹介します。
前提条件
このガイドを正常に完了するには、以下が必要です。
-
Node.js がマシンにインストールされていること(公式にサポートされているバージョンについては、システム要件を参照してください)
-
レプリカセットデプロイメントを備えたMongoDB 4.2+サーバーへのアクセス。 MongoDB Atlasを使用することをお勧めします。
データベースの接続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
が作成されます。
これで、npx
をプレフィックスとして付けることでPrisma CLIを呼び出すことができます。
npx prisma
次に、次のコマンドを使用してPrismaスキーマファイルを作成して、Prisma ORMプロジェクトをセットアップします。
npx prisma init --datasource-provider mongodb --output ../generated/prisma
このコマンドはいくつかのことを行います。
- データベース接続変数とスキーマモデルを含むPrismaスキーマを含む
schema.prisma
という名前のファイルを格納するprisma
という名前の新しいディレクトリを作成します。 datasource
を次のように設定します。MongoDBそして、出力をそれぞれカスタムロケーションに設定します。- プロジェクトのルートディレクトリに
.env
ファイルを作成します。これは、環境変数(データベース接続など)を定義するために使用されます。
gitなどのバージョン管理を使用している場合は、生成されたクライアントをアプリケーションから除外するために、.gitignore
に行を追加することをお勧めします。この例では、generated/prisma
ディレクトリを除外します。
generated/prisma/
prisma init
によって作成されたデフォルトのスキーマは、provider
としてPostgreSQLを使用していることに注意してください。datasource-provider
オプションでプロバイダーを指定しなかった場合は、datasource
ブロックを編集して、代わりにmongodb
プロバイダーを使用する必要があります。
datasource db {
provider = "mongodb"
url = env("DATABASE_URL")
}