自訂檔案 SQL 區段

sql 區段可以包含取代用戶端命令字串的新 SQL 字串。 如果區段中沒有 SQL 字串，則會忽略該區段。

重要

從 Windows 8 和 Windows Server 2012 開始，Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性逐步指南 (英文) 以取得詳細資料)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務。

新的 SQL 字串可以「參數化」。 也就是說，sql 區段 SQL 字串中的參數 (由 '?' 字元所指定) 可以取代為用戶端命令字串中 identifier 中的對應引數 (以用括弧括住的逗號分隔清單所指定)。 識別碼和引數清單的行為和函式呼叫類似。

例如，假設用戶端命令字串為 "CustomerByID(4)"、SQL 區段標頭為 [SQL CustomerByID]，而新的 SQL 區段字串為 "SELECT * FROM Customers WHERE CustomerID = ?". 處理常式將匯產生 "SELECT * FROM Customers WHERE CustomerID = 4"，並使用該字串來查詢資料來源。

如果新的 SQL 陳述式是 null 字串 ("")，則會忽略該區段。

如果新的 SQL 陳述式字串無效，則該陳述式的執行將會失敗。 用戶端參數實際上會被忽略。 您可以藉由指定下列命令，刻意執行此動作來「關閉」所有用戶端 SQL 命令：

[SQL default]   
SQL = " "  

Syntax

取代 SQL 字串項目的格式如下：

SQL=
sqlString

部分	描述
SQL	常值字串，表示這是 SQL 區段專案。
sqlString	取代用戶端字串的 SQL 字串。

另請參閱

自訂檔案 Connect 區段
自訂檔案 Logs 區段
自訂檔案 UserList 區段
DataFactory 自訂
必要用戶端設定
了解自訂檔案
撰寫您自己的自訂處理常式