Выполнение пакета служб SSIS из Visual Studio Code с помощью Transact-SQL

Статья
05/23/2023

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

В этом кратком руководстве демонстрируется использование Visual Studio Code для подключения к базе данных каталога SSIS и последующее использование инструкций Transact-SQL для запуска пакета служб SSIS, хранящегося в каталоге SSIS.

Visual Studio Code — это редактор кода для Windows, macOS и Linux, который поддерживает расширения, в том числе расширение mssql для подключения к Microsoft SQL Server, Базе данных SQL Azure или Azure Synapse Analytics. Дополнительные сведения о Visual Studio Code см. на странице Visual Studio Code.

Необходимые компоненты

Прежде чем приступить к работе, нужно установить последнюю версию Visual Studio Code и загрузить расширение mssql. Скачать эти средства можно на следующих страницах:

Поддерживаемые платформы

Сведения, приведенные в этом кратком руководстве, можно использовать для выполнения пакета SSIS на следующих платформах:

SQL Server в Windows.
База данных SQL Azure. Дополнительные сведения о развертывании и запуске пакетов в Azure см. в разделе Перенос рабочих нагрузок SQL Server Integration Services в облако.

Сведения, приведенные в этом кратком руководстве, не могут быть использованы для выполнения пакета SSIS в Linux. Дополнительные сведения о запуске пакетов на Linux см. в разделе Извлечение, преобразование и загрузка данных в Linux с помощью служб SSIS.

Выбор языкового режима SQL в Visual Studio Code

Чтобы иметь возможность выполнять команды mssql и пользоваться технологией IntelliSense для T-SQL, выберите в Visual Studio Code языковой режим SQL.

Откройте редактор Visual Studio Code, а затем откройте новое окно.
В правом нижнем углу строки состояния щелкните Обычный текст.
В открывшемся меню Выберите языковой режим выберите или введите SQL, а затем нажмите клавишу ВВОД, чтобы установить языковой режим SQL.

Получение сведений о подключении для базы данных SQL Azure

Для запуска пакета в базе данных SQL Azure вам нужны сведения, необходимые для подключения к базе данных каталога служб SSIS (SSISDB). В описанных ниже процедурах вам потребуется полное имя сервера и имя для входа.

Войдите на портал Azure.
Выберите Базы данных SQL в меню слева, а затем на странице Базы данных SQL — базу данных SSISDB.
На странице Обзор для базы данных просмотрите полное имя сервера. Чтобы увидеть параметр Щелкните, чтобы скопировать, наведите указатель мыши на имя сервера.
Если вы забыли данные для входа на сервер Базы данных SQL Azure, перейдите на соответствующую страницу, чтобы просмотреть имя администратора сервера. При необходимости вы можете сбросить пароль.

Подключение к базе данных каталога SSIS

С помощью Visual Studio Code установите соединение с каталогом служб SSIS.

Внимание

Прежде чем продолжить, необходимо подготовить сведения о сервере, базе данных и имени для входа. Если вы переключитесь из окна Visual Studio Code на другое окно после того, как начнете вводить сведения о профиле подключения, процедуру создания профиля придется начать сначала.

В Visual Studio Code нажмите клавиши CTRL+SHIFT+P (или F1), чтобы открыть палитру команд.
Введите sqlcon и нажмите клавишу ВВОД.
Нажмите клавишу ВВОД, чтобы выбрать команду Создать профиль подключения. На этом шаге создается профиль подключения для экземпляра SQL Server.

Следуя указаниям, настройте свойства подключения для нового профиля подключения. После указания каждого значения нажимайте клавишу ВВОД, чтобы продолжить.

Параметр	Предлагаемое значение	Дополнительная информация
Имя сервера	Полное имя сервера	При подключении к серверу базы данных SQL Azure используйте следующий формат имени: `<server_name>.database.windows.net`.
Имя базы данных	SSISDB	Имя базы данных, с которой необходимо установить соединение.
Аутентификация	имя для входа SQL	Используйте проверку подлинности SQL Server для подключения к SQL Server или к базе данных SQL Azure. Если вы подключаетесь к серверу базы данных SQL Azure, вы не можете использовать проверку подлинности Windows.
Имя пользователя	Учетная запись администратора сервера	Это учетная запись, которая была указана при создании сервера.
Пароль (имя входа SQL)	Пароль для учетной записи администратора сервера	Это пароль, который был указан при создании сервера.
Сохранить пароль?	"Да" или "Нет"	Чтобы каждый раз вводить пароль, выберите "Да".
Введите имя для этого профиля	Имя профиля, например mySSISServer	Сохранив имя профиля, можно будет быстрее подключаться при последующих операциях входа в систему.

Чтобы закрыть информационное сообщение о том, что профиль создан и подключен, нажмите клавишу ESC.
Проверьте состояние подключения в строке состояния.

Выполнение кода T-SQL

Чтобы запустить пакет SSIS, выполните приведенный ниже код Transact-SQL.

В окне Редактор введите указанный ниже запрос в пустом окне запроса. (Этот код создается параметром Скрипт в диалоговом окне Выполнение пакета в SQL Server Management Studio.)
Обновите значения параметров в хранимой процедуре catalog.create_execution так, чтобы они соответствовали вашей системе.
Чтобы выполнить код и запустить пакет, нажмите клавиши CTRL+SHIFT+E.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx',
    @execution_id=@execution_id OUTPUT,
    @folder_name=N'Deployed Projects',
	  @project_name=N'Integration Services Project1',
  	@use32bitruntime=False,
	  @reference_id=Null
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,
    @object_type=50,
	  @parameter_name=N'LOGGING_LEVEL',
	  @parameter_value=@var0
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

Следующие шаги

Рассмотрите другие варианты выполнения пакета.

Поделиться через