Запуск пакетов служб SSIS с помощью агента Управляемого экземпляра SQL Azure

Статья
07/17/2023

Область применения:Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

В этой статье описывается, как запустить пакет служб интеграции SQL Server (SSIS) с помощью агента Управляемого экземпляра SQL Azure. Эта функция обеспечивает поведение, аналогичное запуску пакетов служб SSIS по расписанию с помощью агента SQL Server в локальной среде.

С ее помощью можно запускать пакеты служб SSIS, хранящиеся в SSISDB внутри Управляемого экземпляра SQL, в файловой системе (например, в Файлах Azure) или в хранилище пакетов среды выполнения интеграции Azure-SSIS.

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

Чтобы использовать эту функцию, скачайте и установите последнюю версию SQL Server Management Studio (SSMS). Сведения о поддержке версий приведены ниже:

чтобы запускать пакеты из SSISDB или файловой системы, установите SSMS версии 18.5 или более поздней;
чтобы запускать пакеты из хранилища пакетов, установите SSMS версии 18.6 или более поздней.

Необходимо также подготовить среду выполнения интеграции Azure-SSIS с помощью Фабрики данных Azure. Он использует Управляемый экземпляр SQL в качестве сервера конечных точек.

Запуск пакета служб SSIS из SSISDB

В этой процедуре производится запуск пакета служб SSIS, хранящегося в SSISDB, с помощью агента Управляемого экземпляра SQL.

Подключитесь к Управляемому экземпляру SQL в последней версии SSMS.
Создайте задание агента и первый шаг задания. В разделе Агент SQL Server щелкните правой кнопкой мыши папку Задания и выберите команду Создать задание.
На странице Создание шага задания выберите тип Пакет служб SQL Server Integration Services.
На вкладке Пакет выберите Каталог служб SSIS в качестве расположения пакета.
Поскольку SSISDB располагается в Управляемом экземпляре SQL, задавать проверку подлинности не нужно.
Укажите конкретный пакет служб SSIS, хранящийся в SSISDB.
На вкладке Конфигурация вы можете:
- задавать значения параметров в разделе Параметры;
- переопределять значения в разделе Диспетчеры подключений;
- переопределять свойства и выбирать уровень ведения журнала в разделе Дополнительно.
Нажмите кнопку ОК, чтобы сохранить конфигурацию задания агента.
Запустите задание агента, чтобы запустить пакет служб SSIS.

Запуск пакета служб SSIS из файловой системы

В этой процедуре производится запуск пакета служб SSIS, хранящегося в файловой системе, с помощью агента Управляемого экземпляра SQL.

Подключитесь к Управляемому экземпляру SQL в последней версии SSMS.
Создайте задание агента и первый шаг задания. В разделе Агент SQL Server щелкните правой кнопкой мыши папку Задания и выберите команду Создать задание.
На странице Создание шага задания выберите тип Пакет служб SQL Server Integration Services.
На вкладке Пакет:
1. В раскрывающемся списке Расположение пакета выберите вариант Файловая система.
2. Выберите Тип источника файла:
  - Если пакет выложен в Файлы Azure, выберите Общая папка Azure.
    
    Путь к пакету — \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.
    
    В разделе Учетные данные для доступа к файлу пакета введите имя и ключ учетной записи Файлов Azure для доступа к файлу. Домен задается как Azure.
  - Если пакет выложен в сетевую папку, выберите Сетевая папка.
    
    Путь к пакету — это UNC-путь к файлу пакета, включающий в том числе расширение DTSX.
    
    Введите домен, имя пользователя и пароль для доступа к файлу пакета в сетевой папке.
