您现在的位置：程式碼之家 >> 數據庫知識 > >> SQL Server 資料庫 >> 關於SqlServer

透過 COM 自動化擴展 SQL Server 功能：從 OLE 到 sp_OA* 實戰

編輯：關於SqlServer

T-SQL 在資料操作強大，但缺乏與外部系統（檔案、登錄、郵件、Office、Active Directory）互動的能力。SQL Server 內建 7 條 COM 自動化擴展預存程序，允許在預存程序中建立、操作、銷毀 COM 物件，打破資料庫邊界。

七大核心擴展預存程序

程序	用途
`sp_OACreate`	建立 COM 物件實例，回傳物件 token (整數)
`sp_OADestroy`	釋放物件 token，必須成對呼叫
`sp_OAGetProperty`	取得物件屬性值
`sp_OASetProperty`	設定物件屬性值
`sp_OAMethod`	呼叫物件方法，可傳參數、取回傳值
`sp_OAGetErrorInfo`	取得上一個 COM 呼叫的詳細錯誤資訊
`sp_OAStop`	停止目前連線的 OLE 自動化環境（罕用）

呼叫規則與錯誤處理

參數不可省略：不支援具名參數，若無值必須傳 NULL 佔位。
回傳值：所有程序回傳 HRESULT（int），0 成功，非零失敗。

錯誤處理範本：

DECLARE @hr INT, @obj INT, @src VARCHAR(255), @desc VARCHAR(255);
EXEC @hr = sp_OACreate 'Scripting.FileSystemObject', @obj OUT;
IF @hr <> 0 BEGIN
    EXEC sp_OAGetErrorInfo @obj, @src OUT, @desc OUT;
    RAISERROR('COM Error: %s - %s', 16, 1, @src, @desc);
    RETURN;
END

實戰範例：寫入文字檔

DECLARE @fs INT, @file INT, @hr INT, @txt VARCHAR(8000);
SET @txt = 'Hello from SQL Server ' + CONVERT(VARCHAR, GETDATE(), 120);

EXEC @hr = sp_OACreate 'Scripting.FileSystemObject', @fs OUT;
IF @hr = 0 EXEC @hr = sp_OAMethod @fs, 'CreateTextFile', @file OUT, 'C:\Temp\SQLLog.txt', TRUE, TRUE; -- overwrite, unicode
IF @hr = 0 EXEC @hr = sp_OAMethod @file, 'WriteLine', NULL, @txt;
IF @hr = 0 EXEC @hr = sp_OAMethod @file, 'Close', NULL;
IF @hr <> 0 EXEC sp_OAGetErrorInfo @fs, @src OUT, @desc OUT; -- 取錯誤細節

EXEC sp_OADestroy @file;
EXEC sp_OADestroy @fs;

應用場景與限制

發送郵件（CDO.Message）、產生 Excel/Word 報表、呼叫 Web Service（MSXML2.XMLHTTP）、檔案系統操作、登錄讀寫。
效能警示：COM 呼叫屬進程外（或進程內）切換開銷大，嚴禁在高頻觸發器/大量資料迴圈中使用。
安全性：需 sysadmin 權限執行，物件以 SQL Server 服務帳號身分執行，權限過高風險。
現代替代：SQL CLR (SQL 2005+)、sp_execute_external_script (R/Python)、Service Broker 非同步處理、外部應用層處理。

歷史註記：SQL 6.5 稱 OLE Automation，SQL 7.0/2000 文件仍用「OLE」稱呼，實為 COM。線上叢書搜尋「OLE Automation」可找到完整參考。