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

TypeScriptとCockroachDBを使用してデータベースを接続する

TypeScript
CockroachDB

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

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

urlは、.envで定義されている環境変数を通じて設定されます。これで、接続URLを自分のデータベースを指すように調整する必要があります。

使用するデータベースの接続URLの形式は、使用するデータベースによって異なります。CockroachDBはPostgreSQLの接続URL形式を使用しており、以下の構造を持っています（すべて大文字で表記されている部分は、具体的な接続情報のプレースホルダーです）

postgresql://USER:PASSWORD@HOST:PORT/DATABASE?PARAMETERS

各コンポーネントの簡単な説明は以下の通りです

  • USER: データベースユーザーの名前
  • PASSWORD: データベースユーザーのパスワード
  • PORT: データベースサーバーが動作しているポート。CockroachDBのデフォルトは26257です。
  • DATABASE: データベースの名前
  • PARAMETERS: 追加の接続パラメータ。CockroachDBのドキュメントをこちらで参照してください。

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

.env
DATABASE_URL="postgresql://<myusername>:<mypassword>@<short-id>.<region>.cockroachlabs.cloud:26257/defaultdb?sslmode=verify-full&sslrootcert=$HOME/.postgresql/root.crt&options=--<mycluster>"

CockroachDB Cloudで接続文字列を見つけるには、データベースクラスターの概要ページで「Connect」ボタンをクリックし、「Connection string」タブを選択します。

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

.env
DATABASE_URL="postgresql://root@localhost:26257?sslmode=disable"

コマンドラインからCockroachDBを起動すると、接続文字列がウェルカムテキストの一部として表示されます。

© . All rights reserved.