要用 AI 編寫資料庫結構文件，只匯出唯讀元資料，並核實每項生成結論。遵循如何使用 AI限定範圍；不得發送憑證或業務資料列。

關鍵要點

先凍結資料庫、環境、結構範圍與版本。

用唯讀、最小權限身份擷取定義與系統目錄元數據。

不向模型提交憑證、連線字串、查詢結果或業務資料列。

PK、FK 與約束才是關係證據，禁止依名稱猜測。

保留未知項與衝突，不讓 AI 自動補全。

技術負責人與業務負責人分別複核各自負責的事實。

文件隨遷移版本化並做差異比較。

用 AI 編寫資料庫結構文件前，交付物應如何定義？

「記錄資料庫」不是有界任務。先寫範圍卡，明確系統與讀者。

欄位	合成範例
資料庫角色	訂單服務 PostgreSQL 資料庫
環境	核准的生產結構定義
引擎/版本	PostgreSQL 18
包含結構	`orders`、`catalog`
排除結構	驗證與稽核儲存
版本證據	遷移版本 `2026_09_04_01`
讀者	應用工程師與值班人員
交付物	物件參考、關係表、開放問題
禁止操作	資料列查詢、DDL、寫入、未核准匯出

決定文件描述邏輯概念、實體實作，或兩者兼具。實體參考要保留精確識別碼、類型、預設、可空性與約束；業務含義必須有負責人證據並分開標示。混在一起，會讓生成說明顯得比來源更權威。

也要寫清楚它不是甚麼。API 行為屬於API 文件，服務邊界屬於架構圖，上線順序屬於遷移規劃。可以互相連結，但不能互相取代。

建立唯讀結構文件工作流程

使用專用身份，只能查看所需系統目錄與結構定義，不能擁有物件、寫資料、執行遷移或讀取無關應用表。OWASP 建議最小權限、分離資料庫帳戶，並避免應用使用管理員憑證。［4］文件工具也應遵守相同原則。

不要讓憑證出現在提示詞、命令列記錄、匯出檔、截圖或生成的正文中。優先使用組織核准的憑證代理或本機安全連線設定。若命令會把密碼或完整連線字串放入參數，應停止並改用核准的存取方式。

PostgreSQL pg_dump --schema-only 匯出物件定義而非資料，但結果仍可能暴露名稱、註解、負責人、函數、政策或內部結構。［3］因此它仍是敏感元數據，必須先在本機審查並最小化。「僅結構」不等於「公開」或「可交給任意模型」。

採集清單至少記錄引擎與伺服器版本、資料庫與包含的結構、移除秘密後的系統目錄查詢或匯出命令、擷取時間、遷移版本、操作者、核准儲存位置、排除物件類型，以及權限造成的缺口。若完整匯出過寬，就只查詢核准的資訊結構檢視與系統目錄；查詢由人在受控環境執行，不把資料庫憑證交給 AI 代理。

先盤點物件，再寫說明

建立確定性物件清單：結構、資料表、檢視、具體化檢視、序列與範圍內的其他類型。保留完整限定名稱。每個物件記錄類型、必要時的負責人角色、用途證據、依賴關係，以及目前、已棄用或未解決狀態。

模型解釋不了的物件也不能靜默省略。把用途標為 VERIFY，同時建立指定負責人的問題。對檢視，要區分檢視定義與猜測的業務摘要；對分割資料表，記錄上層資料表和分割策略；對生成物件或引擎特有物件，保留原定義並標示可攜性限制。

怎樣把欄位記錄為實體事實？

PostgreSQL 的 information_schema.columns 提供可存取欄位的名稱、序號位置、預設、可空性與資料類型等元數據。［1］只擷取讀者需要的欄位，不把系統目錄值包裝成業務含義。

屬性	證據與複核規則
限定物件與欄位	保留精確拼字與大小寫
序號位置	從系統目錄讀取，不讓 AI 猜顯示順序
資料類型	必要時保留引擎特有細節
可空性	記錄強制狀態，語義另行說明
預設/生成表達式	保留定義並複核副作用
識別/序列	記錄生成機制與所有權
排序規則	比較或排序依賴時記錄
註解	標示為儲存註解，不當作已核驗真相
業務說明	引用負責人或核准規範
未知項	保留 `VERIFY` 與具名問題

不要加入生產範例值來「解釋清楚」欄位。只有負責人確認後才使用合成值。若欄位表達式或函數複雜，可採用用 AI 解釋程式碼的方法：提供精確、有界定義，要求逐項解釋，再以可執行行為或負責人知識核驗。

只按證據編寫資料庫關係文件

關係必須來自主鍵、唯一約束、外鍵與相關排除約束，而非相似名稱。PostgreSQL table_constraints 會標示約束類型與是否可延遲。［2］還要結合鍵與參照元數據，才能寫出兩側物件與精確欄位順序。

每條關係記錄來源/目標限定物件、有序欄位、約束名稱和類型、更新與刪除動作、必要時的可延遲性、由可空性與應用契約共同決定的可選性，以及證據來源和擷取版本。

兩個資料表都有 customer_id 並不能證明存在關係。缺少外鍵也不能證明沒有應用層關係；後者只有在程式碼、核准規範或負責人提供證據時才能記錄，並明確標為未強制執行。複合鍵必須保留欄位順序；自我參照、中介資料表、多型關聯與跨資料庫連結都需要明確證據。

應記錄哪些約束、索引與行為邊界？

約束定義資料庫接受或拒絕的狀態，應單獨成節。記錄主鍵、唯一約束、外鍵、檢查約束、非空約束與排除規則；精確保留表達式，再補一段經複核的人類說明。

