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

MongoDB

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

前提条件

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

  • Node.js がマシンにインストールされていること(公式にサポートされているバージョンについては、システム要件を参照してください)

  • レプリカセットデプロイメントを備えたMongoDB 4.2+サーバーへのアクセス。 MongoDB Atlasを使用することをお勧めします。

    警告

    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ディレクトリを除外します。

.gitignore
generated/prisma/

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

prisma/schema.prisma
datasource db {
provider = "mongodb"
url = env("DATABASE_URL")
}