Using the Azure Files Destination Component

The Azure Files Destination component is an SSIS data flow pipeline component that can be used to write data to a File System. There are three pages of configuration:

  • General
  • Columns
  • Error Handling

The General page is used to specify general settings for the Azure Files Destination Component. The Columns page allows you to map the columns from upstream components to Azure Files fields in the destination object. The Error Handling page allows you to specify how errors should be handled when they occur. 

General page

The General page allows you to specify general settings for the component.

Azure Files Destination Editor

Connection Manager

The Connection Manager drop-down will show a list of connection managers that are available.

Storage Service Object

The object can be chosen between File or Directory.

Action

The Action specifies how you want to write to the instance specified in the selected Connection Manager. There are 4 actions available:

  • Create - Creates the File or Directory
  • Copy - Copy to the destination path
  • Append - Append to the Destination
  • Delete - Delete the object from the path
Map Unmapped Fields Button

By clicking this button, the component will try to map any unmapped attributes by matching their names with the input columns from upstream components.

Clear All Mappings Button

By clicking this button, the component will reset (clear) all your mappings in the destination component.

Expression fx Icon

Click the blue fx icon to launch SSIS Expression Editor to enable dynamic update of the property at run time.

Generate Documentation Icon

Click the Generate Documentation icon to generate a Word document which describes the component's metadata including relevant mapping, and so on.

Columns page

The Columns page of the Azure Files Destination Component allows you to map the columns from upstream components to the Azure Files fields.

In the Columns page, you would see a grid that contains four columns as shown below.

Azure Files Destination Editor

  • Input Column: You can select an input column from an upstream component for the corresponding Azure Files field.
  • Destination Field: The Azure Files field that you are writing data.
  • Data Type: This column indicates the type of value for the current field.
  • Unmap: This column can be used to unmap the field from the upstream input column, or otherwise it can be used to map the field to an upstream input column by matching its name if the field is not currently mapped.

Add button on the top of the grid opens a new window in which you can choose to add additional metadata fields as shown below.

Azure Files Destination - Add Meta

Error Handling page

The Error Handling page allows you to specify how errors should be handled when they happen.

Azure Files Destination Editor

There are three options available. 

  1. Fail on error
  2. Redirect rows to error output
  3. Ignore error

When the Redirect rows to error output option is selected, rows that failed to write to Azure Files will be redirected to the 'Error Output' output of the Destination Component. As indicated in the screenshot below, the blue output connection represents rows that were successfully written, and the red 'Error Output' connection represents rows that were erroneous. The 'ErrorMessage' output column found in the 'Error Output' may contain the error message that was reported by Azure Files or the component itself.

Error Output