gitverse.ru/rarus/query-schema-1C
Скачать файл
Инструмент визуализирует структуру сложных запросов 1С и SQL и помогает быстро увидеть связи между источниками данных, вложенные конструкции и использование временных таблиц.
Даже опытным разработчикам бывает затруднительно отслеживать связи в сложных запросах, особенно если задействованы десятки таблиц. Чтобы было проще понять заложенную логику и способы её реализации, разработан инструмент «Схема запроса 1С».
Предназначение инструмента
Инструмент на основании текста запроса выполняет построение диаграммы, визуализирующей потоки данных. На схеме отображаются все источники данных (таблицы баз данных), способы их соединения и объединения, применяемые вложенные запросы и временные таблицы, либо итоговые выборки, в которые эти данные помещаются.
Полностью поддерживается синтаксис:
- Языка запросов 1С, в т. ч. с изменениями в версии 8.3.25.
- SQL‑запросов, которые могут быть получены в результате разбора логов технологического журнала 1С.
Инструмент «Схема запроса 1С» распространяется в виде внешней обработки для платформы «1С:Предприятие 8.3». Рекомендуется использовать с версией платформы 8.3.27 и выше. Поддерживает работу в режиме тонкого, толстого и веб‑клиента.
Как работает инструмент
Инструмент «Схема запроса 1С» обладает простым и понятным интерфейсом. Для построения диаграммы достаточно вставить текст запроса на языке 1С или SQL в поле слева и нажать кнопку «Сформировать».
С помощью переключателей, расположенных на форме, можно управлять вариантом отображения диаграммы.
Варианты визуализации схем запросов
Инструмент поддерживает 2 варианта визуализации:
- Классическая визуализация — с помощью сервиса PlantUML. В данном режиме диаграмма преимущественно напоминает классическую ER‑модель базы данных. В нижней части диаграммы размещаются первые по тексту запроса временные таблицы, сверху — конечные выборки.
В диаграмме используются следующие обозначения элементов:
- Желтые блоки — исходные таблицы базы данных.
- Блоки без окраски — данные, полученные из исходных таблиц базы данных на определенном этапе запроса.
- Группа элементов, объединенных в один блок — вложенные запросы, объединения либо временные таблицы.
- Серый цвет блока — конечная выборка.
- Пунктирные стрелки — вид соединения таблиц.
- Сплошные стрелки — связь временных таблиц с таблицами, которые используются при выборке в пакете запроса.
В данном режиме пользователь имеет возможность сохранить диаграмму в виде svg‑рисунка, а также получить текст диаграммы на языке PlantUML.
Важно! Построение диаграммы выполняет сервис PlantUML, развернутый на сервере компании «1С‑Рарус». Требуется наличие интернет‑соединения.
Подробнее о возможностях сервиса PlantUML можно прочитать в статье «Конструктор диаграмм PlantUML».
- Интерактивные графы — с помощью библиотеки Vis.js. В данном режиме используется специализированная библиотека визуализации графов и сетей. Библиотека Vis.js исполняется на локальном компьютере и не требует интернет‑соединения. Может обрабатывать большие объемы данных и поддерживает интерактивное взаимодействие с отображаемыми объектами. Подробнее о возможностях этой библиотеки можно прочитать в статье «Библиотеки визуализации Vis.js и Pixi.js — хитрости и советы по созданию форм 1С».
В отличие от PlantUML, при помощи библиотеки Vis.js можно создавать диаграммы с интерактивным взаимодействием:
- перемещать блоки.
- группировать и разворачивать вложенные запросы.
- получать подсказки с текстом подзапроса по узлу или ветви связи при наведении курсора на соответствующий блок диаграммы (при двойном клике по такому блоку открывается отдельное окно с полным текстом подзапроса).
В этом варианте на диаграмме отображаются следующие элементы:
- Блоки бледно‑зеленого цвета — исходные таблицы базы данных.
- Значком
обозначается конечная выборка. - Оранжевые блоки — временные таблицы.
- Бирюзовый овал — объединение.
- Блоки розового цвета — либо вложенные запросы, либо подзапросы из операции объединения, либо места выборки данных из временной таблицы.
- Стрелки между блоками демонстрируют получение данных из таблиц:
- Черные — какие элементы схемы объединяются во вложенный запрос, пакет запроса, временную таблицу.
- Зеленые — в каком запросе используется временная таблица.
- Красные дуги — вид соединения таблиц.
Оба варианта визуализации решают одну задачу разными способами. Выбор между классической диаграммой PlantUML и интерактивным графом Vis.js зависит от конкретных целей анализа запроса.
Ограничения
Инструмент умеет работать с запросами, которые не предназначены для исполнения в текущей базе 1С. Для того чтобы такой запрос можно было преобразовать в объектную модель, он предварительно корректируется. На текущий момент некоторые особенности в тексте запроса не поддерживаются.
- Все таблицы должны изменить синонимы. Обращения к полям таблиц должно происходить через их синоним. Запросы, созданные через конструктор запросов, полностью удовлетворяют этому требованию.
- Соединение вида «декартово произведение» поддерживается только с Константами.
Условия использования инструментов «1С‑Рарус»
Команда разработки «1С‑Рарус» приглашает к обсуждению инструментов и пожеланий к их развитию на форум «1С‑Рарус». Обращения можно направлять на электронный почтовый ящик instruments@rarus.ru. Все желающие могут принять участие в развитии и сопровождении инструментов: github.com/rarus/dataeditor/blob/main/CONTRIBUTING.md.
Следите за публикацией новых инструментов.
об инструменте «1С-Рарус»
.jpg)
