SQL CLR 資料表值函數實戰：擴展 Reporting Services 報表資料源的新路徑

前言

SQL Server 2005 整合 .NET Framework CLR，讓開發者能在 T-SQL 中直接呼叫 .NET 類別與函數。CLR 整合機制包含：CLR 使用者定義函數（含資料表值函數）、CLR 使用者定義型別、CLR 預存程序、CLR 觸發器。本文聚焦 CLR 資料表值函數（TVF），示範如何從多元資料源建構報表資料，打造可靠的 Reporting Services 報表。

擴展 Reporting Services 的多元路徑

• 傳遞擴充：依事件傳遞報表
• 轉譯擴充：支援內建以外的輸出格式
• 安全性擴充：自訂驗證與授權機制
• 資料處理擴充：處理 Reporting Services 不支援的資料源
• 自訂報表項目：可嵌入報表的伺服器控制項

本文提出 TVF 作為「資料處理擴充」的替代方案：以程式化方式於執行期建立資料表，供 T-SQL 查詢直接使用，開發門檻較低且整合度高。

資料表值函數回顧

TVF 透過程式碼於執行期建立資料表，產出的資料表可像一般資料表用於 T-SQL 查詢。SQL Server 2000 僅支援 T-SQL 撰寫 TVF，範例如下：

CLR TVF 實作步驟

1. 建立 Class Library 專案，引用 Microsoft.SqlServer.Server、System.Data.SqlClient、System.Data.SqlTypes
2. 撰寫回傳 IEnumerable 或 SqlDataReader 的靜態方法，標記 [SqlFunction(FillRowMethodName = "FillRow", TableDefinition = "...")]
3. 編譯組件，於 SQL Server 註冊：CREATE ASSEMBLY ... FROM '...dll' WITH PERMISSION_SET = SAFE
4. 建立 TVF 包裝：CREATE FUNCTION ... EXTERNAL NAME Assembly.[Namespace.Class]::Method
5. 於 Reporting Services 資料集中直接呼叫 TVF

CLR TVF 優勢

• 可存取檔案系統、Web Service、登錄等 T-SQL 無法觸及的資源
• 複雜邏輯以 C#/VB.NET 實作，維護性優於 T-SQL
• 效能優於資料處理擴充開發模型
• 無需部署自訂擴充組件至 Reporting Services 伺服器

注意事項

• 權限集合設定（SAFE / EXTERNAL_ACCESS / UNSAFE）需謹慎評估
• 大量資料回傳時記憶體壓力，建議使用 SqlDataReader 流式回傳
• 除錯需附加至 SQL Server 進程（Visual Studio 支援）

結語

CLR TVF 為 Reporting Services 資料擴充提供輕量、強大且易維護的路徑。善用 .NET 生態系豐富的函式庫，能快速整合異構資料源，打破 T-SQL 的資料存取邊界。