Раздел SQL файла настройки
Раздел sql может содержать новую строку SQL, которая заменяет строку командной строки клиента. Если в разделе нет строки SQL, раздел будет игнорироваться.
Важный
Начиная с Windows 8 и Windows Server 2012, компоненты сервера RDS больше не включены в операционную систему Windows (дополнительные сведения см. в статье Windows 8 и Windows Server 2012 Compatibility Cookbook). Клиентские компоненты 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 является пустой строкой (""), раздел игнорируется.
Если новая строка инструкции SQL недопустима, выполнение инструкции завершится ошибкой. Параметр клиента фактически игнорируется. Это можно сделать намеренно, чтобы отключить все команды SQL клиента, указав:
[SQL default]
SQL = " "
Синтаксис
Замещающая строка SQL имеет форму:
SQL=
sqlString
Часть | Описание |
---|---|
SQL | Литеральная строка, указывающая, что это запись раздела SQL. |
sqlString | Строка SQL, которая заменяет строку клиента. |
См. также
Раздел подключения к файлу настройки
раздел "Журналы файлов настройки"
раздела userList файла настройки
Настройка DataFactory
необходимые параметры клиента
Общие сведения о файле настройки
создание собственного настраиваемого обработчика