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

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Replitデータベースは完全マネージドのSQLデータベースを使用し、プロジェクトエディターからReplit Appに永続的なデータストレージを追加できます。
最も簡単な始め方は、Agentにデータベースをアプリに追加するよう依頼することです。Agentがインテグレーションを設定し、データベーススキーマを作成し、データを保存・取得するようにアプリを更新します。
データベースエディターのスクリーンショット

​
機能

Replitデータベースツールは以下の機能を提供します：
  • データベースツール：組み込みのSQLツールでクエリを実行し、データベーススキーマを管理し、データを視覚化します
  • タイムトラベル：ロールバック機能を使ってデータベースを任意のAgentチェックポイントに復元します
  • 無料ストレージ：すべてのReplit Appに20GBの無料ストレージが含まれます
  • 環境変数：Replit Appで環境変数を使ってデータベースに安全にアクセスします
2025年12月4日以前、開発データベースはNeonでホストされており、いくつかの重要な違いがあります。 詳細はレガシーNeon開発データベースのセクションを参照してください。

​
使い方

プロジェクトエディターから直接Replitデータベースツールにアクセスできます。 以下のセクションでは、データベースのセットアップと管理方法を説明します。
左側のツールドックから：
  1. 全ツールアイコン 全てのツールを選択してプロジェクトエディターのツール一覧を表示します。
  2. PostgreSQLデータベースアイコン データベースを選択します。
検索バーから：
  1. 上部の虫眼鏡アイコン虫眼鏡を選択して検索ツールを開きます
  2. 「Replit Database」と入力してツールを見つけ、結果から選択します。

​
データベースを追加する

すべてのReplit Appにはデフォルトでデータベースが付属しています。プロジェクトエディターのPostgreSQLデータベースアイコン データベースツールを選択してアクセスできます。 AgentにPostgreSQLデータベースをReplit Appに追加するよう依頼し、アプリが保存すべきデータの詳細を指定することで、データベースをインテグレーションできます。Agentがデータベーススキーマを作成し、データベースと通信するようにアプリを更新します。

​
データベースを以前の状態に復元する

ロールバック機能を使ってアプリとデータベースを以前の状態に戻すことができます。 この機能では、Agentが作成した任意のチェックポイントにデータベースを復元できます。
ロールバックオプションを表示するチェックポイントロールバックインターフェース
チェックポイントの状態に復元する際は、「追加のロールバックオプション」の「データベース」を選択してください。これにより、データベースがチェックポイント時点の状態に復元されます。

​
データベースコマンドを実行する

SQLランナーは、データベースでSQLコマンドを実行して結果を表示するプロジェクトエディターのツールです。
Replitデータベースツールから：
  1. マイデータタブを選択します
  2. SQLランナーアイコン SQLランナーを選択します
クエリを実行するには、テキストエリアにSQL文を入力して、隣接するSQL実行アイコン実行ボタンを選択します：
SQLランナーと実行ボタンのスクリーンショット

​
データを視覚的に閲覧・編集する

ReplitデータベースツールにはDrizzle Studioが含まれており、データを視覚的に閲覧・編集できます。 これらのビジュアルツールはシンタックスエラーを回避し、以下の機能を提供します：
  • 特定の情報にフォーカスするためのデータのフィルタリングとソート
  • 外部利用のためのデータエクスポート
  • 行データの挿入または変更
  • スキーマ、テーブル、ビュー、列挙型の作成と管理
これらのツールはReplitデータベースツールのマイデータタブからアクセスできます。 以下の画像はDrizzle Studioビルダーインターフェースのビューです：
テーブル構造エディターの画像
環境変数にある接続文字列を使用して、PostgreSQL互換のSQLクライアントからデータベースに接続できます。

​
接続認証情報と使用状況を確認する

データベースの接続認証情報はReplit Appの環境変数として保存されます。 これらの認証情報は、アプリがデータベースに安全に接続してコマンドを実行するために使用されます。
  1. プロジェクトエディターでPostgreSQLデータベースアイコン Replitデータベースツールに移動します
  2. 開発データベースまたは本番データベースを選択します
  3. 歯車アイコン 設定タブ（歯車アイコン）を選択します。このタブにはデータベースの接続認証情報とストレージ使用量が表示されます。

