DaJet Studio: расширенный язык запросов 1С, очереди сообщений и web сервисы

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

Администрирование - Администрирование СУБД

Дмитрий Жичкин (zhichkin)

Рейтинг: 851

язык запросов SQL очереди сообщений web сервисы DaJet интеграция обмен данными свертка данных конвертация оптимизация производительности

–

DaJet Studio - разработка и управление скриптами, хранимыми процедурами и функциями, написанными на расширенном языке запросов 1С, а также очередями сообщений и web сервисами, основанными на использовании Microsoft SQL Server.

DaJet Studio является инструментом, позволяющим использовать сервис-ориентированную архитектуру для баз данных (Service Oriented Database Architecture), которая была впервые реализована и представлена Microsoft в СУБД SQL Server 2005.

Основной упор был сделан на использование языка запросов SQL, модифицированного таким образом, чтобы его можно было использовать в контексте платформы 1С:Предприятие 8. При этом доступно использование всего функционала T-SQL, включая версию SQL Server 2016.

DaJet Studio является продолжением и развитием таких публикаций как:

1C# – 1С моей мечты

DaJet QL - расширяемый язык запросов

DaJet MQ - надёжный обмен данными

JSON в запросах DaJet QL

Использование таблиц SQL Server в качестве очередей сообщений

Репозиторий исходного кода проекта на GitHub: https://github.com/zhichkin/DaJet

В текущей версии проект имеет качество прототипа. Весь заявленный функционал реализован и "размазан" по вышеуказанным публикациям. Целью проекта DaJet Studio является собрать всё это в едином инструменте.

Видео инструкция для начала работы с DaJet Studio на YouTube.

Канал Телеграмм для обсуждения и предложений: https://t.me/dajet_studio

DaJet Studio - краткая инструкция

1. Установка приложения.

Проект скомпилирован для Windows x64.

Установка платформы 1С:Предприятие 8 не нужна.

Требуется установка Microsoft .NET Core 3.1 или выше.

Распаковать zip архив в любой каталог. Выполнить запуск DaJet.Studio.exe.

2. Подключение сервера SQL Server.

Контекстное меню узла "SQL servers", команда "Add server".

3. Подключение базы данных 1С.

Контекстное меню узла ранее добавленного сервера SQL Server, команда "Add database".

Нужно подождать, особенно если конфигурация 1С содержит большое количество объектов метаданных. При подключении базы данных 1С выполняется чтение метаданных 1С напрямую из её SQL базы данных: таблицы Params и Config. Для УТ или БП это может занять около 30 секунд. Метаданные кэшируются в оперативной памяти. Для УТ или БП это составляет приблизительно 100 Мб.

4. Создание и редактирование скриптов, функций и хранимых процедур.

Контекстное меню узла "Scripts" базы данных 1С, команда "Add new script". После сохранения скрипта для него создаётся узел в дереве метаданных DaJet Studio. Чтобы его переименовать нужно просто изменить название узла скрипта. Для этого узел скрипта нужно выделить и нажать один раз на нём левой кнопкой мыши (или нажать F2). Наименование скрипта станет доступным для редактирования. Для завершения редактирования необходимо нажать клавишу ENTER или выделить левой кнопкой мыши любой другой узел.

Создание и редактирование функций и хранимых процедур базы данных выполняется аналогичным образом в соответствующих им узлах дерева метаданных DaJet Studio.

Файлы скриптов, функций и хранимых процедур хранятся в каталоге scripts приложения DaJet Studio (смотри каталог bin).

5. Команды контекстного меню скриптов.

Execute script - выполняет скрипт в контексте базы данных скрипта.

Edit script - открывает скрипт для редактирования.

Show SQL code - показывает T-SQL код скрипта, который будет выполнен в базе данных.

Show syntax tree - показывает синтаксическое дерево T-SQL кода скрипта.

Delete script from file system - удаляет файл скрипта с жёсткого диска компьютера.

6. Команды контекстного меню функций и хранимых процедур.

То же самое, что и для скриптов, плюс две команды:

Create script in database - создаёт функцию или процедуру в базе данных SQL Server.

Delete script in database - удаляет функцию или процедуру в базе данных SQL Server.

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

7. Команды контекстного меню узла базы данных.

Edit database settings - открывает окно редактирования настроек подключения к базе данных SQL Server (как команда "Add database" узла сервера SQL Server).

