RAG – 建立本地 PostgreSQL 資料庫

本篇會教你如何在本地 (本機) ，從 PostgreSQL Server 開始，到視覺化管理介面軟體 DataGrip的操作。

安裝 PostgreSQL Server

到 PostgreSQL 官方 Windows Installer：PostgreSQL Windows Installer

安裝時：

• PostgreSQL：安裝
• pgAdmin：可裝可不裝，因為之後主要用 DataGrip
• Stack Builder：可以不用
• Port：5432
• Username：postgres
• Password：自己設定

檢查 PostgreSQL 是否安裝成功

打開你的終端機（Mac 的 Terminal 或 Windows 的 Command Prompt / PowerShell），輸入以下指令來確認：

• 檢查背景服務是否運行：
  • Mac：輸入 brew services list（如果是用 Homebrew 安裝的），確認 PostgreSQL 狀態是 started。
  • Windows：按 Win + R 輸入 services.msc，在清單中找到 postgresql-x64-XX，確認狀態是否為「正在執行」。
• 檢查指令工具：輸入 psql --version。如果畫面回傳版本號（例如 psql (PostgreSQL) 15.x），代表 PostgreSQL 主程式已經安裝且系統認得它。如果顯示「找不到指令」，也不用慌，通常只是環境變數沒設定好。

安裝 DataGrip

前往官網安裝：https://www.jetbrains.com/datagrip

在 DataGrip 進行連線測試

打開 DataGrip，按照以下預設值測試是否能順利通車：

• 點擊左上角的 + 號 > Data Source > PostgreSQL。
• 輸入基本的連線參數：
  • Host: localhost
  • Port: 5432
  • User: postgres（預設管理員帳號）
  • Password: 輸入你在安裝過程中自己設定的那組密碼。
• 點擊畫面下方的 Test Connection。第一次使用可能需要點一下旁邊的「Download Driver」來下載驅動程式。

如果測試連線出現綠色打勾（Succeeded），代表你的環境一切正常，可以直接開始建立資料庫了！

安裝 Docker Desktop

要讓你的 PostgreSQL 支援 RAG，核心關鍵就是啟用 pgvector 擴充功能。

因為在 Windows 上原生安裝 pgvector 需要透過 Visual Studio 編譯原始碼，對新手來說比較繁瑣。最推薦且省事的方式是改用 Docker 來跑帶有 pgvector 的 PostgreSQL。

簡單來說因為我們會需要向量資料庫，而原生 PostgreSQL 並不包含，所以需要另外安裝。

前往官網安裝：https://docs.docker.com/desktop/setup/install/windows-install

下載映像檔

在命另提示字元中輸入：

docker run --name pg-vector -e POSTGRES_PASSWORD=輸入你在安裝過程中自己設定的那組密碼 -p 5432:5432 -d ankane/pgvector

如果看到輸出一串長字串，就代表 pg-vector 容器已經成功在背景跑起來了！

建立連線

打開 DataGrip，建立一個新的 PostgreSQL 資料源，填入以下資訊：

• Host: localhost
• Port: 5432
• User: postgres
• Password: 輸入你在安裝過程中自己設定的那組密碼

點擊 Test Connection。如果畫面亮起綠燈，顯示連線成功。

建立向量資料庫

在 DataGrip 的 Query Console 執行以下指令：

CREATE EXTENSION IF NOT EXISTS vector;

如果看到輸出：

[2026-09-12 12:14:39] Connected
[2026-09-12 12:14:39] postgres> CREATE EXTENSION IF NOT EXISTS vector
[2026-09-12 12:14:39] completed in 49 msCode language: CSS (css)

代表你的本機 PostgreSQL + pgvector 開發環境已經完整建置完畢，隨時可以開始進行 RAG 相關的向量資料庫開發了！

連線

用標準的 PostgreSQL 連線網址 (依你本地設定調整帳號、密碼、Port與資料庫名稱)

DATABASE_URL=postgresql://postgres:你的本地密碼@localhost:5432/你的資料庫名稱Code language: JavaScript (javascript)