Help Manual - Azure Blob Storage Destination

Using the Azure Blob Storage Destination Component

The Azure Blob Storage Destination Component is an SSIS data flow pipeline component that can be used to write data to Azure Blob Storage. There are three pages of configuration:

• General
• Columns
• Error Handling

The General page is used to specify general settings for the Azure Blob Storage Destination Component. The Columns page is used to manage columns from the upstream component. 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.

Connection Manager

The Azure Blob Storage Destination Component requires a connection. The Connection Manager drop-down will show a list of connection managers that are available within the package.

Blob Service Object

The Blob Service Object drop-down displays a list of objects including:

• Container
  
• Blob - Block
• Blob - Page
• Blob - Append

Action

The Action specifies how you want to write to Azure Blob Storage specified in the selected Connection Manager. There are 3 Actions:

• Create: Creates records
  
• Update: Update records
  
• Delete: Delete records

Refresh Component Button

Clicking the Refresh Component button causes the component to retrieve the latest metadata and update each field to its most recent metadata.

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 Button

Clicking the fx button to launch SSIS Expression Editor to enable dynamic updates of the property at run time.

Generate Documentation Button

Clicking the Generate Documentation button to generate a Word document that describes the component's metadata including relevant mapping, and so on.

Columns Page

The Columns page of the Azure Blob Storage Destination Component allows you to map the columns from upstream components to the Azure Blob Storage Fields.

The Columns page displays a grid that contains four columns as shown below.

• Input Column: You can select an input column from an upstream component for the corresponding Azure Blob Storage Field.
  
• Destination Field: The Azure Blob Storage 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.
  
• Properties window for the field listed.
  
  • Name: the column name.
  • Data Type: the data type of the column.
  • Length: the data length of the column
    
  • Precision: the number of digits in a number.
  • Scale: the number of digits to the right of the decimal point in a number.
  • CodePage: the Code Page of the field.

Error Handling Page

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

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 Blob Storage 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 erroneous rows. The 'ErrorMessage' output column found in the 'Error Output' may contain the error message that was reported by the server or the component itself.