索引是實作物件，不自動等於業務規則。唯一索引可能強制規則，普通索引多數描述存取策略。必要時記錄表達式、欄位順序、排序方向、述詞與包含欄位，但不能只憑元數據承諾效能。

預設、觸發器、生成欄位、資料列級政策、函數與授權都可能改變可觀察行為。範圍內就依物件類型記錄，但不讓 AI 執行或改寫定義。若文件暴露疑似問題，應走正常資料庫變更流程；用 AI 編寫和檢查 SQL是另一套有防護的工作流程。

限定 AI 資料庫結構文件的生成任務

模型包只包含已審查元數據、穩定證據識別碼、輸出模板與明確禁令：

把給定結構元數據整理成物件參考。
精確保留限定識別碼、類型、表達式、約束名稱、
欄位順序與證據識別碼。禁止依名稱推斷關係。
禁止編造業務含義、負責人、敏感度、基數或範例。
無證據的結論寫成 [VERIFY]，並列出解決它所需的證據。
不得索取憑證、連線字串、資料庫存取或資料列。
返回正文、關係表與圖表原始檔；不得返回可執行 DDL。

輸出分為範圍、物件清單、欄位參考、約束、關係、檢視/計算行為、權限邊界、未知項與證據索引。每項結論都帶證據識別碼，審查者才能追溯。

圖表只是同一證據的派生檢視。要求輸出節點與有標籤的連線，再按AI 架構圖工作流程檢查範圍與可讀性。漏邊、外鍵反向或虛構基數，即使圖很漂亮也是缺陷。

如何對照真源複核草稿？

第一輪由資料庫負責人或工程師做結構核對：範圍內物件各出現一次；識別碼、類型、預設、表達式與序號位置一致；約束欄位及順序一致；外鍵方向與動作正確；範圍內檢視、觸發器、政策與授權都被表示；每條圖表連線都有證據；交付物中沒有可執行陳述式或資料列。

第二輪由物件負責人與領域負責人複核含義、生命週期、敏感度標籤與維運說明。AI 無法只憑元數據判斷欄位為何存在、哪個資料表權威或概念歸誰所有。衝突解釋要並列保留，直到責任負責人決定。

使用合成情境複核：可空外鍵、複合唯一約束、相容檢視下的重新命名欄位、延遲關係，以及沒有主鍵的資料表。審查者應能定位控制證據並說明未知項。

讓文件隨遷移版本化

文件與結構版本、擷取時間、查詢/工具版本和證據清單一起保存。每次遷移後，透過同一唯讀路徑重建元數據，先比較物件級事實，再讓 AI 摘要變更。

漂移類別	範例	需要的複核
新增	新資料表、欄位、約束、檢視	完整性與所有權
行為變更	預設、觸發器、政策、檢查約束變更	應用與維運影響
參照變更	鍵、動作、欄位順序變更	關係與完整性
存取變更	授權、負責人、政策變更	安全複核
移除/重新命名	移除或重新命名物件	使用方與遷移
僅文件變更	負責人核准的含義澄清	證據與版本

不要讓重新生成的正文隱藏破壞性變更。每項摘要連到遷移和前後元數據。若文件與已部署結構不一致，以已部署結構為結構事實，把差異當作問題追蹤，而不是讓 AI 選一個版本。

發布檢查表

常見問題

用 AI 編寫資料庫結構文件時，可以上載僅結構元數據嗎？

不可以。它不含業務資料列，卻可能暴露物件名稱、內部結構、註解、函數、策略、所有權與安全假設。必須依組織分類和核准工具規則審查並最小化。

用 AI 編寫資料庫結構文件時，應讓 AI 直接連線資料庫嗎？

不應。由人在唯讀、最小權限路徑擷取核准元數據。模型只接收有界材料，不能取得可重用憑證或探索權限。

用 AI 編寫資料庫結構文件時，能依同名欄位推斷外鍵嗎？

不能。同名只是假設，不是證據。使用已強制執行的鍵元數據或明確標示的程式碼、規範、負責人證據，並區分未強制執行的關係。

用 AI 編寫資料庫結構文件和起草資料字典一樣嗎？

不一樣。本流程聚焦已實作的結構物件、精確定義、約束、關係與版本漂移；資料字典更深入描述欄位含義、單位、受控詞彙、所有權、數據血緣與管治。

用 AI 編寫資料庫結構文件時，應包含 SQL DDL 嗎？

必要時可把系統目錄定義當作引用證據，但不要在本流程讓模型生成可執行 DDL。變更屬於獨立審查的遷移流程。

用 AI 編寫資料庫結構文件時，如何記錄檢視與觸發器？

記錄精確定義或穩定引用、依賴、執行上下文與已核驗用途。系統目錄事實與人工解釋分開，並標示資料庫引擎特有的行為。

用 AI 編寫資料庫結構文件時，系統目錄與負責人描述衝突怎麼辦？

並列保留，指出結構斷言與語義斷言，交給責任負責人處理。不要讓 AI 選擇看起來較合理的說法。

用 AI 編寫資料庫結構文件後，何時重新生成？

任何遷移或相關存取政策變更後都應重新生成。先比較確定性元數據，複核受影響章節，再發布新版本，不靜默覆蓋歷史。

來源

PostgreSQL: information_schema.columns — https://www.postgresql.org/docs/18/infoschema-columns.html
PostgreSQL: table constraints — https://www.postgresql.org/docs/18/infoschema-table-constraints.html
PostgreSQL: pg_dump — https://www.postgresql.org/docs/18/app-pgdump.html
OWASP Database Security Cheat Sheet — https://cheatsheetseries.owasp.org/cheatsheets/Database_Security_Cheat_Sheet.html

Sources checked 2026 年 9 月 4 日。

如何用 AI 編寫資料庫結構文件：唯讀元數據、約束與關係核實