Scribd
Upload
181 views27 pages

Extending SSIS With Custom Tasks - Darren Green

Extending SSIS with custom tasks allows developers to reuse logic across packages, access legacy resources, and handle complex business logic. There are several types of extensions including tasks, pipeline components, log providers, and enumerators. To create a custom task, developers add references, write code implementing the task methods, compile, and install the assembly in the GAC or SSIS folder for use at design or runtime. Debugging custom objects requires attaching to the appropriate host process.

Uploaded by

Sergio Bolaños Coto
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd
181 views27 pages

Extending SSIS With Custom Tasks - Darren Green

Extending SSIS with custom tasks allows developers to reuse logic across packages, access legacy resources, and handle complex business logic. There are several types of extensions including tasks, pipeline components, log providers, and enumerators. To create a custom task, developers add references, write code implementing the task methods, compile, and install the assembly in the GAC or SSIS folder for use at design or runtime. Debugging custom objects requires attaching to the appropriate host process.

Uploaded by

Sergio Bolaños Coto
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PPTX, PDF, TXT or read online on Scribd
You are on page 1/ 27

Platinum

Learn & Enjoy


[Put your phone on Vibrate!] www.sqlbits.com

Group BY:
Gold

[Food and Drink at Reading Bowl, see you there!]

Feedback Forms:
[Voucher for £30 book on return of Form]
Silver

Lunch Time Sessions:


[Idera in Everest, Quest in Memphis, Grok in Chic 1 and 2]

Ask The Experts


[Sessions need to finish on time, take questions to the ATE area]

Extending SSIS with Custom Tasks


Extending SSIS with Custom Tasks

Darren Green
Konesans Ltd
Agenda

• Extending SSIS
– Types
– Six Steps
– Tasks
– Debugging
– Installation
– When and Why?
Types

• Task
• Pipeline Component
– Source
– Destination
– Transform
• Log Provider
• For Each Enumerator
• Connection Manager
Six Steps

• Create project
• Add references
• Add signing key
• Write code
• Compile
• Install
References

• Microsoft.SQLServer.ManagedDTS
– Microsoft.SqlServer.Dts.Runtime
• Microsoft.SQLServer.DTSRuntimeWrap
– Microsoft.SqlServer.Dts.Runtime.Wrapper
• Microsoft.SqlServer.PipelineHost
– Microsoft.SqlServer.Dts.Pipeline
• Microsoft.SqlServer.DTSPipelineWrap
– Microsoft.SqlServer.Dts.Pipeline.Wrapper
• Microsoft.SqlServer.Dts.Design
– Microsoft.SqlServer.Dts.Runtime.Design
Custom Objects - Template

[ObjectAttribute(Information)]
public class MyCustomObject : BaseClass
{
public override void BaseMethod()
{
// Custom code
}
}
Classes & Attributes

Base Class Attribute

ConnectionManagerBase DtsConnectionAttribute

PipelineComponent DtsPipelineComponentAttribute

ForEachEnumerator DtsForEachEnumeratorAttribute

LogProviderBase DtsLogProviderAttribute

Task DtsTaskAttribute
Demo

Simple Task
Tasks

• Methods
– InitializeTask
– Validate
– Execute
• Properties
– Use attributes, editors and type converters
– Use connection GUID
– Write only for security when required
– Custom persistence for sensitive data or complex
types
More Task Features

• Custom Events

• Custom Log Entries

• Breakpoints (IDTSBreakpointSite)
Create a Task User Interface

• Create UI class (Implement IDtsTaskUI)

• Create UI form

• Set task’s UITypeName attribute


Demo

Simple Task User Interface


Advanced Task User Interfaces

• Microsoft.DataTransformationServices.Controls
Microsoft.DataTransformationServices.Controls.dll

• DTSBaseTaskUI Base Form Class


– DTSTaskUIHost Control, paged control
– Class per page, implement IDTSTaskUIView
UI Classes & Attributes

Interface / Class Notes

