用 Claude Code 安全執行數據庫遷移(Prisma / Alembic):防誤刪表規則與回滾提示詞

讓 AI 改表結構遇到遷移衝突時,最怕它順手敲一條 prisma migrate reset 把本地測試庫清空。本文詳解在 settings.json 鎖死刪庫命令、用 --create-only 先審 SQL 及零停機分步遷移的三套提示詞。

NNathaniel bigo··原創首發·AI 輔助撰寫
8 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Pro 帳號

結論先說

  1. 先把 reset 和 --force-reset 關進 .claude/settings.json 的黑名單牢籠:只寫在 CLAUDE.md 裏不夠保險,必須在權限層用 Bash(...) 拒絕規則把清庫命令徹底堵死。
  2. 鐵律是「先加 --create-only 只生成文件不落庫,人工看過 SQL 再執行」:ORM 自動對比出來的 SQL 經常把「字段改名」錯寫成「刪掉舊列再建新列」,不先看一眼 SQL 直接跑必丟數據。
  3. 禁止觸碰歷史已合入的遷移文件:任何修正都必須生成帶新時間戳的增量遷移,並要求同步寫出配套的反向回滾(Down)腳本。
  4. 複雜 Schema 演進建議配合穩健的主力推理模型:需要開通或續訂訂閱可查看本站 Claude Code 訂閱導航頁 或自動發卡的 Claude Pro iOS 自助充值商品頁。

用 Claude Code 安全跑數據庫遷移四步

圖:本站結合 Claude Code 官方權限文檔 整理的四步安全遷移示意圖

本文根據 Anthropic Claude Code 官方權限與設定文檔(code.claude.com/docs/en/permissions)整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是軟件截圖。本站(bigolab.com)不是 Anthropic 官方網站。

適用於誰

  • 用 Prisma(Node.js) 或 SQLAlchemy + Alembic(Python) 管數據庫,曾被 AI 一句「檢測到遷移漂移,我幫你跑一下 reset 重置」嚇出冷汗的開發者;
  • 給存量幾十萬行的線上業務表加非空字段或改列名,怕生成出鎖表、丟數據的危險 SQL 的後端工程師;
  • 想在項目裏立一套代碼級硬規矩,禁止智能體篡改已經上線合入 main 分支的舊遷移腳本的人。

一、第一步必配:settings.json 刪庫命令硬封禁清單

打開項目根目錄下的 .claude/settings.json(完整安全配置體系見 Claude Code deny 拒絕規則與密鑰保護),把 Prisma、Drizzle、Alembic 與裸 SQL 的毀滅性命令全部寫進 deny 列表:

json
{
  "permissions": {
    "deny": [
      "Bash(npx prisma migrate reset*)",
      "Bash(pnpm prisma migrate reset*)",
      "Bash(*prisma db push --force-reset*)",
      "Bash(*prisma db push --accept-data-loss*)",
      "Bash(alembic downgrade base*)",
      "Bash(*DROP DATABASE*)"
    ]
  }
}

配好後就算你在開啟了自動編輯模式或沙箱放行的狀態下(模式區別見 Claude Code 權限模式詳解),一旦模型試圖敲 migrate reset 走捷徑解決本地漂移,客戶端會毫秒級硬攔截並要求它換無損方案。如果誤改了本地未提交文件,隨時可用檢查點回退,見 Claude Code Rewind 檢查點撤回指南。

Claude Code 免上號訂閱與高配額省心方案:在大倉庫跑百萬上下文、多子包重構或複雜慢查詢排障時,固定月費訂閱比純按量 API 更容易鎖死成本上限。本站支持支付寶、微信支付與 AlipayHK 卡密自助兌換 iOS 鏈路的 Claude Pro 自助充值、5 倍額度的 Claude Max 5x 與頂配 Claude Max 20x,無需交出帳號密碼。

二、三段可直接複製的安全遷移提示詞模板

數據庫 Schema 變更風險攔截清單

圖:本站根據生產數據庫零停機變更規範整理的四類風險攔截示意圖

1. Prisma 只生成不執行 + 字段改名無損改寫

text
我需要將 Order 表的 legacyStatus 字段重命名為 fulfillmentStatus 並補充索引。
請按以下安全順序操作:
1. 修改 prisma/schema.prisma 後,僅運行 npx prisma migrate dev --create-only --name rename_order_status 生成 SQL 草稿,嚴禁直接應用到數據庫;
2. 打開剛生成的 migration.sql 檢查:如果 Prisma 預設寫成了 DROP COLUMN 再 ADD COLUMN,請手動將其改寫為保留存量數據的 ALTER TABLE ... RENAME COLUMN 語句,並把改好的 SQL 貼給我審閱。

2. 百萬行大表零停機「分步擴縮(Expand & Contract)」方案

text
生產環境 users 表已有兩百萬行記錄且全天高頻寫入,現在需要新增必填字段 tenant_id 並建聯合索引。
請不要生成一條直接帶 NOT NULL 鎖全表的危險遷移,幫我拆成三階段無損遷移計劃與對應 SQL:
- 階段一:僅新增可空(NULLABLE)列並使用不阻塞讀寫的並發建索引語法(如 PostgreSQL CONCURRENTLY);
- 階段二:編寫按主鍵分批(每批 2000 行)冪等回填歷史存量數據的腳本;
- 階段三:校驗零空值後收緊非空約束的收尾遷移。

