備份
總覽
在 Pro 和 Business 方案中，Prisma Postgres 會自動建立資料庫快照，以支援復原與備份工作流程。請前往 Prisma Postgres 實例的備份 (Backups) 頁籤，以檢視並重新實例化您可用的備份。
快照會每日建立，但僅限於資料庫當天有活動的情況下。根據您的方案，您將會看到不同數量的可用快照：
| 方案 | 快照保留期限 |
|---|---|
| 專業版 | 最近 7 天 |
| 商業版 | 最近 30 天 |
請注意，在最近一次快照之後發生的任何資料庫變更或事件可能無法被還原。
若要了解更多關於備份可用性與各方案功能的詳細資訊，請造訪我們的定價頁面。
注意
未來，Prisma Postgres 將基於使用者特定的配置，提供更細緻的備份機制以及時間點還原 (point-in-time restore) 功能。
透過 pg_dump 手動建立備份檔案
如果您想建立資料庫的備份檔案，可以使用 pg_dump 並透過直接連線 (direct connection) 進行操作。這對於在不同資料庫之間遷移資料或建立資料庫的本機副本非常有用。
先決條件
開始之前，請確保您已安裝：
- Node.js（16 版或更高版本）。
- PostgreSQL CLI 工具 (
pg_dump)，用於建立備份。請使用 Postgres 17 版本，因為 Prisma Postgres 是基於此版本建構的。 - 用於 Prisma Postgres 資料庫的直接連線字串 (direct connection string)。
1. 安裝 PostgreSQL 命令列工具
為了建立備份，請確保已安裝 PostgreSQL 命令列工具。請根據您的作業系統執行下列指令：
- macOS
- Windows
- Linux
brew install postgresql@17
which pg_dump
which pg_restore
# Download from the official PostgreSQL website:
# https://postgresql.dbms.tw/download/windows/
# During installation, select "Command Line Tools".
# Then verify with:
where pg_dump
where pg_restore
sudo apt-get update
sudo apt-get install postgresql-client-17
which pg_dump
which pg_restore
提示
如果您已安裝 PostgreSQL，但在執行 pg_dump 或 pg_restore 時仍看到「command not found」（找不到指令）錯誤，請確保安裝目錄已包含在您系統的 PATH 環境變數中。
2. 使用 pg_dump 建立備份
請按照此處的說明，取得 Prisma Postgres 的直接連線字串。
現在，您可以使用自己的連線字串執行下列指令來匯出資料庫：
pg_dump --dbname="postgres://USER:PASSWORD@db.prisma.io:5432/?sslmode=require" > ./mydatabase.bak
這將會在目前目錄下建立一個名為 mydatabase.bak 的備份檔案。