|
| 1 | +--- |
| 2 | +title: Migrate on-premises SQL Server Integration Services (SSIS) jobs to Azure Data Factory |
| 3 | +description: This article describes how to migrate SQL Server Integration Services (SSIS) jobs to Azure Data Factory pipelines/activities/triggers by using SQL Server Management Studio. |
| 4 | +services: data-factory |
| 5 | +documentationcenter: '' |
| 6 | +author: chugugrace |
| 7 | +ms.author: chugu |
| 8 | +ms.reviewer: |
| 9 | +manager: |
| 10 | +ms.service: data-factory |
| 11 | +ms.workload: data-services |
| 12 | + |
| 13 | +ms.topic: conceptual |
| 14 | +ms.date: 4/7/2020 |
| 15 | +--- |
| 16 | +# Migrate on-premises SSIS jobs to Azure Data Factory |
| 17 | + |
| 18 | +When [migrating on-premises SQL Server Integration Services (SSIS) workloads to SSIS in ADF](scenario-ssis-migration-overview.md), after SSIS packages are migrated, you can do batch migration of SQL Server Agent jobs with job step type of SQL Server Integration Services Package to Azure Data Factory (ADF) pipelines/activities/schedule triggers via SQL Server Management Studio (SSMS) **SSIS Job Migration Wizard**. |
| 19 | + |
| 20 | +In general, for selected SQL agent jobs with applicable job step types, **SSIS Job Migration Wizard** can: |
| 21 | + |
| 22 | +- map on-premises SSIS package location to where the packages are migrated to, which are accessible by SSIS in ADF. |
| 23 | + > [!NOTE] |
| 24 | + > Package location of File System is supported only. |
| 25 | +- migrate applicable jobs with applicable job steps to corresponding ADF resources as below: |
| 26 | + |
| 27 | +|SQL Agent job object |ADF resource |Notes| |
| 28 | +|---------|---------|---------| |
| 29 | +|SQL Agent job|pipeline |Name of the pipeline will be *Generated for \<job name>*. <br> <br> Built-in agent jobs are not applicable: <li> SSIS Server Maintenance Job <li> syspolicy_purge_history <li> collection_set_* <li> mdw_purge_data_* <li> sysutility_*| |
| 30 | +|SSIS job step|Execute SSIS package activity|<li> Name of the activity will be \<step name>. <li> Proxy account used in job step will be migrated as Windows authentication of this activity. <li> *Execution options* except *Use 32-bit runtime* defined in job step will be ignored in migration. <li> *Verification* defined in job step will be ignored in migration.| |
| 31 | +|schedule |schedule trigger |Name of the schedule trigger will be *Generated for \<schedule name>*. <br> <br> Below options in SQL Agent job schedule will be ignored in migration: <li> Second-level interval. <li> *Start automatically when SQL Server Agent starts* <li> *Start whenever the CPUs become idle* <li> *weekday* and *weekend day* <time zone> <br> Below are the differences after SQL Agent job schedule is migrated to ADF schedule trigger: <li> ADF Schedule Trigger subsequent run is independent of the execution state of the antecedent triggered run. <li> ADF Schedule Trigger recurrence configuration differs from Daily frequency in SQL agent job.| |
| 32 | + |
| 33 | +- generate Azure Resource Manager (ARM) templates in local output folder, and deploy to data factory directly or later manually. For more information about ADF Resource Manager templates, see [Microsoft.DataFactory resource types](https://docs.microsoft.com/azure/templates/microso.ft.datafactory/allversions). |
| 34 | + |
| 35 | +## Prerequisites |
| 36 | + |
| 37 | +The feature described in this article requires SQL Server Management Studio version 18.5 or higher. To get the latest version of SSMS, see [Download SQL Server Management Studio (SSMS)](https://docs.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver15). |
| 38 | + |
| 39 | +## Migrate SSIS jobs to ADF |
| 40 | + |
| 41 | +1. In SSMS, in Object Explorer, select SQL Server Agent, select Jobs, then right-click and select **Migrate SSIS Jobs to ADF**. |
| 42 | + |
| 43 | + |
| 44 | +1. Sign In Azure, select Azure Subscription, Data Factory, and Integration Runtime. Azure Storage is optional, which is used in the package location mapping step if SSIS jobs to be migrated have SSIS File System packages. |
| 45 | + |
| 46 | + |
| 47 | +1. Map the paths of SSIS packages and configuration files in SSIS jobs to destination paths where migrated pipelines can access. In this mapping step, you can: |
| 48 | + |
| 49 | + 1. Select a source folder, then **Add Mapping**. |
| 50 | + 1. Update source folder path. Valid paths are folder paths or parent folder paths of packages. |
| 51 | + 1. Update destination folder path. Default is relative path to the default Storage account, which is selected in step 1. |
| 52 | + 1. Delete a selected mapping via **Delete Mapping**. |
| 53 | + |
| 54 | + |
| 55 | + |
| 56 | +1. Select applicable jobs to migrate, and configure the settings of corresponding *Executed SSIS Package activity*. |
| 57 | + |
| 58 | + - *Default Setting*, applies to all selected steps by default. For more information of each property, see *Settings tab* for the [Execute SSIS Package activity](how-to-invoke-ssis-package-ssis-activity.md) when package location is *File System (Package)*. |
| 59 | +  |
| 60 | + - *Step Setting*, configure setting for a selected step. |
| 61 | + |
| 62 | + **Apply Default Setting**: default is selected. Unselect to configure setting for selected step only. |
| 63 | + For more information of other properties, see *Settings tab* for the [Execute SSIS Package activity](how-to-invoke-ssis-package-ssis-activity.md) when package location is *File System (Package)*. |
| 64 | +  |
| 65 | + |
| 66 | +1. Generate and deploy ARM template. |
| 67 | + 1. Select or input the output path for the ARM templates of the migrated ADF pipelines. Folder will be created automatically if not exists. |
| 68 | + 2. Select the option of **Deploy ARM templates to your data factory**: |
| 69 | + - Default is unselected. You can deploy generated ARM templates later manually. |
| 70 | + - Select to deploy generated ARM templates to data factory directly. |
| 71 | +  |
| 72 | + |
| 73 | +1. Migrate, then check results. |
| 74 | + |
| 75 | + |
| 76 | +## Next steps |
| 77 | + |
| 78 | +[Run and monitor pipeline](how-to-invoke-ssis-package-ssis-activity.md) |
0 commit comments