Поделиться через

Настройка раздела 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 является пустой строкой (""), то раздел игнорируется.

Если новая строка инструкции SQL недопустима, выполнение инструкции завершится ошибкой. Параметр клиента фактически игнорируется. Это можно сделать намеренно, чтобы "отключить" все клиентские команды SQL, указав:

[SQL default]   
SQL = " "

Синтаксис

Замещающая запись строки SQL имеет следующий вид:

SQL=
sqlString

Часть Описание
SQL Строка литерала, указывающая, что это запись раздела SQL.
sqlString Строка SQL, которая заменяет строку клиента.

См. также:

Настройка раздела подключения файла
Настройка раздела журналов файла
Настройка раздела UserList файла
Настройка DataFactory
Требуемые параметры клиента
Общие сведения о файле настроек
Создание собственного настраиваемого обработчика