前言 - 什麼是資料庫？

簡單來說，資料庫（Database） 是一種用來 儲存、管理與存取資料 的系統。

它能幫助我們把資料有條理地組織起來，並透過查詢語言（例如 SQL）快速檢索與更新。

常見的資料庫類型有：

• 關聯式資料庫（RDBMS）：以表格（Tables）方式存放資料，支援 SQL，例如 MySQL、PostgreSQL、SQLite。
• 非關聯式資料庫（NoSQL）：不一定使用表格，常見於 JSON 文件、Key-Value、Graph 等結構，例如 MongoDB、Redis。

常見資料庫比較

👉 簡單來說：

• MySQL：適合中小型專案或網站開發。
• PostgreSQL：功能更全面，適合大型專案、金融系統、數據分析。

以上為兩種資料庫的主要定位，但實際選擇時還是要根據具體團隊需求和情境來決定。

Render 資料庫服務簡介

Render 除了能部署前後端應用程式，也提供 PostgreSQL 資料庫服務，其優點包括：

• 免費方案可用（適合開發 / 測試）。
• 內建 自動備份 功能。
• 提供 Connection Info，可直接複製連線字串使用。
• 支援外部連線（可用 DBeaver、pgAdmin、psql 連線）。
• 內建 SSL 安全機制，保障連線安全。

✅ 建立 PostgreSQL 資料庫

1. 點擊右上角的 「New」 按鈕。
2. 選擇「Postgres」。

1. 設定資料庫細節（如下）：

   • Name：資料庫 Instance 名稱。

   • Region：選擇靠近你的地區（例如 Singapore 新加坡）。

   • Database Name / User / Password：Render 會自動產生，也可以自訂。

   • Plan Option：先選擇 Free 方案即可，方便測試使用。

     

2. 點擊「Create Database」。

3. 等待 DB Instance 生成後，即可在 Dashboard 中看到。

4. 點擊對應的 Service Name 以查看資料庫詳細資訊。

✅ 資料庫存取方式

Render 會自動產生一組 外部連線網址（External Connection URL），可供應用程式或團隊使用：

• 進入 Postgres 資料庫頁面。
• 在「Connection Info」找到 External Database URL。
• 複製這組 URL，並用於 psql、DBeaver、應用程式或 ORM。

ℹ️ 注意：這組 URL 含有帳號密碼，務必保護好，不要放在 GitHub 等公開地方。

External Database URL

postgresql://node_ts_demo_db_user:<password>@dpg-d33uq4q4d50c73ejo3rg-a.singapore-postgres.render.com/node_ts_demo_db

格式通常為：

postgres://<user>:<password>@<host>/<dbname>

拆解（設定 DBeaver 可用）：

• 使用者：node_ts_demo_db_user
• 密碼：password
• 主機：dpg-d33uq4q4d50c73ejo3rg-a.singapore-postgres.render.com
• 資料庫名稱：node_ts_demo_db

用 DBeaver 測試連線

DBeaver 是一款跨平台的開源資料庫管理工具，支援 MySQL、PostgreSQL、SQLite、MongoDB 等多種資料庫。

安裝與連線步驟

1. 下載並安裝 DBeaver。

2. 點選「New Database Connection」。

3. 選擇「PostgreSQL」。

4. 輸入 Render 提供的資訊：

   • Host：dpg-xxxxx.singapore-postgres.render.com

   • Database：ts_template_db

   • Username：ts_template_db_user

   • Password：password

   • Port：5432

     

5. 點擊 Test Connection，成功會顯示「Connected」。

   

Node.js 專案連線 Render 資料庫與 API 測試

修改 .env 檔案，加入資料庫連線資訊

DB_HOST=dpg-d33uq4q4d50c73ejo3rg-a.singapore-postgres.render.com
DB_NAME=node_ts_demo_db
DB_USERNAME=node_ts_demo_db_user
DB_PASSWORD=password
DB_PORT=5432

啟動伺服器並測試連線

使用先前 Day 6 設定好的 script：

npm run dev

會發現連線失敗，因為 SSL 相關問題。

解決 SSL 問題

• 開發環境：可暫時關閉驗證以便快速測試。
• 正式環境（Production）：建議保持預設驗證（true），以確保安全性。

若遇到 SSL 連線錯誤，在 db.ts 的 AppDataSource 配置中加入：

ssl: { rejectUnauthorized: false },

更新後的 src/config/db.ts：

export const AppDataSource = new DataSource({
  type: "postgres",
  host: process.env.DB_HOST,
  port: Number(process.env.DB_PORT),
  username: process.env.DB_USERNAME,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  entities: [Todo],
  synchronize: true,
  logging: true,
  ssl: { rejectUnauthorized: false },
});

✅ 成功連線的終端機畫面：

(可觀察到 typeORM 已經跟資料庫互動並藉由 Todo Entity 創立 Todo 表格)

DBeaver 畫面：

API 測試範例

使用 Postman 測試幾個簡單的 API：

Postman 測試結果

成功新增 API 資料：

🎯 今日收穫

今天我們不只學會了如何在 Render 上建立 PostgreSQL 資料庫，還實際完成了幾件關鍵任務：

• 了解了 資料庫的基本概念，並比較了 MySQL 與 PostgreSQL 的差異。
• 在 Render 建立了 Postgres 資料庫服務，並熟悉了連線方式。
• 使用 DBeaver 成功測試連線，確認資料庫可以正常使用。
• 在 Node.js + TypeORM 專案中完成連線，並處理 SSL 問題。
• 用 Postman 驗證了 API 與資料庫的互動，確認 CRUD 功能正常。

👉 到這一步，我們的專案已經有了「完整的後端 + 真實的雲端資料庫」，下一步就能進一步嘗試部署專案了！ 🚀

補充資料

Github 範例程式碼

git commit : setup render database connection info