Отладка логики запроса в консоли запросов ИР

Публикация № 1355985

Разработка - Инструментарий разработчика - Консоль запросов

запрос отладка консоль запросов ИР

Облегчаем поиск причины неожиданного результата запроса в консоли запросов из подсистемы "Инструменты разработчика" (ИР)

Актуально для подсистемы “Инструменты разработчика” 5.73

Термины статьи

  • Отладка логики программного кода - поиск причин получения неожиданного результата выполнения программного кода
  • Запрос - инструкция (оператор) над таблицами базы данных
  • Пакет запросов - последовательность запросов, использующих общий набор временных таблиц
  • Запрос пакета - последовательно выполняемый запрос в пакете запросов 
  • Подзапрос или вложенный запрос - запрос, являющийся частью другого запроса
  • Проблемный запрос - запрос, выдающий неожиданный результат

Вступление

При отладке логики программного кода на императивных языках, т.е. описывающих последовательность операций над переменными в памяти, мы имеем естественную возможность анализа состояния переменных после выполнения каждой операции. Встроенный язык 1С относится к таким языкам. 

Однако язык запросов 1С, как и родительский SQL, относятся к декларативным языкам, т.е. описывающим сразу конечное состояние (результат).  В таких языках отладка логики в каждом языке очень специфична и приходится изобретать свои приемы и инструменты, т.к. внутренние алгоритмы получения результата большей частью скрыты от программиста.

Написав или изменив запрос, мы обычно проверяем его работу в консоли запросов, чтобы убедиться в соответствии выдаваемого им результата нашим ожиданиям. Рассмотрим, какими приемами можно отлаживать логику запроса 1С в консоли запросов из подсистемы Инструменты разработчика (ИР).

Поиск проблемного запроса

Пакет запросов в языке запросов - шаг в сторону императивных языков. Временные таблицы здесь играют роль переменных, а запросы пакета - роль операций над этими переменными. Поэтому в большинстве случаев начинать отладку лучше с локализации проблемных запросов пакета.

Сериализация логики запроса

Любой подзапрос в целях отладки можно перенести в отдельный запрос пакета, создающий временную таблицу, и заменить его текст в исходном месте на выборку из этой временной таблицы. Многие консоли запросов позволяют делать это нажатием одной кнопки и консоль запросов ИР в частности.

Также в отдельные запросы пакета можно переносить и соединяемые выборки из секции “ИЗ” при наличии у них собственных отборов. Но тут уже придется делать все вручную.

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

Отладка подзапросов

Некоторые консоли запросов позволяют отлаживать подзапросы и части объединения прямо в месте их определения. Консоль запросов ИР в режиме дерева запроса так уже очень давно позволяет делать. Двойным кликом в строке дерева в ней можно выполнить любой подзапрос.

 

Также можно выполнить все подзапросы автоматизировано, что может быть полезно для ускорения поиска проблемных подзапросов путем анализа количества возвращаемых строк.

Отладка неделимого запроса

Если на входе в запрос все таблицы и вложенные запросы передают ожидаемые данные, то дальше встает задача поиска ошибки в значениях параметров или тексте этого запроса. Расхождение между ожидаемым и фактическим результатом запроса состоит из проблемных строк 3-х типов: 

  • строка с неожиданными значениями неключевых полей
  • отсутствующая строка с нужными ключевыми полями
  • лишняя строка

Таким образом дальше нам нужно разбираться с этими проблемными строками.

Для помощи в решении этой задачи в консоли запросов ИР имеется команда “Расшифровать строку результата запроса. Она создает временный запрос в отдельном окне консоли с добавлением в тексте запроса значений всех однозначных базовых выражений для выбранной строки результата.

Рассмотрим работу этой команды на примерах.

Строка с неожиданными значениями неключевых полей

Имеем запрос

ВЫБРАТЬ

    КурсыВалютТ.Валюта КАК Валюта,

    ВЫБОР

        КОГДА МАКСИМУМ(КурсыВалютТ.Курс) > &МаксимальныйКурс

            ТОГДА 1

        ИНАЧЕ 2

    КОНЕЦ КАК КатегорияКурса

ИЗ

    РегистрСведений.КурсыВалют КАК КурсыВалютТ

ГДЕ ИСТИНА

    И КурсыВалютТ.Период > &ДатаНачала

    И КурсыВалютТ.Период < &ДатаКонца

СГРУППИРОВАТЬ ПО

    КурсыВалютТ.Валюта

