SqlQueries

Sql-запрос.

Описание SqlQuery

<SqlQuery Name="SqlQueryName" Type="SqlQueryType" Assembly="SqlQueryAssembly">
  <!--Тэги, общие для всех sql-запросов-->
  <!--Тэги, специфичные для определенного sql-запроса (зависит от типа)-->
</SqlQuery>

Атрибуты SqlQuery

Name

Название sql-запроса.

Обязательный атрибут.

Type

Название типа sql-запроса (если тип отличается от обычного).

Необязательный атрибут.

Assembly

Название сборки (библиотека), если тип sql-запроса не поддерживается по умолчанию.

Необязательный атрибут.

Тэги, общие для всех условий

Updates

Регистрация выполнения запроса в таблице "update" локальной схемы данных.

Необязательный тэг. Значение тэга <Updates>: список тэгов <Update>.

<Updates>
  <Update TableName="table_name" Type="Update" Parameter="Field1Value" OnlyLast="False" />
</Updates>

Тэг `<Update>`

Регистрация одного параметра выполнения запроса.

Обязательный тэг. Значение тэга <Update>: не ожидается.

Атрибуты тэга `<Update>`

TableName

Название таблицы, с которой работает запрос.

Обязательный атрибут.

Возможно использование названия одной из таблиц локальной схемы данных (может быть любое текстовое значение).

Type

Тип запроса.

Обязательный атрибут. Ожидается название одного из типов запросов.

Parameter

Имя параметра, переданного в запрос.

Обязательный атрибут. Ожидается имя одного из параметров, переданных в запрос.

OnlyLast

Признак, определяющий, будет ли строка с повторяющийся комбинацией значений в полях "table_name" (имя таблицы базы данных), "type" (тип запроса), "query_name" (название запроса) и "parameter" (значение параметра) в таблице "update" локальной схемы данных записана еще раз или будет обновлена существующая. Обновление коснется полей "user_id" (идентификатор пользователя, выполнившего запроса) и "date" (дата завершения выполнения запроса).

Необязательный атрибут. Ожидается логическое значение.

Если атрибут OnlyLast отсутствует, то по умолчанию используется значение False.

Регистрация выполнения запроса записывает для каждого параметра, указанного в атрибутах Parameter тэгов <Update>, строку в таблицу "update" локальной схемы данных. Подробнее см. описание системной таблицы "update".

Типы запросов

Select

Запрос на чтение данных из базы

Insert

Запрос на добавление данных в базу

Update

Запрос на обновление данных в базе

Delete

Запрос на удаление данных из базы

Text

Содержит sql-запрос.

Обязательный тэг. Значение тэга <Text>: текст sql-запроса.

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями параметров с соответствующими названиями, передаваемых клиентом.

В тексте запроса доступны следующие служебные переменные:

{ServerTimeZoneOffset} - текущий часовой пояс сервера в виде числа.
{TimeZoneDiff} - Разница между часовым поясом клиента и сервера в виде числа.

<Text>
  SQL-query
</Text>

Last updated 2 years ago