自定义文件 SQL 部分

sql 段可以包含新的 SQL 字符串来替换客户端命令字符串。 如果节中没有 SQL 字符串，将忽略该节。

重要

从 Windows 8 和 Windows Server 2012 开始，RDS 服务器组件不再包含在 Windows 操作系统中（有关详细信息，请参阅 Windows 8 和 Windows Server 2012 兼容性指南）。 RDS 客户端组件将在将来的 Windows 版本中删除。 避免在新开发工作中使用此功能，并计划修改当前使用此功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务。

新的 SQL 字符串可以 参数化。 也就是说，sql 节 SQL 字符串（由“？”字符指定）中的参数可以替换为客户端命令字符串中 标识符 中的相应参数（用括号中的逗号分隔列表指定）。 标识符和参数列表的行为类似于函数调用。

例如，假设客户端命令字符串 "CustomerByID(4)"，SQL 节标头 [SQL CustomerByID]，并且新的 SQL 节字符串 "SELECT * FROM Customers WHERE CustomerID = ?". 处理程序将生成 "SELECT * FROM Customers WHERE CustomerID = 4" 并使用该字符串查询数据源。

如果新的 SQL 语句为 null 字符串（“），则忽略该节。

如果新的 SQL 语句字符串无效，则语句的执行将失败。 有效地忽略客户端参数。 为此，可以有意“关闭”所有客户端 SQL 命令，方法是指定：

[SQL default]   
SQL = " "  

语法

替换 SQL 字符串条目的格式如下：

SQL=
sqlString

部分	描述
SQL	一个文本字符串，指示这是一个 SQL 节项。
sqlString	替换客户端字符串的 SQL 字符串。

另请参阅

自定义文件连接部分
自定义文件日志部分
自定义文件 UserList 节
DataFactory 自定义
所需的客户端设置
了解自定义文件
编写自己的自定义处理程序