с параметрами

Имя параметра

Значение

ДатаНачала

01.01.2006 0:00:00

ДатаКонца

01.01.2007 0:00:00

МаксимальныйКурс

34

 

выдающий для валюты USD результат КатегорияКурса=1, но мы ждали КатегорияКурса=2. 

Активируем проблемную строку результата и выполним команду “Расшифровать строку”.

При этом откроется новое окно консоли запросов в режиме “Расшифровки”, о чем свидетельствует заголовок формы.

В списке запросов этого окна консоли появится одноименный исходному пакет запросов расшифровки. Если исходный запрос содержит группировку (секцию СГРУППИРОВАТЬ ПО или агрегатные функции), то первым запросом пакета будет вывод всех строк, попадающих в группировку выбранной строки. Последний запрос этого пакета всегда выводит результат исходного запроса, выполненного с отбором по всем выбранным полям исходного запроса для выбранной строки, и с встроенными в текст значениями базовых выражений после группировки. Однако эти дополнительные отборы применяются разово и сразу удаляются из текста запроса расшифровки. Он же активируется при открытии окна консоли в режиме “Расшифровки”. В тексте запроса сразу выделяется то выбранное поле, колонка которого является текущей в результате исходного запроса. 

В этом примере нас интересует выбранное поле КатегорияКурса. В расшифровке его выражение выглядит так

    ВЫБОР

        КОГДА МАКСИМУМ(КурсыВалютТ.Курс){34.58} > &МаксимальныйКурс{34}

            ТОГДА 1

        ИНАЧЕ 2

    КОНЕЦ КАК КатегорияКурса

В фигурных скобках указываются представления значений выражений, находящихся слева от этих скобок. Таким образом в нашем случае мы понимаем, что результатом агрегатной функции МАКСИМУМ(КурсыВалютТ.Курс) является число 34.58, а значением параметра &МаксимальныйКурс является число 34. 

Далее мы можем активировать первый запрос расшифровки с названием “ДоГруппировки”, чтобы изучить вычисление агрегатных функций.

В этом запросе обычно будет уже много строк и потому не будет встроенных в текст запроса значений выражений. В нем также накладывается дополнительный отбор, но уже не удаляется. Также в нем выбираются дополнительно все использованные в тексте запроса поля таблиц, чтобы легче было искать проблемные строки. После обнаружения проблемной строки в результате этого запроса можно вызывать расшифровку и для нее.

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

Отсутствующая строка с нужными ключевыми полями

Имеем запрос 

ВЫБРАТЬ

    КурсыВалютТ.Валюта КАК Валюта,

    МАКСИМУМ(КурсыВалютТ.Курс) КАК Курс

ИЗ

    РегистрСведений.КурсыВалют КАК КурсыВалютТ

ГДЕ ИСТИНА

    И КурсыВалютТ.Период > &ДатаНачала

    И НЕ (КурсыВалютТ.Валюта В (&ЗапрещенныеВалюты))

    И КурсыВалютТ.Период < &ДатаКонца

СГРУППИРОВАТЬ ПО

    КурсыВалютТ.Валюта

ИМЕЮЩИЕ МАКСИМУМ(КурсыВалютТ.Курс) < &МаксимальныйКурс

с параметрами

Имя параметра

Значение

ДатаНачала

01.01.2007 0:00:00

ДатаКонца

01.01.2006 0:00:00

ЗапрещенныеВалюты

(1): ё126

МаксимальныйКурс

50

 

и мы ожидаем в его результате строку Валюта=USD, но фактически он возвращает 0 строк. Снова выполняем команду “Расшифровать строку” и в ответе на вопрос выбираем вариант “Выполнить запрос без отбора”. 

При этом из текущего запроса разово удаляются отборы (до и после группировки) и выводится результат для того, чтобы пользователь смог выбрать нужную строку. Находим в таком результате запроса нужную строку и вызываем команду “Расшифровать строку” снова.

Получаем расшифровку с пустым результатом запроса после группировки

В нашем простом примере уже здесь можно заметить, что у нас перепутаны значения параметров “ДатаНачала” и “ДатаКонца”. В реальных ситуациях все может быть намного сложнее и заметить подобную ошибку в установке значений параметров в этом запросе может быть непросто. Поэтому переходим к запросу “ДоГруппировки”.

