Biml for Beginners: Script and Automate SSIS development (SQLSaturday Oslo)

Biml for Beginners:
Script and Automate
SSIS Development
Cathrine Wilhelmsen
SQLSaturday Oslo · September 1st 2018

© 2018 Cathrine Wilhelmsen (contact@cathrinewilhelmsen.net)
A big thanks to all of our sponsors!

Biml Basics Tools & Code
SQL and SSIS from Metadata
…the next 60 minutes…

Cathrine Wilhelmsen
@cathrinew cathrinew.net
Senior Business Intelligence Consultant, Inmeta

Once upon a time…

Meet Sandra,
the SSIS developer

Sandra has to create a
new staging project with
100+ SSIS packages

Sandra gets quite bored of
creating the same package
over and over and over

Yay, Sandra has finally
completed her project!

But Sandra's manager
has just a few new
requirements…

Sandra gets to update
every single SSIS package
one… more… time…

…yay

It's time for a change!

What is Biml?
Business Intelligence Markup Language
Easy to read and write XML language
Describes business intelligence objects:
• Databases, Schemas, Tables, Views, Columns
• SSIS Packages
• SSAS and Azure Data Factory *

Why use Biml?
SSIS: Plumbing Biml: Business Logic

Will Biml solve all your challenges?
Biml is a tool for generating SSIS packages
Biml is not a pre-defined Data Warehouse framework
Biml is not a tool for automating deployment

How can Biml help you?
Timesaving: Many SSIS packages from one Biml file
Reusable: Write once and run on any platform
Flexible: Start simple, expand as you learn

What if you don't have 100+ packages?
Source Control: Keep track of actual logic changes
Simplify: Untangle complex packages for quick edits
SQL Scripts: Use Biml instead of dynamic T-SQL

How does SSIS development work?

How does Biml development work?

What do you need?

Biml syntax
<Biml xmlns="http://schemas.varigence.com/biml.xsd">
<Packages>
<Package Name="EmptyPackage1"></Package>
<Package Name="EmptyPackage2"/>
</Packages>
</Biml>

Biml syntax: Root Element
<Packages>
</Packages>
</Biml>

Biml syntax: Collections of Elements
<Packages>
</Packages>
</Biml>

Biml syntax: Elements
<Packages>
</Packages>
</Biml>

Biml syntax: Attributes
<Packages>
</Packages>
</Biml>

Biml syntax: Full vs. Shorthand Syntax
<Packages>
</Packages>
</Biml>

DEMO
Let's generate
some packages!

Ok, so we can go from Biml to SSIS…

…can we go from SSIS to Biml?

Yes!

DEMO
Let's convert some
SSIS to Biml!

The magic is in the…

What is BimlScript?
Extend Biml with C# or VB code blocks
Import database structure and metadata
Loop over tables and columns
Expressions replace static values
Generate, control and manipulate Biml code

How does it work?

Yes, but how does it work?

BimlScript Code Blocks
<# … #> Control Block (Variables and logic)
<#= … #> Text Block (Returns string)
<#@ … #> Directive (Compiler instructions)

BimlScript Syntax
<# var con = SchemaManager.CreateConnectionNode(...); #>
<# var metadata = con.GetDatabaseSchema(); #>
<Packages>
<# foreach (var table in metadata.TableNodes) { #>
<Package Name="Load_<#=table.Name#>"></Package>
<# } #>
</Packages>
</Biml>

BimlScript Syntax: Import metadata
<Packages>
<# } #>
</Packages>
</Biml>

BimlScript Syntax: Loop over tables
<Packages>
<# } #>
</Packages>
</Biml>

BimlScript Syntax: Replace static values
<Packages>
<# } #>
</Packages>
</Biml>

Yes, but how does it actually work?
<# foreach (var table in RootNode.Tables) { #>
<Package Name="Load_<#=table.Name#>" />
<# } #>
<Package Name="Load_Customer" />
<Package Name="Load_Product" />
<Package Name="Load_Sales" />

PreviewPane
The power is in the…

DEMO
Let's generate
many packages!

What about SQL?

We can generate SSIS…

…can we also generate SQL?

Tiered Biml Files
Multiple Biml Files Working Together

What are Tiered Biml Files?
Think of tiers as stacked layers or sequential steps
Tier (Layer) 1
Tier 0
Tier (Layer) 2
Tier (Step) 1 Tier (Step) 2

Tiered Biml Files
Split Biml code in multiple files to:
• Solve logical dependencies
• Build solutions in multiple steps
Specify the tier per file by using template directive:
<#@ template tier="2" #>

Tiered Biml Files: Behind the Scenes
Connections
Load Packages
Master Package
Connections
Databases
Schemas
Tables
Packages

Connections
Databases
Schemas
Tables
Packages
Connections
Load Packages
Master Package

Connections
Admin
Source
Destination
Databases
Schemas
Tables
Packages
Connections
Load Packages
Master Package

Connections
Admin
Source
Destination
Databases
Schemas
Tables
Packages
Load_Customer
Load_Product
Load_Sales
Connections
Load Packages
Master Package

Connections
Admin
Source
Destination
Databases
Schemas
Tables
Packages
Load_Customer
Load_Product
Load_Sales
Master Connections
Load Packages
Master Package

Connections
Admin
Source
Destination
Databases
Schemas
Tables
Packages
Load_Customer
Load_Product
Load_Sales
Master

Annotations
Store and Pass Metadata Between Biml Files

Annotations
Store custom metadata by attaching tags to Biml objects:
<Annotation Tag="TagName">Custom Value</Annotation>
Higher tier files can get tags from lower tier files

Annotations
Create annotations:
<OleDbConnection Name="Dest">
<Annotations>
<Annotation Tag="Schema">stg</Annotation>
</Annotations>
</OleDbConnection>
Use annotations:
RootNode.OleDbConnections["Dest"].GetTag("Schema");

DEMO
Let's put it
all together!

New project

Of course I can create
200 SSIS Packages!
…what do you need me
to do after lunch?

Biml Basics Tools & Code
SQL and SSIS from Metadata
…the past 60 minutes…

Where can you learn more?
Free online training
bimlscript.com

Where can you learn even more?
cathrinew.net/BimlBook

Get things done
Start small
Start simple
Start with ugly code
Keep going
Expand
Improve
Deliver often

Biml on Monday…
…BimlBreak the rest
of the week!

@cathrinew
cathrinew.net
hi@cathrinew.net
Biml resources and demo files:
cathrinew.net/biml

Biml for Beginners: Script and Automate SSIS development (SQLSaturday Oslo)

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Biml for Beginners: Script and Automate SSIS development (SQLSaturday Oslo)

Similar to Biml for Beginners: Script and Automate SSIS development (SQLSaturday Oslo) (20)

More from Cathrine Wilhelmsen

More from Cathrine Wilhelmsen (20)

Recently uploaded

Recently uploaded (20)

Biml for Beginners: Script and Automate SSIS development (SQLSaturday Oslo)