Оценить проект Попробовать бесплатно

Выполнение сконвертированных скриптов с помощью Запуска Целевого файла

В процессе миграции базы данных часто возникает необходимость проверить сконвертированный код непосредственно в целевой базе данных. Например, после просмотра или ручного редактирования сконвертированного объекта может потребоваться выполнить обновлённый скрипт, протестировать отдельный SQL-оператор или выполнить запрос к уже перенесённым объектам, не покидая Конвертум Мастер.

Функция "Запустить Целевой файл" позволяет выполнять сконвертированный SQL-код непосредственно из редакторе файлов в настроенной целевой базе данных и просматривать результаты выполнения в нижней панели. Благодаря этому просмотр кода, его редактирование, выполнение и анализ результатов можно выполнять непосредственно в одном рабочем пространстве Конвертум Мастер, что упрощает тестирование и диагностику сконвертированных объектов.

Примечание: в настоящее время функция "Запустить Целевой файл" доступна для сконвертированных скриптов, если в качестве целевой базы данных используется PostgreSQL и для проекта включена опция Конвертация c импортом.

Доступность запуска целевого файла

Кнопка "Запустить Целевой файл" отображается в редакторе файла при его открытии. Команда выполняет SQL-код в целевой базе данных с использованием подключения, настроенного в разделе Целевая Технология проекта миграции. Поэтому для выполнения скрипта должно быть доступно корректно настроенное подключение к целевой базе данных. Convertum_Screen1

Если опция Конвертация с импортом отключена, подключение к целевой базе данных для выполнения скрипта отсутствует, поэтому кнопка "Запустить Целевой файл" становится недоступна, как показано на скриншоте ниже: Convertum_Screen2 Таким образом исключается выполнение сконвертированного скрипта, если в проекте отсутствует активное подключение к целевой базе данных.

Выполнение сконвертированного скрипта

Чтобы выполнить сконвертированный SQL-код:

  1. Откройте необходимый сконвертированный объект в редакторе файлов.
  2. При необходимости просмотрите или отредактируйте полученный целевой код.
  3. Нажмите "Запустить Целевой файл".

Если в редакторе не выделен определённый фрагмент текста, Конвертум Мастер выполнит весь скрипт, содержащийся в текущем целевом файле. Для запуска также можно использовать горячие клавиши F5 или Ctrl+Enter для панели редактора, которая в данный момент находится в фокусе.

SQL-инструкции выполняются последовательно, в том порядке, в котором они расположены в скрипте.

Выполнение выбранного фрагмента SQL-кода

Для проверки необязательно выполнять весь сконвертированный файл. Если в редакторе выделен определённый фрагмент SQL-кода, кнопка запуска целевого файла выполнит только выбранный фрагмент. Это удобно, если необходимо проверить отдельный оператор, не выполняя остальную часть скрипта.

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

SELECT * FROM COURSES;

и выполнить только его. Convertum_Screen3

Функция "Запустить Целевой файл" особенно удобна для следующих задач:

  • проверки корректности сконвертированных SQL-операторов;
  • проверки наличия и доступности перенесённых объектов;
  • тестирования результатов, изменённых вручную после конвертации;
  • выполнения диагностических SELECT-запросов;
  • воспроизведения ошибки для конкретного участка сконвертированного скрипта.

Важно: Конвертум Мастер не запрашивает дополнительного подтверждения перед выполнением потенциально деструктивных операций. Такие команды, как DROP, DELETE или TRUNCATE, будут выполнены, если они входят в запускаемый скрипт или выделенный фрагмент. Поэтому перед запуском рекомендуется внимательно проверить выполняемый код.

Обработка ошибок выполнения

Если база данных не может выполнить переданный SQL-код, соответствующее сообщение об ошибке отображается в нижней панели. Запись о выполнении содержит статус операции и текст ошибки, возвращённый базой данных. Если СУБД дополнительно возвращает номер строки, позицию ошибки или другую диагностическую информацию, эти сведения также могут использоваться для определения проблемного участка скрипта. Например:

[02.10.2026 13:31:28] Duration: 40ms, Status: fail, ERROR:  relation "autonomous_event" does not exist
LINE 1: INSERT INTO AUTONOMOUS_EVENT (ID, VALUE)

Convertum_Screen4

Благодаря этому пользователь может просмотреть сконвертированный код, определить оператор, вызвавший ошибку, внести необходимые изменения непосредственно в файл, сохранить его и повторно выполнить без необходимости переходить во внешний клиент базы данных.

Типовой сценарий использования

Типовой процесс работы с запуском целевого файла выглядит следующим образом:

  1. Выполните конвертацию объекта в PostgreSQL.
  2. Откройте его сгенерированный файл в редакторе файлов.
  3. Просмотрите полученный SQL-код.
  4. При необходимости внесите изменения.
  5. Выделите отдельный оператор либо оставьте код без выделения для выполнения всего скрипта.
  6. Нажмите "Запустить Целевой файл".
  7. Просмотрите результат выполнения или сообщение об ошибке в нижней панели.
  8. При необходимости исправьте SQL-код и повторите запуск.

Таким образом, кнопка "Запустить Целевой файл" предоставляет удобный механизм для быстрой проверки сконвертированного SQL-кода непосредственно во время миграции и снижает необходимость постоянно переключаться между Конвертум Мастер и внешними средствами работы с базой данных.

Связанные материалы

Если у вас возникли вопросы или сложности при работе с инструментом, обратитесь в нашу службу поддержки: support@convertum.ru

Содержание: