1. Tech·Ed North America 2009 7/31/2018 4:35 PM
© 2009 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

2. Tech·Ed  North America 2009
7/31/2018 4:35 PM
Optimizing Microsoft SQL Server 2008 Applications Using Table Valued Parameters, XML, and MERGE
Tobias Ternstrom
Program Mgr., SQL Server Engine
Microsoft Corporation
DAT 320
© 2009 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

3. Agenda Passing a set of data to SQL Server
7/31/2018 4:35 PM
Agenda
Passing a set of data to SQL Server
Adding MERGE to the equation
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

4. Passing a Set of Data to SQL Server
7/31/2018 4:35 PM
Passing a Set of Data to SQL Server
N rows = N executed statements
N rows = 1 executed statement
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

5. Passing a Set of Data to SQL Server
7/31/2018 4:35 PM
Passing a Set of Data to SQL Server
N rows = N executed statements
One client server roundtrip per execution
All executions in one batch
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

6. Passing a Set of Data to SQL Server
7/31/2018 4:35 PM
Passing a Set of Data to SQL Server
N rows = 1 executed statement
Pass the data as a delimited list
Pass the data as XML
Pass the data as Table Valued Parameter
Other options
Managed bulk copy to a table
Pass data as separate arguments (current limit is 2,100)
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

7. 7/31/2018 4:35 PM
Examples
In the examples, we will be passing a set of items to the database for storage
Example – “Store the following 1,000 items”
Examples we’ll use:
Stored Procedures
C# & ADO.NET
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

8. Pass the Data as a Delimited List
// C#
cmd.CommandType = CommandType.StoredProcedure; cmd.CommandText =
…|…|…
…|…|…"); cmd.Execute…;
-- What happens on the server?
EXEC = '…|…|…
…|…|…';

9. Pass the Data as a Delimited List
7/31/2018 4:35 PM
Pass the Data as a Delimited List
To get the best performance, we need to use a SQLCLR Table Valued Function
Pros:
Performance is good
No exposure to SQL Injection
Cons:
Requires SQLCLR to be enabled on the instance
The set of data is not strongly typed
Cumbersome implementation
Can be simplified by creating one TVF per “list type”
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

10. Pass the Data as XML // C#
cmd.CommandType = CommandType.StoredProcedure; cmd.CommandText = "Test.spXML"; doc.OuterXml); cmd.Execute…;
-- What happens on the server?:
EXEC = N'<Orders><Order…

11. Pass the Data as XML Pros Cons
7/31/2018 4:35 PM
Pass the Data as XML
Pros
Strongly typed (if you use an XML Schema Collection)
Performance is OK
No exposure to SQL Injection
A very good option if your data is already XML!
Great flexibility; remember XML allows for hierarchies
Cons
Performance is good but not the best
Requires knowledge about XML
Less cumbersome than the delimited list but still somewhat cumbersome
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

12. Pass the Data as a Table Valued Parameter
// C#
cmd.CommandType = CommandType.StoredProcedure; cmd.CommandText = "Test.spTVP"; var p = SqlDbType.Structured); p.TypeName = "Test.OrderTableType"; p.Value = dataTable;
cmd.Execute…;
-- What happens on the server?:
Test.OrderTableType; …
EXEC

13. Pass the Data as Table Valued Parameter
7/31/2018 4:35 PM
Pass the Data as Table Valued Parameter
Pros
Strongly typed
No exposure to SQL Injection
Performance is great!
Very easy to use, both on client and server side
Cons
Less flexible than XML; may require you to pass multiple TVPs where one XML parameter would have been enough
Allows for streaming but only to the server
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

14. Pass the Data as a Table Valued Parameter  Streaming
// C#
class MyStreamingTvp : IEnumerable<SqlDataRecord> { … }
… cmd.CommandType = CommandType.StoredProcedure; cmd.CommandText = "Test.spTVP"; var p = SqlDbType.Structured); p.TypeName = "Test.OrderTableType"; p.Value = new MyStreamingTvp(…);
cmd.Execute…; -- What happens on the server?:
Test.OrderTableType; …
EXEC

