自定义文件 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 语句是空字符串 ("")，则忽略该节。

如果新 SQL 语句字符串无效，则语句的执行将失败。 实际上忽略了客户端参数。 你可以有意地执行此操作来“关闭”所有客户端 SQL 命令，方法是指定以下内容：

[SQL default]   
SQL = " "  

语法

替代的 SQL 字符串条目采用以下形式：

SQL=
sqlString

组成部分	说明
SQL	用于指示这是 SQL 节条目的文字字符串。
sqlString	用于替代客户端字符串的 SQL 字符串。

另请参阅

自定义文件 Connect 部分
自定义文件 Logs 部分
自定义文件 UserList 部分
自定义 DataFactory
必需的客户端设置
了解自定义文件
编写自己的自定义处理程序