SQL
сценарий
Элемент конфигурации «SQL сценарий» представляет собой схему, содержащую SQL‑код и предназначенную для выполнения операций на уровне базы данных приложения. Такой сценарий используется для создания и модификации объектов базы данных (например, таблиц, индексов, представлений, процедур), а также для выполнения операций по добавлению, изменению и удалению данных. Код SQL‑сценария может включать любые конструкции SQL, поддерживаемые выбранной СУБД.
Выполнение сценария происходит автоматически в процессе установки или удаления пакета в соответствии с заданным типом установки, что обеспечивает применение необходимых изменений к базе данных совместно с изменениями конфигурации приложения.
Создание SQL-сценария
Алгоритм создания SQL-сценария:
- Откройте раздел «Конфигурация».
- Выберите пользовательский пакет, в который хотите добавить SQL-сценарий.
- На панели инструментов рабочей области раздела «Конфигурация» из списка «Добавить» выберите схему «SQL сценарий».
Рисунок 1 — Создание схемы «SQL сценарий»
- В появившемся окне заполните следующие свойства:
- Код — название схемы;
- Тип СУБД – выберите тип базы данных, для которой создается SQL-сценарий. Если необходимо создать приложение, которое может устанавливаться на среды с различными типами баз данных, то необходимо создать SQL-сценарий под каждый тип базы данных. При установке или удалении пакета будут установлены сценарии соответствующие типу базы данных используемой на текущей среде;
- Тип установки — выберете тип установки SQL-сценария из списка:
- BeforePackage — установка будет выполнена в начале установки пакета, перед обновлением структуры базы данных (перед установкой объектов пакета);
- AfterPackage — установка будет выполнена после установки объектов пакета;
- AfterSchemaData — установка будет выполнена после установки объектов пакета и установки элементов пакета с типом «Данные»;
- UninstallApp — установка будет выполнена при удалении пакета.
Рисунок 2 — Свойства схемы «SQL сценарий»
- Если необходимо, вы можете задать зависимость от других SQL-сценариев. Эти сценарии будут выполнены до установки текущего сценария. Это позволяет сформировать порядок выполнения SQL-сценариев и сохранить правильную структуру базы данных.
- В дизайнере SQL-сценария добавьте SQL-код. Используйте синтаксис и команды для выбранного при создании SQL-сценария типа базы данных. Для проверки кода на синтаксическую корректность нажмите «Проверка».
- Нажмите «Сохранить».
SQL-сценарии, добавленные в пакет будут автоматически выполнены при установке или удалении пакета через раздел «Установка и удаление приложений» в соответствии с выбранным типом установки. Вы также можете установить сценарий вручную, выбрав в Конфигурации в контекстном меню «Установить».