Назначение и основные возможности: Команда СУБД

Объект «Команда СУБД» предназначен для выполнения следующих операций с объектами базы данных репозитория:

В отличие от процедур при создании в репозитории команды СУБД никаких дополнительных объектов на сервере не создается.

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

Для сохранения настроек в мастере команды СУБД:

Работа с командой СУБД

Для запуска команды СУБД выполните одно из действий:

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

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

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

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

Результатом работы команды СУБД является количество обработанных записей.

Примечание. Команда СУБД запускается в рамках транзакции, которую создает платформа. Это необходимо учитывать в скрипте, использующем пользовательские транзакции.

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

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

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

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

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

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

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

Редактирование команды СУБД в веб-приложении

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

Откроется окно редактирования команды СУБД:

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

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

Примечание. При указании текста команды учитывайте различия языка SQL, которые используются в реализациях различных СУБД.

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

Для выполнения команды нажмите кнопку «Выполнить запрос». Результатом работы команды СУБД является количество обработанных записей.

Для переименования команды СУБД:

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

Для сохранения команды СУБД:

нажмите кнопку «Сохранить»;
подтвердите производимое действие в информационном окне при переходе в навигатор объектов/мастер команды СУБД.