3. Если файл пакета зашифрован с помощью пароля, выберите Пароль для шифрования и введите пароль.
На вкладке Конфигурации введите путь к файлу конфигурации, если этот файл требуется для запуска пакета служб SSIS. Если вы храните конфигурацию в Файлах Azure, то путь к файлу конфигурации будет следующим: \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.
На вкладке Параметры выполнения можно выбрать, должна ли использоваться Проверка подлинности Windows или 32-разрядная среда выполнения для запуска пакета служб SSIS.
На вкладке Ведение журнала можно выбрать путь к журналу и учетные данные для доступа к журналу, которые будут использоваться для сохранения файлов журнала. По умолчанию путь к журналу совпадает с путем к папке пакета, а учетные данные для доступа к нему совпадают с учетными данными для доступа к пакету. Если вы храните журналы в Файлах Azure, путь к журналу будет следующим: \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>.
На вкладке Установленные значения можно ввести путь и значение тех или иных свойств, чтобы переопределить соответствующие свойства пакета.

Например, чтобы переопределить значение пользовательской переменной, введите путь к ней в следующем формате: \Package.Variables[User::<variable name>].Value.
Нажмите кнопку ОК, чтобы сохранить конфигурацию задания агента.
Запустите задание агента, чтобы запустить пакет служб SSIS.

Запуск пакета служб SSIS из хранилища пакетов

Примечание.

Хранилище пакетов не поддерживается в Azure-SSIS IR в Azure Synapse.

В этой процедуре производится запуск пакета SSIS, хранящегося в хранилище пакетов Azure-SSIS IR, с помощью агента Управляемого экземпляра SQL.

Подключитесь к Управляемому экземпляру SQL в последней версии SSMS.
Создайте задание агента и первый шаг задания. В разделе Агент SQL Server щелкните правой кнопкой мыши папку Задания и выберите команду Создать задание.
На странице Создание шага задания выберите тип Пакет служб SQL Server Integration Services.
На вкладке Пакет:
1. В раскрывающемся списке Расположение пакета выберите Хранилище пакетов.
2. Введите Путь к пакету:
  
  Путь к пакету — <package store name>\<folder name>\<package name>.
3. Если файл пакета зашифрован с помощью пароля, выберите Пароль для шифрования и введите пароль.
На вкладке Конфигурации введите путь к файлу конфигурации, если этот файл требуется для запуска пакета служб SSIS. Если вы храните конфигурацию в Файлах Azure, то путь к файлу конфигурации будет следующим: \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.
На вкладке Параметры выполнения можно выбрать, должна ли использоваться Проверка подлинности Windows или 32-разрядная среда выполнения для запуска пакета служб SSIS.
На вкладке Ведение журнала можно выбрать путь к журналу и учетные данные для доступа к журналу, которые будут использоваться для сохранения файлов журнала. По умолчанию путь к журналу совпадает с путем к папке пакета, а учетные данные для доступа к нему совпадают с учетными данными для доступа к пакету. Если вы храните журналы в Файлах Azure, путь к журналу будет следующим: \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>.
На вкладке Установленные значения можно ввести путь и значение тех или иных свойств, чтобы переопределить соответствующие свойства пакета.

Например, чтобы переопределить значение пользовательской переменной, введите путь к ней в следующем формате: \Package.Variables[User::<variable name>].Value.
Нажмите кнопку ОК, чтобы сохранить конфигурацию задания агента.
Запустите задание агента, чтобы запустить пакет служб SSIS.

Отмена выполнения пакета служб SSIS

Чтобы отменить выполнение пакета в задании агента Управляемого экземпляра SQL, выполните следующие действия, вместо того чтобы непосредственно останавливать задание агента.

Найдите значение jobID агента SQL в msdb.dbo.sysjobs.
По этому jobID найдите соответствующее значение executionId SSIS, используя следующий запрос:
```
select * from '{table for job execution}' where  parameter_value = 'SQL_Agent_Job_{jobId}' order by execution_id desc
```
Если пакеты служб SSIS хранятся в SSISDB, используйте таблицу ssisdb.internal.execution_parameter_values для выполнения задания. Если же пакеты служб SSIS хранятся в файловой системе, используйте для выполнения задания таблицу ssisdb.internal.execution_parameter_values_noncatalog.
Щелкните правой кнопкой мыши каталог SSISDB и выберите Активные операции.
Остановите операцию с найденным executionId.

Вы также можете планировать запуск пакетов служб SSIS с помощью Фабрики данных Azure. Пошаговые инструкции см. в статье "Создание триггера, запускающего конвейер в ответ на событие хранилища".