開発環境と本番環境のデータベース

​

比較

​

公開時に本番データベースを作成する

• 現在のインフラストラクチャ(Helium): 開発データベースにデータが含まれている場合、Replitは公開時に本番データベースを自動的に作成します。
• レガシーNeon開発データベース: 公開設定から本番データベースを作成します。公開中にDatabase settingsを開き、Create production databaseをオンにします。必要に応じてSet up your production database with your current development dataもオンにすると、現在の開発データをコピーできます。

​

アプリが使用しているデータベースを確認する

• Project Editor: ワークスペース、Shell、Agentのセッションでは、DATABASE_URLは開発データベースを指します。Replitが自動的に接続するため、現在のインフラストラクチャではSecretsには表示されません。
• 公開したアプリ: 公開すると、アプリには本番データベースを指す別のDATABASE_URLが設定されます。

​

Agentに確認を依頼する

シークレットの値を表示したり何かを変更したりせずに、私のアプリがどのデータベースを使用しているか確認してください:
1. コードがデータベースへの接続に読み取る環境変数(例: DATABASE_URL)を見つけ、そのファイルと行を教えてください。
2. Secretsに私が追加したDATABASE_URLやその他のデータベース接続が含まれていないか確認し、名前だけを一覧表示してください。
3. 本番データベースに対して読み取り専用のクエリを実行してください。テーブルの一覧と、メインテーブルの最新5行を表示し、ライブアプリと比較できるようにしてください。

​

DatabaseツールとPublishingで確認する

1

本番データベースを開く

Databaseツールで、All Databasesの横にあるデータベースメニューを開き、Productionを選択します。

2

ライブアプリのレコードを探す

My Dataを開き、公開したアプリで最近作成したもの(新しいアカウントや注文など)を探します。それが見つかれば、公開したアプリはこのデータベースに書き込んでいます。本番は読み取り専用モードで開くため、閲覧しても安全です。

3

接続設定を比較する

本番データベースのSettingsタブを開き、Connection stringを探します。次にPublishingを開き、Adjust settingsを選択して、Production app secretsの下にあるDATABASE_URLを探します。それぞれの値を表示し、両方が同じホストを指していることを確認します。ほとんどのアプリでは、同じエンドポイントID(ep-で始まる部分)であることを意味します。プールされたアドレスではIDの後に-poolerが付くため、文字列全体が完全に一致する必要はありません。

どちらの値にもデータベースのパスワードが含まれています。ご自身で比較し、チャット、サポートチケット、スクリーンショットに貼り付けないでください。

4

Secretsに別のデータベースがないか確認する

Secretsを開きます。Replitの組み込み接続はここには表示されません。ご自身で追加したDATABASE_URLや、SUPABASE_DATABASE_URLなどの別のデータベース接続がある場合、アプリは代わりにそのデータベースを使用している可能性があります。コードがどちらを読み取っているかをAgentに尋ねてください。NEON_DATABASE_URLシークレットは、データベースインフラのアップグレードの際に保存された、以前の開発データベース接続です。コードがそれを読み取っている場合にのみ、アプリはそれを使用します。

​

結果の見方

​

コネクションプーリング

​

本番データベースへの安全な変更

• まだデータが含まれている列やテーブルの削除
• 既存の値が変換できない場合に失敗する可能性のある列のデータ型の変更
• すでに行があるテーブルに、デフォルト値なしで必須フィールドを追加すること
• テーブルや列の名前変更: Publishで確認を求められたときに名前変更を確定しないと、データが削除されます
• 既存の行が違反する可能性のあるテーブルへの一意制約の追加

​

公開プレビューで変更をテストする

• データベースの変更を適用した状態でも、主要なユーザーフロー全体でアプリが問題なく動作することを確認する
• 既存のデータが正しく移行され、新しいフィールドに期待される値が含まれていることを確認する
• クエリの応答時間にパフォーマンスの低下がないか確認する

​

請求とリソース使用量

​

本番データベースの削除

​

レガシー開発データベース

​

データベースインフラのアップグレード

• 低レイテンシとストレージの増加: データベースがアプリと同じReplitインフラストラクチャ上で動作するようになり、ストレージ制限が10GBから20GB（ProおよびEnterpriseプランでは50GB）に増加します。
• 同じデータベースエンジン: HeliumはNeonと同じバージョンのPostgreSQL 16を使用します。クエリ、スキーマ、データの動作は変わりません。
• 接続情報の自動更新: DATABASE_URLはHeliumを指すように更新されます。以前のNeon接続文字列は、参照用としてNEON_DATABASE_URLとしてSecretsに保存されます。
• 個別のPG変数の削除: PGHOST、PGPORT、PGUSER、PGPASSWORDは削除されます。代わりにDATABASE_URLを使用してください。

• ハードコードされたNeon接続文字列: neon.tech接続文字列を参照しているコードを、代わりにDATABASE_URL環境変数を使用するように更新してください。
• カスタムPostgreSQLロール: ロールと権限は自動的に移行されますが、ロールのパスワードはコピーできません。新しいデータベースでカスタムロールのパスワードをリセットしてください。

​

アップグレード後のSSL接続エラー

// 変更前(アップグレード後に動作しなくなる)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// 変更後(開発・本番の両方で動作する)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});

​

データベースを共有していたフォークされたアプリ

​

次のステップ

• Publishが本番データベースを更新する仕組み: 公開時にスキーマ変更をレビュー、テスト、承認します。
• データリカバリー: 開発または本番のデータを復元します。
• 接続の詳細: データベースの接続文字列を確認します。
• データを操作する: データを参照、編集、クエリします。