3. Alembic 雙向遷移核驗與回滾演練(Python)

text
請基於最新的 SQLAlchemy 模型運行 alembic revision --autogenerate -m "add_audit_log_table",隨後逐行檢查生成的腳本:
1. 核對 upgrade() 中是否誤混入了與本次需求無關的索引增刪;
2. 確保 downgrade() 回滾函數邏輯完整對稱、非空殼 pass;
3. 在本地測試庫依次跑通 upgrade head → downgrade -1 → upgrade head 閉環驗證。

人工必查清單:點同意執行前,肉眼掃一遍 .sql 文件裏的關鍵字——凡是見到 DROP、TRUNCATE、在大表事務內跑 CREATE INDEX(未加並發標記且禁用事務包裹)或未設預設值的 NOT NULL,一律先喊停核實(只讀查庫核對現有表數據量可配合 接入數據庫 MCP 查數據指南)。

常見問題

問:智能體不小心把上週已經上線的主幹舊 migration.sql 改了一行,怎麼救?

答:千萬不要把被改過的舊遷移文件合入主分支,否則正式服遷移校驗和(Checksum)會直接報錯拒絕部署。立即用 git checkout -- prisma/migrations/<舊目錄> 把歷史文件還原,讓智能體另建一個新的遷移文件追加修改(分支衝突處理見 Claude Code 處理 Git 提交與衝突)。

問:本地開發庫真的亂了需要重拉基線,但被 deny 攔住了怎麼辦?

答:需要重置本地空庫時,由開發者本人在自己獨立的系統終端標籤頁親手敲命令,養成「刪庫重置絕不假手 AI 進程代敲」的安全習慣。

問:PostgreSQL 加 CREATE INDEX CONCURRENTLY 放在 Prisma 遷移裏報錯說不能跑在事務塊裏怎麼辦?

答:提醒智能體將該條並發建索引語句單獨拆出,按目標數據庫與遷移工具對非事務性 DDL 的官方約定單獨執行,避免與普通 ALTER TABLE 混在同一個隱式事務中。

問:為什麼給存量表刪一個廢棄字段也要分兩次發版,不能改代碼和刪列一起上線?

答:在滾動發佈(Rolling Update)或藍綠切換期間,新舊兩個版本的應用容器會短暫並存幾分鐘。如果你一上來就在數據庫把舊列 DROP 掉了,尚未下線的舊版容器一旦執行 SELECT * 或寫入該列就會立刻全線報錯。正確做法是第一版先只改代碼徹底停止讀寫該字段,等舊實例全部下線穩定一天後,第二版再提交刪列遷移。

問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱最穩妥?

答:可在 Claude Code 訂閱說明頁 或 Claude Max 充值頁 選擇走蘋果 iOS 官方內購鏈路的自助卡密,自己複製登入憑證提交即可到賬,全程無需把密碼交給他人;若帳號偶發彈出身份核驗,也可查看 Claude KYC 人工協助(失敗不收費,封號不在質保範圍)。

相關教學

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同模型

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    寫代碼兼顧辦公,同時訂「ChatGPT Plus + Claude Pro 雙會員」還是單上「Max / Pro 高階檔」怎麼算帳

    每月花 $40 同時訂 ChatGPT Plus + Claude Pro 雙會員,還是花 $100 單上 Claude Max 或 ChatGPT Pro 100?本文按兩家官方定價頁拆解編程智能體、多模態辦公、限額容災與獨佔功能帳本,給出清晰選型公式。

    ChatGPTClaude0
  3. 03

    Notion AI 怎麼收費、包含在套餐裏還是單獨買:工作區知識問答、數據庫自動填表與對比 Claude / ChatGPT 選型

    Notion AI 現在還能單獨加購嗎?按 Notion 官方現行定價頁,完整 Notion AI 已直接打包進 Business(年付 $20/成員/月,月付 $24)與 Enterprise 套餐,Free 和 Plus 僅含少量試用。本文講清計費變化、三大核心功能及與獨立會員的取捨。

    其他 AI 工具0
  4. 04

    Raycast AI(Pro / Pro+ / Max)是什麼、怎麼配 BYOK 自帶密鑰:快捷呼出 Claude 與 GPT 桌面工作流

    Raycast AI 支持在桌面端全局快捷鍵呼出 Claude、GPT 與 Gemini。本文按官方手冊說明 Raycast Pro、Pro+、Max 積分檔位差別,以及配置 BYOK(自帶 API 密鑰)的前置條件、設定步驟與快捷指令工作流。

    其他 AI 工具0
  5. 05

    Perplexity Pro 值得買嗎:每月 $20 比免費版多什麼、可選哪些 Claude / GPT 模型與深度檢索用法

    Perplexity Pro 月付 $20(年付約 $17/月),比免費版多出高配額 Pro 搜尋、切換 Claude 與 GPT 模型及更高頻的 Deep Research 深度檢索。本文對比各檔權益,幫你判斷訂它還是獨立對話會員。

    其他 AI 工具0
  6. 06

    Claude API Citations 原文引用結合 Files API 搭建可溯源企業制度問答指南

    搭公司內部報銷、法務或操作規程問答機器人,不想折騰複雜的切片向量數據庫又怕大模型胡編頁碼?本文按 Anthropic 官方文檔詳解用 Files API 傳一次 PDF 拿 file_id,結合 Citations 原生返回精確頁碼與原文摘錄的完整架構。

    Claude0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  6. 06

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~