Этот запрос также может вернуть пустой результат. Если такое произошло, то он автоматически разово повторно выполняется без отборов и дописывает соответствующий комментарий в секцию “ГДЕ” текста запроса. Далее активируем в результате без отбора любую строку, которую мы ожидаем в результате с отбором, и снова вызываем для нее команду “Расшифровать строку”.

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

Специальные предложения

Комментарии
В избранное Подписаться на ответы Сортировка: Рейтинг всех уровней
2. ПрестарелыйЗаяц 05.01.21 15:27 Сейчас в теме
О! Сергей наконец ты стал документировать свои разраработки, а то столько фич, но пока старшие товарищи носом не тыкнут.
akamuza; gorakh; mike1970; KilloN; immemor; caponid; nvv1970; Batman; +8 Ответить
4. json 2810 08.01.21 04:09 Сейчас в теме
Инфостарт продвигает другую альтернативную разработку.

Хотя ИР в разы круче. Тулкит - пред-пред-ыдущее поколение по сравнению с ИР. И слабо верится, что Тулкит когда-нибудь сможет хотя бы приблизится по функиональности и продуманности каждой детали по сравнению ИР.

Очень жаль, что Сергею пока не предложили работать с Инфостартом. Ведь если ему выделить необходимый бюджет, то он смог бы перевести ИР на управляемый интерфейс и это потенциально можно было бы неплохо монетизировать. В результате все бы получили выгоду.

Как вариант, чтобы текущая версия ИР в виде расширения через обычные формы оставалась бесплатной, а портативная для тонкого клиента с низким режимом совместимости (чтобы охватить максимальное количество разработчиков) была бы платной. Плюс сделать подписку на обновления, как в Снегопате.
ubnkfl; Olenevod; akamuza; gravitator; mike1970; kuzyara; rhtr; ShiningPhoenix; +8 Ответить
3. aspirator23 446 06.01.21 14:46 Сейчас в теме
Постоянно пользуюсь ИР. Но многие возможности за боротом. "Апатамушта" слабо документированы. Хотя конечно понимаю, что требовать от автора - это тоже перебор. Статья очень полезна.
akamuza; gorakh; mike1970; ABudnikov; dante; immemor; rozer; +7 Ответить
1. sapervodichka 4211 05.01.21 14:57 Сейчас в теме
5. triviumfan 24 09.01.21 00:02 Сейчас в теме
Активно пользуюсь ИР, но тут столько наворотов... даже не знаю, попробую разобраться! :)
6. DrAku1a 1419 10.01.21 15:06 Сейчас в теме
7. _also 447 14.01.21 20:48 Сейчас в теме
Сергей, спасибо огромное за ваш инструмент! Можно попросить маленькую фичу: в консоли запросов, на вкладке Обработка строки результата сделать флаг "Обработать только первую строку". Она очень полезна. Сделали запрос, написали код обработки, оттестировали на первой строке и дальше уже запускаем полную обработку.
8. tormozit 6232 14.01.21 21:16 Сейчас в теме
(7) Я в таких случаях пользуюсь ограничением количества загружаемых строк результата. Создал задачу https://www.hostedredmine.com/issues/915456 . Зарегистрированные пользователи могут подписаться на ее изменения. Также получают уведомления те, кто описал свое пожелание в виде новой темы на официальном форуме и подписались на нее.
Оставьте свое сообщение

См. также

Подсистема "Инструменты разработчика" v5.80 Промо

Инструментарий разработчика v8 1cv8.cf Бесплатно (free)

Интегрированный набор инструментов разработчика: - консоль кода - консоль запросов - консоль построителя отчетов - консоль компоновки данных - консоль заданий - конструктор запроса - справочник алгоритмов - исследователь объектов - интерфейсная панель - настройка журнала регистрации - анализ журнала регистрации - настройка техножурнала - анализ техножурнала - подбор и обработка объектов - редактор объекта БД - редактор констант - редактор параметров сеанса - редактор изменений по плану обмена - редактор пользователей - редактор предопределенных - редактор хранилищ настроек - динамический список - поиск дублей и замена ссылок - контекстная подсказка - синтакс-помощник - поиск битых ссылок - поиск ссылок на объект - структура хранения БД - удаление объектов с контролем ссылок - и прочее

23.09.2007    556447    34058    tormozit    2766    

Структура запроса (Infostart Toolkit)

Консоль запросов Прочие инструменты разработчика v8 v8::Запросы 1cv8.cf Бесплатно (free)

