Назначение и основные возможности: Процедура

Объект «Процедура» позволяет создавать процедуры и функции для разных СУБД.

В отличие от команды СУБД при создании в репозитории объекта «Процедура» на сервере будет создана хранимая процедура/функция. Несколько процедур репозитория могут ссылаться на одну и ту же хранимую процедуру на сервере базы данных. Изменение текста хранимой процедуры отразится на всех объектах, ссылающихся на нее. Результатом работы процедуры может являться количество обработанных записей либо конкретное значение, если создана не процедура, а функция.

Примечание. Создание процедур/функций недоступно в СУБД SQLite из-за отсутствия данного типа объектов в указанной СУБД.

После выполнения одного из действий будет открыт мастер процедуры, содержащий страницы:

Для сохранения настроек в мастере процедуры:

Работа с процедурой

Для запуска выбранной процедуры выполните одно из действий:

в веб-приложении:

выполните команду «Открыть» в контекстном меню объекта.
выполните команду «Открыть в новой вкладке» в контекстном меню объекта;
выполните команду «Открыть в новом окне» в контекстном меню объекта;
дважды щёлкните по объекту;

в настольном приложении:

нажмите кнопку «Открыть» в группе «Открыть» на вкладке «Главная» ленты инструментов;
нажмите кнопку «Открыть > В инструменте по умолчанию» в группе «Открыть» на вкладке «Главная» ленты инструментов;
выполните команду «Открыть» в контекстном меню объекта;
дважды щелкните по объекту.

Для редактирования настроек процедуры выделите соответствующий объект в навигаторе объектов и выполните одно из действий:

в веб-приложении:

Откройте процедуру на редактирование.
Нажмите кнопку «Настройки»;

в настольном приложении:

нажмите кнопку «Редактировать» на вкладке «Главная» ленты инструментов;
выполните команду «Редактировать» в контекстном меню команды;
нажмите клавишу F4.

После выполнения одного из действий будет открыт мастер процедуры. Измените настройки на соответствующих страницах мастера.

Если репозиторий подключён к системе управления версиями, то процедура может быть добавлена в систему для контроля изменений её версии. Для этого в навигаторе объектов в контекстном меню для процедуры выполните команду «Добавить в VCS». После отправки объекта на сервер VCS будет возможность отслеживать его изменение. В системе управления версиями сохраняются текст процедуры и настройки параметров. Более подробно о работе с объектами, добавленными в систему управления версиями, читайте в подразделе «Разработка приложений в команде».

Редактирование процедуры в веб-приложении

Для открытия процедуры на редактирование выделите соответствующий объект в навигаторе объектов и выполните одно из действий:

Для изменения текста процедуры/функции используйте панель «Консоль запроса».

На панели отображается используемый драйвер СУБД и содержится текст процедуры/функции, заданный при её создании. Сформируйте новый текст на языке SQL в соответствии с синтаксисом, который установлен для драйвера СУБД.

Примечание. Если выбран драйвер PostgreSQL, первая строка скрипта должна содержать список параметров и этот список должен быть в одну строку.

Для установки указанного текста процедуры/функции для всех СУБД нажмите кнопку «Установить для всех СУБД». После чего будет открыто окно для подтверждения производимого действия. Запрос на подтверждение действия выдается только в том случае, если хотя бы для одного драйвера, отличного от текущего, текст процедуры/функции непустой.

Для обновления текста процедуры/функции из базы данных нажмите кнопку «Загрузить из БД». При нажатии на данную кнопку будет выдано подтверждение на производимое действие. При выборе положительного ответа текст процедуры/функции будет обновлен из базы.

Для выполнения текста процедуры нажмите кнопку «Выполнить запрос».

Для переименования процедуры:

Щёлкните по наименованию процедуры в области «Базовые настройки». Наименование будет переведено в режим редактирования.
Внесите требуемые изменения.
Щёлкните за пределами наименования процедуры.