oracode

oracode 可將 Oracle 資料庫物件匯出成乾淨、穩定且適合 Git 版本控管的 DDL 檔案。

功能特色

• 每個 Oracle 物件輸出成一個 .sql 檔案。
• 使用穩定的輸出目錄，例如 TABLE/、VIEW/、PACKAGE_SPEC/ 與 PACKAGE_BODY/。
• 預設匯出核心物件類型，並可用 --include / --exclude opt-in 擴充 INDEX、CONSTRAINT、REF_CONSTRAINT、COMMENT、OBJECT_GRANT、SYNONYM、MATERIALIZED_VIEW 與 DB_LINK。
• 以 best-effort 設定 DBMS_METADATA 轉換參數：SEGMENT_ATTRIBUTES = FALSE、SQLTERMINATOR = TRUE、PRETTY = TRUE 與 EMIT_SCHEMA = FALSE。
• 額外清理 DDL 中的 EDITIONABLE、多餘空白行、簡單識別字引號，以及 SQL 關鍵字大小寫；需要較接近原始 DDL 時可用 --lossless。
• 支援併發匯出，並在終端機顯示進度列。
• 內容未變更時會略過檔案重寫。

安裝

從原始碼安裝：

cargo install --path .

發布版本完成後，npm 使用者可以安裝輕量包裝套件：

npm i -g @willh/oracode

Oracle 用戶端需求

Rust oracle 驅動程式使用 ODPI-C，執行時需要 Oracle Client 函式庫。 請安裝 Oracle Instant Client，並讓系統能找到該函式庫目錄：

• macOS：設定 DYLD_LIBRARY_PATH，或確認 Instant Client 目錄位於載入器搜尋路徑中。
• Linux：設定 LD_LIBRARY_PATH=/path/to/instantclient。
• Windows：將 Instant Client 目錄加入 PATH。

使用方式

oracode \
  --host db.example.com \
  --port 1521 \
  --user HR \
  --password "$ORACLE_PASSWORD" \
  --service-name ORCLPDB1 \
  --schema HR \
  --output ./oracode-out

若使用 SID 連線，請改用 --sid XE 取代 --service-name。 如果需要保留加上雙引號的識別字，請使用 --keep-quotes。 如果需要保留雙引號、EDITIONABLE / NONEDITIONABLE、schema 前綴與 segment/storage 等 physical clauses，請使用 --lossless。

可用 --include 額外匯出 opt-in 物件類型，或用 --exclude 從預設集合中移除物件類型：

oracode ... --include indexes,constraints,comments,grants,synonyms,mviews --exclude triggers

--include constraints 會匯出 dependent CONSTRAINT 與 REF_CONSTRAINT DDL；--include comments 會匯出 table/column comments。

--include grants 會匯出「所選 Schema 擁有、且已在本次物件集合中」的物件授權（outbound object grants），輸出至 OBJECT_GRANT/。它不匯出授予此 Schema 的 inbound object grants、system grants 或 role grants。

--include db-links 會嘗試匯出 database links。這類 DDL 可能涉及敏感連線資訊或由 Oracle 遮蔽密碼，建議只在明確需要時啟用。

所有 CLI 選項也可以透過 ORACODE_* 環境變數提供，例如 ORACODE_PASSWORD。

技術文件

• 技術架構與實作說明
• Oracle 版本測試矩陣與 fixtures
• 產品需求與開發藍圖
• 發布流程