Read DBNames - читает и открывает для просмотра данные файла DBNames таблицы Params метаданных 1С.

Save DBNames to file - читает и сохраняет данные файла DBNames таблицы Params метаданных 1С в указанный пользователем файл txt.

Remove database from the list - удаляет базу данных из дерева метаданных DaJet Studio и файла настроек программы metadata-settings.json, который расположен в каталоге metadata приложения (смотри каталог bin). База данных остаётся на сервере SQL Server в целости и сохранности, в будущем её можно подключить повторно.

8. Команды контекстного меню узла объекта метаданных.

Read config file - читает и открывает для просмотра данные файла объекта метаданных 1С, которые хранятся в таблице Config. Команда доступна для справочников, документов, регистров и т.п.

9. Перетаскивание имён объектов метаданных в скрипт.

Для удобства набора кода скриптов реализовано перетаскивание (drag-and-drop) узлов объектов метаданных 1С из дерева метаданных DaJet Studio в поле текста скрипта. Это касается общих узлов как, например, "Справочник", узлов объектов метаданных и их реквизитов.

DaJet web server - краткая инструкция

1. Установка web сервера.

Проект скомпилирован для Windows x64.

Установка платформы 1С:Предприятие 8 не нужна.

Требуется установка Microsoft .NET Core 3.1 или выше.

Распаковать zip архив в любой каталог. Выполнить запуск DaJet.Http.dll при помощи файла run-web-server.bat

После запуска web сервера управление им выполняется из DaJet Studio. Можно также использовать Postman или любой другой http-клиент. Описание API web сервера будет опбуликовано немного позже.

2. Подключение web сервера.

Контекстное меню узла "HTTP services", команда "Add web server". Нужно указать произвольное наименование сервера, а также адрес, по которому работает web сервер. Адрес web сервера настраивается в файле appsettings.json, расположенном в корневом каталоге web сервера. По умолчанию это 2 адреса: http://localhost:5000 и https://localhost:5001.

3. Публикация скрипта на web сервере.

Контекстное меню узла скрипта в иерархии узла "SQL servers", команда "Deploy script to web server". Будет предложен выбор web сервера из списка доступных серверов узла "HTTP services". В случае успешного добавления будут сформированы соответствующие узлы для сервера баз данных, базы данных и скрипта. Если база данных публикуется на web сервере впервые, то необходимо подождать, так как web сервер должен будет инициализировать метаданные 1С для интерпретации и выполнения скриптов.

4. Выполнение скрипта из DaJet Studio.

Контекстное меню узла скрипта в иерархии узла "HTTP services", команда "Execute script at web server". Скрипт будет выполнен в соответствующей базе данных при посредничестве web сервера. Результат будет выведен во вновь созданную закладку правой панели DaJet Studio.

5. Выполнение скрипта при помощи Postman.

Для получения URL скрипта, который был опубликован на web сервере, нужно выполнить команду "Show script URL" контекстного меню узла скрипта в иерархии узла "HTTP services". URL и возможные параметры для передачи скрипту будут показаны во вновь созданной закладке правой панели DaJet Studio. Параметры определяются в самом скрипте при помощи инструкций T-SQL DECLARE. Параметры передаются в скрипт через web вызов скрипта в виде JSON объекта в теле запроса. При этом те значения параметров, которые указаны в скрипте будут переопределены значениями из тела web запроса.

6. Обновление скрипта на web сервере.

Редактируем скрипт в иерархии узла "SQL servers". Сохраняем изменения. Проверяем его работу в базе данных. Выполняем контекстную команду узла скрипта "Update script at web server" в иерархии узла "HTTP services".

Важно!

Скрипты в иерархии узлов "SQL servers" и "HTTP services" синхронизируются между собой по наименованию! Надёжнее всего при повторной публикации скрипта на web сервере сначала его оттуда удалить при помощи контекстной команды "Delete script from web server" узла скрипта в иерархии узла "HTTP services", а затем повтороно выполнить команду согласно пункту 3 данной инструкции.

Если наименования скриптов не менялись, то обновление скрипта (update) работает без проблем.

В данный момент поддерживается работа со справочниками, документами, регистрами сведений и накопления. Добавление возможности работы с другими объектами метаданных 1С будет реализовываться по мере возможностей автора DaJet Studio.

Работа с очередями SQL Server возможна при помощи материалов публикаций, указанных выше. Работа с очередями непосредственно из DaJet Studio будет реализована в последующих версиях.

