データベースを接続する

データベースを接続するには、Prismaスキーマのdatasourceブロックのurlフィールドをデータベースの接続URLに設定する必要があります。

prisma/schema.prisma

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

また、datasourceブロックで外部キー制約をエミュレートするために、relation mode typeをprismaに設定する必要があります。

schema.prisma

datasource db {
  provider     = "mysql"
  url          = env("DATABASE_URL")
  relationMode = "prisma"
}

注記: 2024年2月以降、PlanetScaleのデータベースレベルで外部キー制約を使用することもできます。これにより、relationMode = "prisma"を設定する必要がなくなります。

urlは、.envで定義されている環境変数経由で設定されます。

.env

DATABASE_URL="mysql://janedoe:mypassword@server.us-east-2.psdb.cloud/mydb?sslaccept=strict"

次に、接続URLを独自のデータベースを指すように調整する必要があります。

データベースの接続URLの形式は、通常、使用するデータベースによって異なります。PlanetScaleはMySQL接続URL形式を使用しており、次の構造になっています（すべて大文字でスペルアウトされた部分は、特定の接続詳細のプレースホルダーです）。

mysql://USER:PASSWORD@HOST:PORT/DATABASE

各コンポーネントの簡単な説明を以下に示します。

USER: データベースユーザーの名前
PASSWORD: データベースユーザーのパスワード
PORT: データベースサーバーが実行されているポート（通常はMySQLの場合は3306）
DATABASE: データベースの名前

PlanetScaleでホストされているデータベースの場合、接続URLは次のようになります。

.env

DATABASE_URL="mysql://myusername:mypassword@server.us-east-2.psdb.cloud/mydb?sslaccept=strict"

特定のデータベースブランチの接続URLは、PlanetScaleアカウントから、ブランチの概要ページに移動し、[Connect]ドロップダウンを選択すると見つけることができます。[Passwords]セクションで、新しいパスワードを生成し、[Prisma]を選択して、接続URLのPrisma形式を取得します。

別の方法：PlanetScale CLIを使用した接続

または、PlanetScale CLIを使用してPlanetScaleデータベースサーバーに接続し、ローカル接続URLを使用できます。この場合、接続URLは次のようになります。

.env

DATABASE_URL="mysql://root@localhost:PORT/mydb"

情報

環境変数をコミットしないように、.envを.gitignoreファイルに追加することをお勧めします。

ブランチに接続するには、次のコマンドを使用します。

pscale connect prisma-test branchname --port PORT

デフォルトポート3306を使用している場合、--portフラグは省略できます。