​
環境変数

開発データベースへの接続に利用可能な環境変数は以下の通りです：
  • DATABASE_URL：データベースへの接続と認証の方法
このDATABASE_URLはアプリからのみ使用でき、仮に漏洩しても他者がデータベースにアクセス・変更するために使用することはできません。
開発データベースがまだレガシーNeonインフラにある場合、次の追加環境変数も利用可能です：PGHOST、PGUSER、PGPASSWORD、PGDATABASE、PGPORT。これらの個別の接続変数はReplitの現在のインフラでホストされているデータベースには提供されません — 代わりにDATABASE_URLを使用してください。
このDATABASE_URLはアプリにスコープされているため、開発データベースは他のアプリ（あなた自身が所有するものや外部のデータベースビューアーも含む）からはアクセスできません。 この分離はセキュリティのベストプラクティスに従っており、データベースへの不正アクセスを防ぎます。
レガシーNeon開発データベースをまだ使用している場合は、DATABASE_URLを共有しないでください。 データベースの認証情報が含まれており、誰でもデータベースにアクセス・変更するために使用できます。 公開の場所やサポートチケットには絶対に貼り付けないでください。

​
セキュリティ機能

Agentを使ってデータベースインテグレーションを追加すると、組み込みのセキュリティでデータベース通信を処理するオブジェクト・リレーショナル・マッパー（ORM）が追加されます。 このORMレイヤーとAgentのセキュリティベストプラクティスの実装により、以下の機能を通じてアプリが攻撃から保護されます：
  • スキーマ検証：データが期待される形式に準拠しているか検証します
  • データサニタイズ：SQLインジェクション攻撃を防ぐためにビルダーの入力を自動的にクリーンアップします

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

2025年12月4日以前、開発データベースはNeonでホストされていました。 このデータベースは廃止され、新しい開発データベースはすべてReplitの独自データベースインフラでホストされています。 DATABASE_URL環境変数を確認することで、開発データベースがNeonでホストされているかどうかを確認できます。
DATABASE_URLにneon.tech/neondbが含まれている場合、開発データベースはまだNeonでホストされています。 helium/heliumdbが含まれている場合は、開発データベースがReplitでホストされています。
以下は、レガシーNeon開発データベースと新しいReplit開発データベースの主な違いです：
機能Replit（現在）Neon（レガシー）
ホスティングReplit独自のインフラでホストNeon（サードパーティプロバイダー）でホスト
請求すべてのReplit Appに無料で含まれる使用量ベースの請求。詳細は発行とデータベースの請求を参照。
復元機能ロールバック機能を使って任意のチェックポイントにデータベースを復元できますポイントインタイム復元（PITR）— バックアップ保持期間内の任意の時点に復元できます。
接続セキュリティアプリ内からのみアクセス可能で、公開されることはありません。完全な接続文字列を使用 — 漏洩した場合、誰でもデータベースにアクセス・変更できます。
リミックス動作リミックスすると、分離とセキュリティのためにデータがコピーされた新しい開発データベースが作成されます。リミックスは同じデータベースをすべてのコピーで再利用するため、リミックスの変更が元のアプリに影響する可能性があります。
データベース作成各Replit Appに自動的に作成されます。明示的なセットアップが必要でした。
発行ワークフローデプロイまたは発行には、環境間の分離のために本番データベースの作成が必要です。開発と本番は同じデータベースを共有しており、意図しない開発の変更が本番アプリに影響する可能性がありました。
レガシーNeonデータベースの使用中にアプリがフォークまたはリミックスされた場合、発行したアプリはまだ元のアプリのデータベースURLを参照している可能性があります。データベースアップグレード後、この共有接続は機能しなくなります。発行したアプリの更新方法については共有データベースを使用する発行済みアプリの修正を参照してください。