Admin: 1 revision imported

2021-02-07T06:52:29Z

1 revision imported

Admin at 06:49, 13 November 2019

2019-11-13T06:49:24Z

New page

{{infobox function
|name=Execute
|object=[[Объект запрос базы данных|Запрос базы данных]]
|caption=Выполнение запроса
|type=1
|status=2
|db=2
|exception=Невозможно превратить в строку, число, неверные параметры, ошибка запроса
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект запрос базы данных]]}}
Функция выполняет запрос, заданный текстом в нужном режиме с необходимыми свойствами. Функция отдает таблицу результата запроса, если это необходимо. Если в процессе запроса будет найдена ошибка, функция вызовет исключение.

== Синтаксис ==
<code>
{{Grey|Query.}}'''Execute'''(''<Текст запроса (STRING)>''{{Optional|,<Режим запроса (INT)>{{Default|{{Eq}}1}},<Выполнять агрегацию столбцов (INT)>{{Default|{{Eq}}1}},<Столбцы с объектами, загружаемыми в режиме заголовка (STRING)>{{Default|{{Eq}}""}}}}):''<Таблица результата запроса (TAB)>''
</code>

==== Аргументы ====
* <code>''<Текст запроса (STRING)>''</code> - Аргумент задает текст запроса для выполнения.
* <code>''<Режим запроса (INT)>''</code> - {{optional}} Задает режим выполнения запроса, возможны следующие значения:
** '''0''' -- Не выполнять постобработку. Выполнение запроса останавливается после окончания первого этапа (см. [[Объект запрос базы данных]]), продолжить выполнение, если это необходимо, можно вызвав функцию [[Query.Postprocess|Postprocess]].
** '''1''' (по умолчанию) -- Выполнить постобработку в режиме обычного запроса.
** '''2''' -- Выполнить постобработку в линейном режиме
* <code>''<Выполнять агрегацию столбцов (INT)>''</code> - {{optional}} Запрещает (0) или разрешает (1, по умолчанию) подсчет агрегации столбцов для обычного режима запроса в момент выполнения второго этапа запроса.
* <code>''<Столбцы с объектами, загружаемыми в режиме заголовка (STRING)>''</code> - {{optional}} Аргумент задает наименования столбцов через запятую, для которых загрузка объектов перед сортировкой объектов будет проходить в режиме только заголовков (экономия памяти), для всех объектов столбцов, которые не перечислены в данном аргументе, будет происходить полная загрузка. Режим загрузки объектов перед началом сортировки, во время выполнения второго этапа запроса, можно отменить, если во втором аргументе функции указан режим 0, либо с помощью опции постобработки ''DoNotMassLoadBeforeAggregation''.

==== Возвращаемое значение ====
Возвращает таблицу значений -- результат выполнения запроса.

== Примеры ==
<pre>
Var З Export;

//Функция обхода группировок на основе рекурсии
Function ОбходГруппировок(Уровень)
If Уровень>З.GroupCount Then
Exit;
EndIf;

While З.Next(Уровень) Do
//Получить значение текущей группировки
зЭл:=З.Get(З.Groups(Уровень));

//Получить сальдо агрегации для текущей строки
зНачОст:=З.зНачОст;
зКонОст:=З.зКонОст;
зПриход:=З.зПриход;
зРасход:=З.зРасход;

//Вывод информации в печатную форму отчета
...

//Перейти к следующей группировке
ОбходГруппировок(Уровень+1);
EndDo;
EndFunction

//Выполним запрос с произвольным количеством группировок
ТЗ:=...

З:=Query.Create();
З.Execute(ТЗ);

//Вывести заголовок в печатную форму отчета
...

//Вывод строк группировок
ОбходГруппировок(1);

//Вывод строки итого, работает как линейных, так и для обычных запросов
зНачОст:=З.BegTotals("зНачОст");
зКонОст:=З.EndTotals("зКонОст");
зПриход:=З.Compute("зПриход");
зРасход:=З.Compute("зРасход");

...

</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

Query.Execute - Revision history

Admin: 1 revision imported

Admin at 06:49, 13 November 2019