Тип: ЗапросВыбораСхемыЗапроса. Содержит вложенный запрос.
Полное описание, параметры и ограничения
ВложенныйЗапросСхемыЗапроса.Запрос (QuerySchemaNestedQuery.Query)
ВложенныйЗапросСхемыЗапроса (QuerySchemaNestedQuery)
Запрос (Query)
Доступен, начиная с версии 8.3.5.
Использование:
Только чтение.
Описание:
Тип: ЗапросВыбораСхемыЗапроса.
Содержит вложенный запрос.
Доступность:
Сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.5.
Методическая информация
Практические примеры
Изменить условие соединения и проверить исчезновение строки
Добавляем к совпадению имени условие количества больше 3. У книги количество ровно 3: внутреннее соединение временно даёт пустой результат.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной обработке или общем модуле выполните каждый фрагмент отдельно на сервере. Все запросы используют только свои числа и параметры, без справочников, документов и регистров рабочей базы.
СхемаЗапроса редактирует структуру и формирует текст, а Запрос выполняет этот текст. Родительская схема должна оставаться в переменной, пока используются её дочерние объекты.
Не переносите полученные дочерние объекты между разными схемами и не обращайтесь к элементу после его удаления. Упражнения удаления работают только со своей структурой в памяти.
Схема = Новый СхемаЗапроса;
Схема.УстановитьТекстЗапроса("ВЫБРАТЬ 3 КАК Количество, 250 КАК Цена");
Если Схема.ПакетЗапросов.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный запрос";
КонецЕсли;
Выбор = Схема.ПакетЗапросов.Получить(0);
Если ТипЗнч(Выбор) <> Тип("ЗапросВыбораСхемыЗапроса") Тогда
ВызватьИсключение "Первый собственный запрос не является выборкой";
КонецЕсли;
Если Выбор.Операторы.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный оператор ВЫБРАТЬ";
КонецЕсли;
Оператор = Выбор.Операторы.Получить(0);
Источники = Оператор.Источники;
ТоварыИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Товары");
ЦеныИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Цены");
ТоварыИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 3 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""Ручка"", 1");
ЦеныИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 250 КАК Цена");
Поля = Оператор.ВыбираемыеПоля;
Поля.Очистить();
ПолеИмя = Поля.Добавить("Товары.Наименование");
ПолеКоличество = Поля.Добавить("Товары.Количество");
ПолеЦена = Поля.Добавить("ЕСТЬNULL(Цены.Цена, 0)");
КолонкаИмя = Выбор.Колонки.Найти(ПолеИмя);
КолонкаКоличество = Выбор.Колонки.Найти(ПолеКоличество);
КолонкаЦена = Выбор.Колонки.Найти(ПолеЦена);
Если КолонкаИмя = Неопределено Или КолонкаКоличество = Неопределено Или КолонкаЦена = Неопределено Тогда
ВызватьИсключение "Нет колонок собственных товаров и цен";
КонецЕсли;
КолонкаИмя.Псевдоним = "Наименование";
КолонкаКоличество.Псевдоним = "Количество";
КолонкаЦена.Псевдоним = "Цена";
Соединения = ТоварыИсточник.Соединения;
Связь = Соединения.Добавить(ЦеныИсточник, "Товары.Наименование = Цены.Наименование");
Связь.ТипСоединения = ТипСоединенияСхемыЗапроса.ЛевоеВнешнее;
Связь.ТипСоединения = ТипСоединенияСхемыЗапроса.Внутреннее;
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
До = Запрос.Выполнить().Выгрузить();
Если До.Количество() <> 1 Тогда
ВызватьИсключение "Неожиданное число собственных строк соединения";
КонецЕсли;
Связь.Условие = Новый ВыражениеСхемыЗапроса("Товары.Наименование = Цены.Наименование И Товары.Количество > 3");
Сообщить(Не Связь.Условие.СодержитАгрегатнуюФункцию());
Сообщить(Связь.Условие.ТипЗначения().СодержитТип(Тип("Булево")));
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
После = Запрос.Выполнить().Выгрузить();
Если После.Количество() <> 0 Тогда
ВызватьИсключение "Неожиданное число собственных строк соединения";
КонецЕсли;
Связь.Условие = Новый ВыражениеСхемыЗапроса("Товары.Наименование = Цены.Наименование");
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
Восстановлено = Запрос.Выполнить().Выгрузить();
Если Восстановлено.Количество() <> 1 Тогда
ВызватьИсключение "Неожиданное число собственных строк соединения";
КонецЕсли;
Сообщить(До[0].Количество = 3);
Сообщить(После.Количество() = 0);
Сообщить(Восстановлено[0].Количество * Восстановлено[0].Цена = 750);Разбор по шагам
Сначала внутреннее соединение находит собственную книгу; число строк проверено до индексного доступа.
Условие — объект ВыражениеСхемыЗапроса, не строковое свойство. Создаём выражение конструктором и присваиваем целиком.
Логическое выражение не содержит агрегатной функции; рекомендуемый тип содержит Булево.
Число 3 не больше 3, поэтому совпадений после изменения нет. Пустой результат не индексируем.
Восстановив прежнее условие, отдельно выполняем запрос и проверяем сумму 750.
Как проверить результат
Пять сообщений Истина.
Количество строк До/После/Восстановлено: 1/0/1.
Ожидаемый результат
Видно влияние настоящего условия связи, а не только чтение свойства.
На что обратить внимание
Условия соединения и внешний ГДЕ могут давать разные результаты для внешних соединений.
Не подставляйте непроверенный пользовательский текст в выражение. Здесь весь текст собственный.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Найти и удалить только свою связь источников
Проверяем собственное соединение по псевдониму Цены, получаем допустимый индекс и удаляем его после выполнения запроса.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В учебной обработке или общем модуле выполните каждый фрагмент отдельно на сервере. Все запросы используют только свои числа и параметры, без справочников, документов и регистров рабочей базы.
СхемаЗапроса редактирует структуру и формирует текст, а Запрос выполняет этот текст. Родительская схема должна оставаться в переменной, пока используются её дочерние объекты.
Не переносите полученные дочерние объекты между разными схемами и не обращайтесь к элементу после его удаления. Упражнения удаления работают только со своей структурой в памяти.
Схема = Новый СхемаЗапроса;
Схема.УстановитьТекстЗапроса("ВЫБРАТЬ 3 КАК Количество, 250 КАК Цена");
Если Схема.ПакетЗапросов.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный запрос";
КонецЕсли;
Выбор = Схема.ПакетЗапросов.Получить(0);
Если ТипЗнч(Выбор) <> Тип("ЗапросВыбораСхемыЗапроса") Тогда
ВызватьИсключение "Первый собственный запрос не является выборкой";
КонецЕсли;
Если Выбор.Операторы.Количество() <> 1 Тогда
ВызватьИсключение "Ожидался один собственный оператор ВЫБРАТЬ";
КонецЕсли;
Оператор = Выбор.Операторы.Получить(0);
Источники = Оператор.Источники;
ТоварыИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Товары");
ЦеныИсточник = Источники.Добавить(Тип("ВложенныйЗапросСхемыЗапроса"), "Цены");
ТоварыИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 3 КАК Количество ОБЪЕДИНИТЬ ВСЕ ВЫБРАТЬ ""Ручка"", 1");
ЦеныИсточник.Источник.Запрос.УстановитьТекстЗапроса("ВЫБРАТЬ ""Книга"" КАК Наименование, 250 КАК Цена");
Поля = Оператор.ВыбираемыеПоля;
Поля.Очистить();
ПолеИмя = Поля.Добавить("Товары.Наименование");
ПолеКоличество = Поля.Добавить("Товары.Количество");
ПолеЦена = Поля.Добавить("ЕСТЬNULL(Цены.Цена, 0)");
КолонкаИмя = Выбор.Колонки.Найти(ПолеИмя);
КолонкаКоличество = Выбор.Колонки.Найти(ПолеКоличество);
КолонкаЦена = Выбор.Колонки.Найти(ПолеЦена);
Если КолонкаИмя = Неопределено Или КолонкаКоличество = Неопределено Или КолонкаЦена = Неопределено Тогда
ВызватьИсключение "Нет колонок собственных товаров и цен";
КонецЕсли;
КолонкаИмя.Псевдоним = "Наименование";
КолонкаКоличество.Псевдоним = "Количество";
КолонкаЦена.Псевдоним = "Цена";
Соединения = ТоварыИсточник.Соединения;
Связь = Соединения.Добавить(ЦеныИсточник, "Товары.Наименование = Цены.Наименование");
Связь.ТипСоединения = ТипСоединенияСхемыЗапроса.ЛевоеВнешнее;
Найденная = Соединения.НайтиПоПсевдониму("Цены");
Если Найденная = Неопределено Тогда
ВызватьИсключение "Не найдена собственная связь с ценами";
КонецЕсли;
Если Соединения.Количество() <> 1 Тогда
ВызватьИсключение "Ожидалась одна собственная связь";
КонецЕсли;
ИндексСвязи = Соединения.Индекс(Найденная);
Если ИндексСвязи < 0 Или ИндексСвязи >= Соединения.Количество() Тогда
ВызватьИсключение "Недопустимый индекс собственной связи";
КонецЕсли;
Сообщить(Соединения.Получить(ИндексСвязи).Источник = ЦеныИсточник);
Сообщить(Соединения.НайтиПоИмени("НетТакойУчебнойТаблицы") = Неопределено);
Запрос = Новый Запрос(Схема.ПолучитьТекстЗапроса());
ДоУдаления = Запрос.Выполнить().Выгрузить();
Если ДоУдаления.Количество() <> 2 Тогда
ВызватьИсключение "Неожиданное число собственных строк соединения";
КонецЕсли;
Сообщить(ДоУдаления.Количество() = 2);
Соединения.Удалить(ИндексСвязи);
Сообщить(Соединения.Количество() = 0);
Соединения.Очистить();
Сообщить(Соединения.Количество() = 0);Разбор по шагам
Ищем связь по псевдониму созданного нами источника, а не по подписи товара.
НайтиПоИмени предназначен для полного имени таблицы. У вложенного источника нет имени Справочник.Товары, поэтому проверяем отдельный случай отсутствия.
Индекс проверен на оба края до Получить и Удалить.
Пока связь существует, выполняем свой запрос и получаем оба товара.
Удаляем элемент собственной коллекции в памяти. После этого не используем Связь или Найденная и не выполняем старую структуру запроса.
Как проверить результат
Пять сообщений Истина.
После удаления и очистки собственная коллекция соединений пуста.
Ожидаемый результат
Разобран жизненный цикл дочернего объекта связи.
На что обратить внимание
Удаление связи может изменить смысл запроса; без осознанной перестройки его не выполняют.
Очистить здесь не удаляет ни товары, ни цены из базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.