Изменение от 07.01.2021

Добавил подсистему DaJet Exchange для 1С:Предприятие 8.

Кратко суть:

1. Интегрируемая конфигурация 1С объединяется с конфигурацией DaJetExchange.cf.

2. Создаётся файл настроек dajet-exchange-settings.json, который управляет регистрацией изменений в интегрируемой конфигурации.

3. Все изменения попадают в справочник - очередь исходящих сообщений DaJetExchangeQueue.

4. Регистрация изменений работает очень быстро и без блокировок СУБД.

5. Сообщения сериализуются в JSON.

6. Внешняя система забирает сообщения из очереди исходящих сообщений.

7. Внешняя система берёт на себя всю логику обработки и маршрутизации сообщений по узлам РИБ, если они есть, или в адрес других информационных систем.

–

Скачать файлы

Наименование	Файл	Версия	Размер
DaJet Studio v0.2 .zip 6,60Mb 25	.zip	0.2	6,60Mb	25	Скачать бесплатно
DaJet web server v0.1 .zip 44,26Mb 12	.zip	0.1	44,26Mb	12	Скачать бесплатно
DaJet Exchange Agent 1.0 .zip 31,69Mb 0	.zip	1.0	31,69Mb		Скачать бесплатно

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

Комментарии

В избранное Подписаться на ответы

Свернуть все

1. Rustig 1638 12.11.20 15:34 Сейчас в теме

(0) видео снимите пож-та, что это такое?

2. zhichkin 851 13.11.20 23:16 Сейчас в теме

(1) Обязательно сниму, только немного позже. Ссылки добавлю в текст публикации.

3. zhichkin 851 14.11.20 18:55 Сейчас в теме

(1) Добавил ссылку на видео инструкцию и краткое описание того, что умеет делать DaJet Studio.

4. Asmody 01.12.20 00:23 Сейчас в теме

Проект, несомненно, интересный. Был бы, если бы работал не только на компьютере автора.

5. zhichkin 851 01.12.20 11:46 Сейчас в теме

(4) Что конкретно у Вас не получилось ? Напишите - помогу запустить и на Вашей машине.
На моей машине установлено следующее ПО:
1. Windows 10 Pro 20H2
2. SQL Server 2014 Developer Edition
3. SQL Server 2016 Express
4. 1С:Предприятие 8.3 (8.3.15.1534)
5. .NET Core 3.1
Платформа: win-x64

6. Asmody 01.12.20 21:56 Сейчас в теме

(5) WinServer 2012, SQL 2008R2, 1Сок маленький зоопарк: 8.1 и 3 релиза 8.3, NET Core свежескаченный 3.1

Если не указывать в свойствах сервера БД имя пользователя, то при добавлении базы выходит сообщение "список выбора баз пуст", если указать имя пользователя, то при добавлении базы выходит appcrash.

На WinServ 2008R2 аналогичное поведение.

7. zhichkin 851 02.12.20 09:25 Сейчас в теме

(6)
1. У меня на SQL Server настроена Windows аутентификация. Честно скажу, что SQL Server аутентификацию особо не тестировал.

2. Список баз получается следующим запросом:
SELECT [name] FROM [sys].[databases] WHERE [owner_sid] > 0x01 ORDER BY [name] ASC;
Если Вам программа говорит, что "список баз пуст", то это значит, что нет прав на [sys].[databases], хотя это очень странно, так как согласно документации Microsoft: "По умолчанию роль public имеет VIEW ANY DATABASE разрешение, что позволяет всем именам входа просматривать сведения о базе данных."

