Редактируемые результаты запроса

Результаты выполнения некоторых запросов можно редактировать. Это уникальное свойство языка запросов AggreGate, которое помогает собирать свойства различных объектов или настроек оборудования в одну таблицу (включая только необходимые поля, упорядочивая и формируя по группам) и редактировать эти свойства в удобной форме.

Поле в результате запроса может быть изменено при выполнении следующих условий:

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

  • Переменная, из которой извлечено данное поле, не должна быть только для чтения.

  • Значение данного поля не должно получаться при помощи вычислений (используя простые функции, функции агрегации или выражения языка запросов).

  • Поле не должно извлекаться из таблицы, построенной при помощи вложенного запроса.

  • Все поля исходной таблицы должны выбираться в разделе ВЫБРАТЬ при помощи * или tableAlias.*  (это делать необязательно, если использовать поля обратной записи).

Редактируемые результаты запроса доступны только при редактировании значения переменной результатов запроса (data) контекста запроса.

Пример 1:

SELECT * FROM users.*:childInfo

Большинство полей в результате этого запроса могут быть изменены, потому что:

  • Они происходят напрямую из значения переменной userInfo,

  • Они доступны для записи в формате этой переменной,

  • Они не конвертируются при помощи функции или выражения в результате запроса,

  • Их отбор осуществляется при использовании * и без помощи ссылок на поля.

Некоторые поля (например, поле "Username") не доступны для редактирования, потому что они не определены как редактируемые в переменной childInfo.

Пример 2:

SELECT childInfo$firstname, childInfo$lastname FROM users.*:childInfo

Результат данного запроса не будет включать какие-либо редактируемые поля, потому что необходимые для выборки поля включаются в список прямо в разделе ВЫБРАТЬ, и поля обратной записи не определены в тексте запроса.

Поля обратной записи

Существует специальный способ выбрать определенное заранее количество полей, внося их в список раздела ВЫБРАТЬ и при этом сохраняя их доступными для редактирования. Для этого вам необходимо добавить три так называемых поля "обратной записи" к списку контекстных ссылок в запросе ВЫБРАТЬ. Данные поля помогут процессору запроса обнаружить, где должна быть сохранена информация при редактировании результатов запроса.

Формат ссылок на поля обратной записи выглядит следующим образом:

tableAlias.CONTEXT_ID, tableAlias.PARENT_ID, tableAlias.RECORD_INDEX

где tableAlias - альтернативное имя контекстной ссылки в разделе ОТ, CONTEXT_ID, PARENT_ID и RECORD_INDEX - определенные заранее константы. Просто внесите их в текст запроса как есть, без всяких изменений.

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

Пример:

Предположим, что мы имеем запрос, который отображает статистику трафика всех серверов устройств, доступных пользователю, выполняющему запрос:

SELECT 
 info.deviceServerInfo$owner, 
 info.deviceServerInfo$name, 
 info.deviceServerInfo$description, 
 info.deviceServerInfo$blocked, 
 info.status$servertods, 
 info.status$dstoserver,
FROM 
 users.*.deviceservers.*:status:deviceServerInfo as info

Результат данного запроса не может быть изменен, потому что выбранные поля находятся прямо в разделе ВЫБРАТЬ.

Чтобы сделать их редактируемыми, нужно добавить поля обратной записи к разделу ВЫБРАТЬ:

SELECT 
 info.deviceServerInfo$owner, 
 info.deviceServerInfo$name, 
 info.deviceServerInfo$description, 
 info.deviceServerInfo$blocked, 
 info.status$servertods, 
 info.status$dstoserver,
 info.CONTEXT_ID,
 info.PARENT_ID,
 info.RECORD_INDEX
FROM 
 users.*.deviceservers.*:status:deviceServerInfo as info

Это позволит сделать описание сервера и результаты запроса редактируемыми. Остальные поля останутся доступными только для чтения, т.к. они заданы, как доступные только для чтения, в формате переменных deviceServerInfo ("Информация о сервере устройства") и status ("Статус сервера устройства").

Если некоторые столбцы не редактируются из-за отсутствия полей обратной записи, это указывается в запросе отчет отладки.