![TSQLT CREATE
Adding unit tests with tSQLt to the database deployment pipeline
@EdPiairo, #TugaIT
EXEC tSQLt.NewTestClass my_new_test_class’;
GO
CREATE PROCEDURE my_new_test_class.[test something imortant]
AS
BEGIN
-------Assemble
--This section is for code that sets up the environment
-------Act
-- Execute the code under test like a stored procedure, function or view
-- and capture the results in variables or tables.
-------Assert
-- Compare the expected and actual
END;](https://image.slidesharecdn.com/tsqltdeploymentpipeline-190209145255/85/Adding-unit-tests-with-tSQLt-to-the-database-deployment-pipeline-7-320.jpg)
![TSQLT RUN
Adding unit tests with tSQLt to the database deployment pipeline
• tSQLt.RunAll
• Execute all the tests
• tSQLt.Run '[your_test_class].[your_test]
• Execute a specific test
• tSQLt.Run '[your_test_class]'
• Execute a specific test class
@EdPiairo, #TugaIT](https://image.slidesharecdn.com/tsqltdeploymentpipeline-190209145255/85/Adding-unit-tests-with-tSQLt-to-the-database-deployment-pipeline-8-320.jpg)
Adding unit tests with tSQLt to the database deployment pipeline
- 1. ADDING UNIT TESTS WITH TSQLT TO THE DATABASE DEPLOYMENT PIPELINE Eduardo Piairo @EdPiairo #TugaIT
- 2. ABOUT ME Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT @EdPiairo https://pt.linkedin.com/in/jesuspiairo [email protected] http://www.eduardopiairo.com/ Eduardo Piairo DevOps Coach @ Natixis DevOps Porto Founder Friend of Redgate
- 3. TSQLT Adding unit tests with tSQLt to the database deployment pipeline • Database unit testing framework for Microsoft SQL Server • Allow to write T-SQL code as tests • Tests are automatically run within transactions • Provides a way to isolate code and tables using mocking • Output can be plain text or XML @EdPiairo, #TugaIT
- 4. TSQLT INSTALL Adding unit tests with tSQLt to the database deployment pipeline • tSQLt.class.sql • CLR • clr enabled • clr strict security • Should be installed in the development database @EdPiairo, #TugaIT
- 5. WHAT’S A TSQLT TEST? Adding unit tests with tSQLt to the database deployment pipeline • Stored Procedure • Starts with the word test • Must be in a schema that contains the extended property tSQLt.TestClass = 1 • tSQLt.NewTestClass • Each test is wrapped in a transaction • Modifications are rolled back and the results saved @EdPiairo, #TugaIT
- 6. WHAT’S A TSQLT TEST? Adding unit tests with tSQLt to the database deployment pipeline • Benefits • Business requirements documentation • Code refactoring • Isolation - unrelated changes do not affect other parts of the system • Help structure code into distinct components – keep it small @EdPiairo, #TugaIT
- 7. TSQLT CREATE Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT EXEC tSQLt.NewTestClass my_new_test_class’; GO CREATE PROCEDURE my_new_test_class.[test something imortant] AS BEGIN -------Assemble --This section is for code that sets up the environment -------Act -- Execute the code under test like a stored procedure, function or view -- and capture the results in variables or tables. -------Assert -- Compare the expected and actual END;
- 8. TSQLT RUN Adding unit tests with tSQLt to the database deployment pipeline • tSQLt.RunAll • Execute all the tests • tSQLt.Run '[your_test_class].[your_test] • Execute a specific test • tSQLt.Run '[your_test_class]' • Execute a specific test class @EdPiairo, #TugaIT
- 9. WHAT CAN BE TESTED? Adding unit tests with tSQLt to the database deployment pipeline • Stored Procedures • Functions • Views • Tables • Tables constrains that are critical @EdPiairo, #TugaIT
- 10. TESTING (WHITOUT DATA) Adding unit tests with tSQLt to the database deployment pipeline • Unit tests is about testing code • You do not need a database full of data, you need the opposite • Makes creating unit tests easy • Data setup • Only the necessary data for making the test work is needed • Mocking • tSQLt.FakeTable • tSQLt.FakeFunction • tSQLt.SpyProcedure @EdPiairo, #TugaIT
- 11. ISOLATING OBJECTS Adding unit tests with tSQLt to the database deployment pipeline • tSQLt.FakeTable • Fakes the original table without constrains • Isolate the table from constrains – I don’t need unnecessary data • tSQL.FakeFunction • Simply replaces the original function • Allow to simplify the logic • tSQLt.SpyProcedure • Replace the original SP with a spy • The spy will record the parameters that were passed to it @EdPiairo, #TugaIT
- 12. ISOLATING OBJECTS Adding unit tests with tSQLt to the database deployment pipeline • ApplyConstraint • RemoveObjectIfExists • ApplyTrigger • RemoveObject @EdPiairo, #TugaIT
- 13. ASSERTS Adding unit tests with tSQLt to the database deployment pipeline • tSQLt.AsserEquals • tSQLr.AssertEqualsTable • tSQLt.AssertEmptyTable • tSQLt.AssertEqualsString • tSQLt.AssertEqualsTableSchema • tSQLt.AssertLike • tSQLt.AssertNotEquals • AssertObjectDoesNotExist • AssertObjectExists • AssertResultSetsHaveSameMetaData • Fail @EdPiairo, #TugaIT
- 14. SQLTEST Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT • Redgate SQL Test • Add-in for SSMS for creating and running unit tests • Measure the code coverage of those tests
- 15. ADDING TSQLT TO THE DEPLOYMENT PIPEPLINE Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT Source Control Continuous Integration Continuous Delivery
- 16. ADDING TSQLT TO THE DEPLOYMENT PIPEPLINE Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT Source Control Continuous Integration Continuous Delivery
- 17. SOURCE CONTROL Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT • GitHub • T-SQL migrations • tSQLt tests • Pester tests • Building scripts
- 18. CONTINUOUS INTEGRATION Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT • VSTS • TEST environment setup (Local Machine | Docker) • Test and Report • Build artefact
- 19. CONTINUOUS DELIVERY Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo, #TugaIT • Octopus Deploy • Local Machine • Azure
- 20. REFERENCES Adding unit tests with tSQLt to the database deployment pipeline • https://tsqlt.org/user-guide/ • https://courses.agilesql.club/ @EdPiairo, #TugaIT
- 21. Q&A Adding unit tests with tSQLt to the database deployment pipeline @EdPiairo https://pt.linkedin.com/in/jesuspiairo [email protected] http://www.eduardopiairo.com/