15. Pass the Data as a Table Valued Parameter  Streaming
7/31/2018 4:35 PM
Pass the Data as a Table Valued Parameter  Streaming
Pros
No need for staging the data in memory on the client side
Cons
Doesn’t stream all the way, stages the data on the server side
Requires a type to handle the streaming
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

16. A Few More Words on Streaming
7/31/2018 4:35 PM
A Few More Words on Streaming
If you stream, how “far” do you stream?
N rows = N client server round trips & N proc. executions
Streams “all” the way to the destination table
Streaming TVP
Streams from client to just before the procedure begins execution, i.e., stages the data on the server side
The rest
Stages the data both on the client and server side
Any solution can implement streaming “manually”
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

17. What Happens? And What About Performance?
7/31/2018 4:35 PM
What Happens? And What About Performance?
Initial parsing of the data on the server
Querying the data
Insert the data into a table
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

18. 1. Initial Parsing on the Server

19. 1. Initial Parsing on the Server

20. 2. Querying the Data

21. 2. Querying the Data

22. 3. Insert the Arguments into a Table

23. 3. Insert the Data into a Table

24. Agenda Passing a set of data to SQL Server
7/31/2018 4:35 PM
Agenda
Passing a set of data to SQL Server
Adding MERGE to the equation
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

25. Adding MERGE to the Equation
Also referred to as UPSERT
Allows for inserting, updating and deleting data in one statement
It is part of ANSI
…with one addition!

26. Adding MERGE to the Equation
Events
MATCHED
NOT MATCHED
NOT MATCHED BY SOURCE
Type of event
$action

27. Adding MERGE to the Equation
MERGE Test.Orders AS o
AS v
ON v.OrderId = o.OrderId
WHEN MATCHED THEN
UPDATE SET
CustomerId = v.CustomerId
,OrderDate = v.OrderDate
,DueDate = v.DueDate
WHEN NOT MATCHED BY SOURCE THEN
DELETE
WHEN NOT MATCHED THEN
INSERT (OrderId, CustomerId, OrderDate)
VALUES(v.OrderId, v.CustomerId, v.OrderDate);

28. question & answer

29. Resources Required Slide Speakers, www.microsoft.com/teched
TechEd 2009 is not producing
a DVD. Please announce that
attendees can access session
recordings at TechEd Online.
Resources
Sessions On-Demand & Community
Microsoft Certification & Training Resources
Resources for IT Professionals
Resources for Developers
Microsoft Certification and Training Resources

30. Related Content Required Slide Speakers,
please list the Breakout Sessions, TLC Interactive Theaters and Labs that are related to your session.
Related Content
DAT313 Inside T-SQL: Enhancements, Techniques, Tips & Tricks
DAT305 Best Practices for Exception Handling and Defensive Programming in Microsoft SQL Server
DAT04-INT Using the HIERARCHYID Datatype in Microsoft SQL Server 2008 to Maintain and Query Hierarchies
300 - Advanced, Database Platform, Developer Tools, Languages and Frameworks, Hands-on Lab, Middle Tier Platform and Tools

31. SQL Server Community Resources
Connect: Local Chapters, Special Interest Groups, Online Community
Share: PASSPort Social Networking, Community Connection Event
Learn: PASS Summit Annual Conference, Technical Articles, Webcasts
More about the PASS organization
The Professional Association for SQL Server (PASS) is an independent, not-for-profit association, dedicated to supporting, educating, and promoting the Microsoft SQL Server community.
Become a FREE PASS Member:
Learn more about the PASS organization
Additional Community Resources
SQL Server Community Center
TechNet Community for IT Professionals
Developer Center
SQL Server 2008 Learning Portal

32. Additional Resources External Resources
Team Forum: Speaker URL #2
Other: Speaker URL #3
External Resources
TVPs
MERGE
SQL Server 2008 Business Value Calculator:

33. Complete an evaluation on CommNet and enter to win!
Required Slide
Complete an evaluation on CommNet and enter to win!

34. Required Slide
7/31/2018 4:35 PM
© 2009 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.
© 2007 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.