Ardent

Ardent 是什麼

Ardent 是為 AI 代理與其背後團隊打造的資料庫分支基礎設施。它接上既有的 Postgres 資料庫，用邏輯複寫維持一份唯讀複本，再從這份複本切出隔離分支。每個分支都是一套完整的 Postgres 實例，帶著你的結構描述、資料、權限、資料列層級安全政策、函式與觸發程序。

用過自動化程式碼代理跑資料庫的人，都遇過同一個問題。共用的測試環境逐漸偏離正式環境，種子資料蓋不到邊界情況，一筆寫壞的遷移就能把主庫拖垮。Ardent 給每項任務一組自己的連線網址。代理可以讀、可以寫、可以跑遷移，也可以把事情弄壞，結束後分支直接刪掉。說到底，這是每項任務一個資料庫沙箱：真的結構描述，真的資料列，沒有共用的測試環境。

有幾個限制最好先知道。它只支援 Postgres，分支是建立當下的快照，資料庫很大時第一次設定連接器要等上一段時間。

開始使用

1. 用 npm install -g ardent-cli 安裝命令列工具，再執行 ardent login。
2. 把連線字串存進 ARDENT_DB_URL，執行 ardent connector preflight postgresql "$ARDENT_DB_URL"。如果 preflight 印出授權腳本，先在來源資料庫上跑過一次。
3. 執行 ardent connector create postgresql "$ARDENT_DB_URL" 建立連接器。設定在 Ardent 端執行，資料庫大時可能要好幾分鐘甚至數小時。
4. 執行 ardent branch create my-feature，再用 ardent branch info 取得分支的連線網址。
5. 把應用程式或代理指向這組網址。工作結束後用 ardent branch delete 刪掉分支。