Oracle 別名衝突陷阱：OGC_X / OGC_Y 系統保留字導致 PLS-306 錯誤排查全記錄

現場還原

編寫複雜多層子查詢 SQL，使用表別名 `X`、`Y` 時拋出錯誤：

ORA-06553: PLS-306: wrong number or types of arguments in call to 'OGC_Y'
ORA-06553: PLS-306: wrong number or types of arguments in call to 'OGC_X'

改用其他字母 (如 `Z`, `T`) 即正常，初步判定 `X`、`Y` 遭系統佔用。

根因追蹤

1. 查詢物件：
   SELECT OWNER, OBJECT_NAME, OBJECT_TYPE FROM DBA_OBJECTS WHERE OBJECT_NAME IN ('OGC_X','OGC_Y');
   結果：`MDSYS.OGC_X FUNCTION`, `MDSYS.OGC_Y FUNCTION`。
2. 查詢同義詞：
   SELECT OWNER, SYNONYM_NAME, TABLE_OWNER, TABLE_NAME FROM DBA_SYNONYMS WHERE TABLE_NAME IN ('OGC_X','OGC_Y');
   結果：`PUBLIC.X -> MDSYS.OGC_X`, `PUBLIC.Y -> MDSYS.OGC_Y`。

官方文檔解釋

Oracle Spatial 符合 OGC Simple Features Specification 1.1.1。
為符合 SQL92 with Geometry Types，建立了所有 OGC 函數同義詞，**唯獨 `X(Point)` 和 `Y(Point)` 兩個函數因語法衝突，必須使用 `OGC_X`、`OGC_Y` 完整名稱呼叫**，並建立了 `PUBLIC.X`、`PUBLIC.Y` 指向它們的公共同義詞。

解決方案

• 方案一 (推薦)：避開 `X`、`Y` 作為表別名，改用語義化縮寫 (如 `EMP`, `DEPT`, `T1`, `T2`)。
• 方案二：會話級移除同義詞 (需權限)：
  `DROP PUBLIC SYNONYM X; DROP PUBLIC SYNONYM Y;`
  風險：可能影響 Spatial 功能及其他依賴代碼。

完整字母測試結果 (補充)

逐一測試 A-Z 單字母別名，**僅 `X` 和 `Y` 會觸發 OGC_X/Y 衝突**，其餘 24 個字母均安全。

最佳實踐建議

1. **堅決禁止使用單字母別名**，特別是 `X、Y、Z` (Z 雖安全但無語義)。
2. 採用 **有意義縮寫**：`E`→`EMP`, `D`→`DEPT`, `C`→`CUST`, `O`→`ORD` 等。
3. 複雜查詢使用 `T1, T2...` 或 `SRC, TGT, LKP` 等語義前綴。
4. 代碼審查清單加入「別名是否為保留字/系統同義詞」檢查項。