Error Handling in SSIS

SSIS Error Handling : In SQL Server Integration Services, errors might occur when we are extracting data from a source, loading data into a destination, or when you are performing a transformation. It is because of the unexpected data, and failing the package is a bad practice. To handle these situations, SSIS introduced the concept called Error Handling. Let’s see how to configure Error Handling with an example.

For the SSIS demonstration purpose, we will Export data present in the Employee.xls to the SQL Server database table and configure error handling at Data Conversion. The below screenshot will show you the data present in the Employee Excel file

Employee Excel File

From the above screenshot, you can see that Occupation of EmpId 2, 13, 14 is larger than the length 255

Error Handling in SSIS Example

Drag and drop the data flow task from the toolbox to control flow and change the name to Error Handling.

Data Flow Task 2

Double click on it will open the Integration Service data flow tab. Now, Drag and drop Excel Source, Data Conversion Transformation, and OLEDB Destination from the toolbox into the data flow region.

Error Handling in SSIS 3

Double click on Excel source will open the connection manager settings and provides an option to select the table holding the source data. Here, we are choosing the Employees.xls file present in the file system.

Excel Source Connection 4

From the above screenshot, you can observe that we are selecting the Employee_Destination table present in the Employee.xls file

Excel Source Editor

Click ok and drag the blue arrow from Excel Source to Data Conversion Transformation. It allows the transformation to use the source data.

Next, please double click on the Data Conversion Transformation to edit and convert our source columns data type to the required data type with length.

Here we are leaving the Occupation length as 255 because we want to fail the package deliberately.

Data Conversion Transformation Editor 6

Now we have to provide the destination table details. So double-click on the OLE DB Destination and provide the required information. As you can see from the below, we selected the Duplicate Employee Error Handler table.

Choose OLE DB Database and Table 7

Click on the Mappings tab to check whether the source columns are exactly mapped to the destination columns.

Column Mapping 8

Click OK to close the above window.

Configure Error Handling in SSIS

Drag and drop another OLE DB destination to configure Error Handling to store the error output. Next, drag the Red line from Data Conversion (Error Output) to OLE DB Destination 1.

Error Handling in SSIS 9

Dragging the Error output on OLEDB Destination will open the following window. You have to use this window to configure the error handling. By default, all the columns are pointed to the Fail component property.

Error Handling in SSIS 10

Error Output provides three SSIS Error Handling options:

  • Fail Component: If there is an error, then the transformation, source, destinations, etc., will fail.
  • Ignore Failure: It will ignore the row’s failures.
  • Redirect Rows: It returns the successful rows to the specified destination and failed rows to failed output. It will not fail the task.

Please change the option to Redirect Row for both Errors and Truncation columns.

Error Handling in SSIS 11

Click OK to close the Configure Error Output window.

Error Handling in SSIS 12

Double-click on the OLE DB Destination1 will open the Destination Editor. For the time being, we are creating a new table using the New button.

Destination Table Editor 13

Click on the Mappings tab to verify whether the source columns exactly mapped to the destination columns or not.

Input and Destination Column Mapping 14

Click OK to finish configuring the OLE-DB destination. The below screenshot is the final SSIS Error Handling package.

Error Handling in SSIS 15

Let us run the Error Handling In SSIS package. As you can see from the below screenshot, it is redirecting 11 rows (successful) to OLE DB Destination and 3 rows to the error output.

Error Handling in SSIS 16

Please open the Management Studio to check the package result.

Errors or Issues Table 17

Next, open the second SQL table to check the records returned by the Error.

Destination Table 18

Comments are closed.