善用腳本檔案管理 Oracle 資料庫：建立、編輯、執行全流程

為何需要腳本管理

• 減少重複輸入、避免手誤。
• 保存經驗證命令，隨時複用。
• 支援參數化，適應不同環境。
• SQL*Plus 內建編輯器功能極弱（無游標鍵、刪除鍵、語法高亮）。

第一步：建立腳本檔案

1. 外部編輯器撰寫：Notepad++、VS Code、Vim 等 → 複製到 SQL*Plus 測試 → 通過後存檔。
2. 副檔名慣例：.sql（SQL*Plus 預設辨識）。
3. 格式規範：
   • 最後一行**必須**以 / 結束（執行緩衝區指令）。
   • 最後一條 SQL **勿加** ;，否則雙重執行報錯。
   • 替換變數直接用 &1 &2... 無需宣告（執行時 @script.sql param1 param2）。
4. 測試後再歸檔：未測試腳本不可入庫。

第二步：編輯腳本檔案

• 小幅調整：SQL*Plus EDIT 呼叫外部編輯器（需設定 _EDITOR）。
• 大幅重構：直接用外部編輯器開啟修改。
• 注意保留結尾 /、勿誤刪關鍵字、維持縮排可讀性。

第三步：執行腳本檔案

方式一：SQL*Plus 內部

START 絕對路徑/腳本名.sql [參數...]
@絕對路徑/腳本名.sql [參數...]   -- 功能相同，@ 可用於 OS 命令列

⚠️ **指定絕對路徑**避免尋找順序不確定性。

方式二：SQL*Plus 選單

File → Open → 選檔 → File → Run。優點：自動提示輸入替換變數。

方式三：外部編輯器複製貼上（作者慣用）

編輯器開啟 → 確認無誤 → 全選複製 → SQL*Plus 貼上執行。無需管路徑、參數位置直觀可控。

進階技巧

• 模組化：通用邏輯拆分為 common.sql，主腳本 @@common.sql 遞迴呼叫。
• 錯誤處理：WHENEVER SQLERROR EXIT SQL.SQLCODE 讓腳本失敗即停止並回傳碼。
• 日誌記錄：SPOOL log.txt ... SPOOL OFF 保存輸出。
• 版本控管：腳本納入 Git，追蹤變更歷史。

總結

腳本是 DBA 效率倍增器：**外部編輯器寫、SQL*Plus 測、歸檔複用、參數化適配、版本控管**。養成「一切皆腳本」習慣，告別重複勞動與手誤風險。