服務市集
PostgreSQL

在 Zeabur 部署 PostgreSQL

PostgreSQL 是一個功能強大的開源物件關係型資料庫系統,擁有超過 35 年的歷史,因其可靠性、功能健全性和效能而享有很高的聲譽。

Zeabur 提供了一鍵部署 PostgreSQL 服務的功能,讓你可以快速地在 Zeabur 上部署 PostgreSQL 資料庫。

ℹ️

目前 Zeabur 提供的 PostgreSQL 服務支援最新版本。未來將支援更多版本的 PostgreSQL 服務,敬請期待。

部署 PostgreSQL 服務

在你的項目中,點選 建立服務,並選擇 服務市場,在列表中找到 PostgreSQL 服務。

Deploy PostgreSQL

選中 PostgreSQL 服務後,Zeabur 將自動開始為你部署 PostgreSQL 服務。

環境變數

當你部署 PostgreSQL 服務後,Zeabur 會自動幫你注入相關環境變數到其他的服務中。

  • POSTGRES_HOST
  • POSTGRES_PORT
  • POSTGRES_USERNAME
  • POSTGRES_PASSWORD

有時候我們可以用自行新增 DATABASE_URL 來取代上面的環境變數,例如:

postgres://<POSTGRES_USERNAME>:<POSTGRES_PASSWORD>@<POSTGRES_HOST>:<POSTGRES_PORT>/<DATABASE_NAME>

這裡的 <DATABASE_NAME> 是你自行新增的資料庫名稱。

新增資料庫

Zeabur 預設的資料庫和使用者都為 root

有些時候你可能需要新增資料庫,例如你的項目需要使用多個資料庫,或者你需要為不同的環境使用不同的資料庫,你可以透過以下兩種方式來新增資料庫:

PgAdmin

pgAdmin (opens in a new tab) 是 PostgreSQL 最流行、功能最豐富的開源管理和開發平台。你可以使用 pgAdmin (opens in a new tab) 來連接到你部署在 Zeabur 的 PostgreSQL 資料庫。

安裝 PgAdmin

你需要先安裝 pgAdmin 用戶端。前往 pgAdmin 的官方網站 (opens in a new tab)下載並按照說明進行安裝。

pgadmin

新增資料庫

首先,你需要點選 Add New Server 並填入相關資訊:

connect-pgsql

接著,你需要先點選 Databases,並點選 Create,並填入相關資訊:

create-db

PSQL (sql shell)

psql (opens in a new tab) 是一個基於終端的 PostgreSQL 工具。它使你能夠以互動方式輸入查詢,將它們傳送到 PostgreSQL,並查看查詢結果。此外,psql (opens in a new tab) 提供了許多各種類似 shell 的功能,以方便編寫腳本和自動執行各種任務。

安裝 PSQL

為了使用 PSQL,你需要先安裝 PostgreSQL 用戶端。前往 PostgreSQL 的官方網站 (opens in a new tab)下載並按照說明進行安裝。

在安裝完成後,你可能需要重啟你的電腦。你可以透過輸入以下指令來檢查安裝是否成功:

psql --version

新增資料庫

你可以使用 psql (opens in a new tab) 來連接到你部署在 Zeabur 的 PostgreSQL 資料庫,只要輸入以下指令:

psql -h <POSTGRES_HOST> -p <POSTGRES_PORT> -U <POSTGRES_USERNAME> -W
CREATE DATABASE <DATABASE_NAME>;

指令輸入要確保在 postgres=# 的狀態下,才能正確地執行。

psql-create-db