IDtsConnectionManagerUI Use Win Form

Use Win Form


IDtsComponentUI
CManagedComponentWrapper

ForEachEnumeratorUI UserControl

IDtsLogProviderUI Not Supported

Use Win Form


IDtsTaskUI
Debugging

• Designer – Design time


– Attach to devenv.exe
• Designer – Runtime
– Attach to DTSDebugHost.exe

• Component Project – Runtime


– Start external program C:\Program...\DTExec.exe
/F "C:\...TestPackage.dtsx”
Debugging Tips

• Ensure class and strong name is fixed at


start
• Must restart BIDS between builds, slow!
• Use DTExec for all runtime
• Use Post Build Event for install
– copy "$(TargetPath)“ C:\Program...
– gacutil.exe" /if "$(TargetPath)“
• Ensure persistence complete
Installation Locations

• Designer Enumeration Folder


– Designer location only (x86 Only)

C:\Program Files\Microsoft SQL Server\90\DTS\<Object>


\Connections \LogProviders
\ForEachEnumerators \PipelineComponents
\Tasks

• Global Assembly Cache


– Runtime loading by execution host
Install Platform Target 32-bit (x86)

Location x86 x64 IA64 MSIL

Program Files Design Design

GAC Run Run

• Install in Program Files for Designer


• Install in GAC for run-time
• Support for x86 specific targeted assemblies
• Support for Any CPU / MSIL
Install Platform Target 64-bit (x64)

Location x86 x64 IA64 MSIL

Program Files (x86) Design Design

GAC Run Run Run

• Support for x86 only targeted assemblies


• Support for x64 only targeted assemblies
• Support for Any CPU / MSIL
• Designer is x86/MSIL only
• Can side by side target assemblies
Install Platform Target Itanium (IA64)

Location x86 x64 IA64 MSIL

GAC Run Run

• Support for IA64


• Support for Any CPU / MSIL
• No designer support
64-bit Tools Only

Location x86 x64 IA64 MSIL

Program Files (x86)

GAC Run Run

• No x86 file requirement


• No x86 DTSPath registry key
• MSI registry search is 32-bit
• No key, no tools, no designer, no file required!
Install Tips

• Use MSI builder of choice, e.g. VS, WiX


• Registry Search for DTS folder location
HKLM\SOFTWARE\Microsoft\MSDTS\Setup\DTSPath
C:\Program Files\Microsoft SQL Server\90\DTS\
• Allow tools only installs, don’t require 32-bit key
• User Interfaces & Support Assemblies?
– GAC Only
• Support Files?
– Use special folders, CommonApplicationData
• Minimal UI, no options required
When to extend

• Reuse in multiple packages


– Increased Development vs Lower Maintenance

• Access legacy resources (COM)


• Complex business logic
• More advanced code requirements
• Powerful IDE
• Language choice
Resources - Samples

• Microsoft Download Center


http://www.microsoft.com/downloads/
Search for “SQL Server SSIS Sample Component”
• Professional SQL Server 2005 Integration
Services – WROX (Ch 14 – 15 – Samples)
http://www.wrox.com/WileyCDA/WroxTitle/productCd
-0764584359.html
• Microsoft SQL Server 2005 Integration
Services – SAMS (Ch 24 – 25 - Samples)
http://www.samspublishing.com/bookstore/product.a
sp?isbn=0672327813
Thank You!

Darren Green
Konesans Ltd
[email protected]
http://www.konesans.com

http://www.sqldts.com
http://www.sqlis.com
Platinum

www.SQLBits.com
[Conference Web site] www.sqlbits.com

www.SQLBlogCasts.com
Gold

[Becoming the premier Blogging site for SQL professionals]


www.SQLServerFAQ.com
[UK SQL Server Community Website]
Silver

UK SQL Bloggers
cwebbbi.spaces.live.com
sqlblogcasts.com/blogs/simons
sqlblogcasts.com/blogs/tonyrogerson

Feedback Forms!!

You might also like