Описание механизма разбора запроса на части (дерево), используемого в IS Toolkit и Управляемой консоли отчетов

вчера в 10:00    463    Evg-Lylyk    6    

Последний раз про срез последних (на каждую дату в запросе)

Инструментарий разработчика Практика программирования Консоль запросов Универсальные функции v8 v8::Запросы Бесплатно (free)

Срез последних на каждую дату в запросе. Известные факты о задаче: часто встречается на испытаниях соискателей на работу программистом 1с, постоянно провоцирует споры об оптимальном решении. В данном тексте приводятся замеры производительности различных вариантов решения задачи.

15.02.2021    2813    randomus    47    

Отладка в Infostart Toolkit

Консоль запросов Прочие инструменты разработчика v8 1cv8.cf Бесплатно (free)

Отладка запросов, схем компоновки данных, просмотр содержимого менеджера временных таблиц.

05.11.2020    3030    Evg-Lylyk    16    

Подсистема "COMExchange": консоль запросов в режиме «Консоль кода». Промо

Консоль запросов v8 1cv8.cf Россия Бесплатно (free)

Описана возможность использования обработки «Консоль запросов 1С+ADO» в качестве «консоли кода». При этом имеется возможность помещения результатов вычислений в «табло формул». Кроме результатов вычислений в это «табло» можно также вывести время выполнения и описание обработанных ошибок времени исполнения.

03.04.2014    26192    yuraos    2    

Улучшенный конструктор запроса тонкого клиента (Infostart Toolkit)

Инструментарий разработчика Консоль запросов v8 1cv8.cf Бесплатно (free)

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

07.09.2020    3784    Evg-Lylyk    13    

Обработка кодом результата запроса в Консоли запросов 9000

Консоль запросов v8::Запросы Бесплатно (free)

Пять вариантов обработки кодом в консоли запросов 9000: простое выполнение, построчно без индикации, построчно с индикацией, простое в фоне, построчно в фоне с индикацией.

01.06.2020    1697    kuza2000    7    

Управляемая консоль отчетов – новый функциональный инструмент для работы с запросами и СКД в управляемых формах

Прочие инструменты разработчика Консоль запросов v8::УФ v8::Запросы v8::СКД Бесплатно (free)

Консоль запросов и СКД – один из наиболее часто используемых программистом инструментов. Как с его помощью можно упростить разработку, в своем докладе на конференции Infostart Event 2019 Inception рассказал Евгений Люлюк, ведущий программист компании GLT.

06.04.2020    8747    Evg-Lylyk    0    

Подсистема "COMExchange", "Консоль запросов 1C + ADO" - сервис обработки выборки запроса: грузим курс «бакса» ЦБРФ из файла *.dbf или *.xlsx. Промо

Консоль запросов v8 КА1 УТ10 УПП1 Россия Бесплатно (free)

На примере загрузки курса валюты продемонстрированы возможности консоли запросов в составе подсистемы "COMExchange" для обработки данных из внешних файлов и их синхронизации с данными информационной базы 1С.

10.03.2013    33437    yuraos    3    

[8.3] Анализ планов запросов (Управляемая консоль отчетов)

Консоль запросов v8 1cv8.cf Бесплатно (free)

Новый инструмент! Позволяет удобно работать с планами запросов, анализ планов в файловой базе.

19.11.2018    20183    Evg-Lylyk    12    

Консоль запросов для УФ с возможностью передачи готовой ТЗ в качестве параметра

Консоль запросов v8 v8::УФ Россия Бесплатно (free)

Небольшая статья о том, как передать готовую таблицу значений в качестве параметра запроса в консоли запросов.

11.07.2016    15014    vadim1011985    7    

Консоль запросов. Очередная гайка.

Консоль запросов v8 1cv8.cf Бесплатно (free)

Небольшое дополнение к консоли запросов. Позволяет создавать функцию вместе с текстом запроса.

23.07.2014    8291    mdmdvd    3    

Подсистема "COMExchange", консоль запросов, сервис обработки выборки запроса: корректируем регистры или «Берём банк, кассу, экспроприируем экспроприаторов». Промо

Консоль запросов v8 1cv8.cf Россия Бесплатно (free)

На примере шуточного примера продемонстрированы не шуточные возможности консоли запросов в составе подсистемы "COMExchange" для работы с регистрами, подчинёнными регистратору («обнуление» регистров, ввод начальных итогов (сведений), корректировка итогов).

31.03.2013    22692    yuraos    7