3. appcrash - печаль =( Я честно признался, что "В текущей версии проект имеет качество прототипа." Обработка ошибок сделана прямо скажу не лучшим образом.

4. Попробуйте настроить Windows аутентификацию на SQL Server, чтобы понять насколько DaJet Studio вообще Вам нужна.

Если решите использовать DaJet на продакшене, то потребуются некоторые доработки. Обработка ошибок и логирование это некоторые из них. Кроме этого, очень вероятно, что потребуется сопровождение продукта, так как самостоятельно копаться в исходниках, тем более на C#, не всем удобно или хочется.

К сожалению, на текущем месте работы у меня нет возможности использовать DaJet в производственном или тестовом контурах. Обратной связи от сообщества, тех кто скачивает дистрибутивы, у меня тоже нет. В совокупности, это означает для меня, что практическая ценность DaJet низкая. Это лишает мотивации развивать продукт. Я выложил свои наработки "как есть", чтобы просто не забылись и не потерялись. Я уверен, что в будущем, лет через 10-15, они будут широко востребованы в среде 1С.

8. Asmody 02.12.20 12:46 Сейчас в теме

WHERE [owner_sid] > 0x01 в этом причина.
У меня у всех баз owner sa.
Знаю, что идеологически неправильно, но "так исторически сложилось".

Оставьте свое сообщение

E-mail:

Скачать файлы

Статистика:

Просмотры 2568

Загрузки 37

Рейтинг 15

Комментарии 8

Создание 10.11.20 08:00

Обновление 22.01.21 15:51

№ Публикации 1323827

Характеристики:

Рубрики Прочие инструменты разработчика Администрирование СУБД

Кому Программист

Тип файла Архив с данными

Платформа Платформа 1С v8.3

Конфигурация Не имеет значения

Операционная система Windows

Страна Не имеет значения

Отрасль Не имеет значения

Налоги Не имеет значения

Вид учета Не имеет значения

Доступ к файлу Бесплатно (free)

Код открыт Да

Посмотреть все

См. также

DaJet Exchange: обмен данными с 1С (часть 1)

Внешние источники данных v8 Бесплатно (free)

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

11.01.2021 1827 zhichkin 14

Микро сервис для работы с запросами SQL

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

Альтернатива COM соединению с SQL базой, обработка запроса.

13.12.2020 3478 37 ivan1703 14

Графит. Правщик 1С морд от kuzkov.info.2

Прочие инструменты разработчика v8 Бесплатно (free)

Вторая часть записок о разработке программы Графит, векторного правщика для быстрого рисования 1С морд. Обзор сделанного в виде текста описания, гифках и приложенных svg файлах для пощелкать в обозревателе.

02.12.2020 1335 13 Steelvan 4

Файл тестов для xUnitFor1C: тестирование проведения документов

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

Тестирование проведения документов. Проверяется, что: а) документ проводится; б) движения документа после перепроведения не изменились.

30.06.2020 4118 37 q_i 16

DaJet MQ - надёжный обмен данными

Обмен данными 1С Интеграция v8 Платные (руб)

DaJet MQ – это асинхронный обмен сообщениями, основанный на компоненте Service Broker ядра Microsoft SQL Server. Простой, эффективный, надёжный. Отлично справляется с сообщениями любого размера. Максимальный размер одного сообщения равен 2 Гб.

12000 руб.

16.06.2020 2840 0 12

Нейроконструктор

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

Изучайте нейронные сети и экспериментируйте вместе с расширением конфигурации "Нейроконструктор". Навыки программирования не требуются.

20.05.2020 9885 131 user1404129 19

Загрузка, редактирование и установка цветовых схем (раскраски кода) в Конфигуратор и EDT

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

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

14.05.2020 7501 218 CyberCerber 31

DaJet QL - расширяемый язык запросов

Интеграция WEB v8 Абонемент ($m)

DaJet QL поддерживает практический полный синтаксис SQL Server 2005-2016. Кроме этого это расширяемый язык запросов. Обращение к объектам СУБД выполняется в терминах метаданных 1С. Доступ к возможностям этого языка запросов реализован в виде web api сервиса. Результаты запросов возвращаются в виде JSON.

1 стартмани

20.04.2020 7888 11 zhichkin 16

Универсальные инструменты 1С

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

Свободно распространяемый набор универсальных обработок и отчетов в виде расширения для разработки и поддержки, которое работает во ВСЕХ видах клиентских приложений и во всех операционных системах, которые поддерживает платформа 1С:Предприятие, кроме мобильных. Консоль запросов - консоль отчетов - консоль кода - редактор объектов базы данных - удаление помеченных объектов - поиск и удаление дублей - редактор констант - консоль заданий - групповая обработка справочников и документов - динамический список - поиск ссылок на объект - регистрация изменений для обмена данными - структура хранения базы - консоль HTTP запросов-консоль вебсервисов- консоль сравнения данных- информация о лицензиях- загрузка из табличного документа-файловый менеджер-все функции- навигатор по конфигурации-конструктор регулярных выражений-Выгрузка загрузка XML с фильтрами

21.01.2020 33205 1917 cprit 103

Пример работы с SQLDMO

Администрирование СУБД v8 Бесплатно (free)

SQLDMO из 1С.

27.06.2013 4345 28 imm0rtal 2