|
1 | 1 | --- |
2 | | -title: "Add Business Logic to XML Data | Microsoft Docs" |
| 2 | +title: "Add Business Logic to XML Data" |
3 | 3 | description: Learn how you can add business logic to XML data by applying XSL transformations, using domain-specific constraints on data, or by triggering validation rules. |
4 | 4 | ms.custom: "" |
5 | | -ms.date: "03/14/2017" |
| 5 | +ms.date: 05/05/2022 |
6 | 6 | ms.prod: sql |
7 | 7 | ms.prod_service: "database-engine" |
8 | | -ms.reviewer: "" |
| 8 | +ms.reviewer: randolphwest |
9 | 9 | ms.technology: xml |
10 | 10 | ms.topic: conceptual |
11 | | -helpviewer_keywords: |
| 11 | +helpviewer_keywords: |
12 | 12 | - "business logic [XML]" |
13 | | -ms.assetid: 0877fb38-f1a2-43d8-86cf-4754be224dc1 |
14 | 13 | author: MikeRayMSFT |
15 | 14 | ms.author: mikeray |
16 | 15 | --- |
17 | | -# Add Business Logic to XML Data |
| 16 | +# Add business logic to XML data |
| 17 | + |
18 | 18 | [!INCLUDE [SQL Server Azure SQL Database](../../includes/applies-to-version/sql-asdb.md)] |
19 | | - Your business logic can be added to XML data in several ways: |
20 | | - |
21 | | -- You can write row or column constraints to enforce domain-specific constraints during insertion and modification of XML data. |
22 | | - |
23 | | -- You can write a trigger on the XML column that fires when you insert or update values in the column. The trigger can contain domain-specific validation rules or populate property tables. |
24 | | - |
25 | | -- The Database Engine includes the ability to execute managed code. You can use this common language runtime (CLR) integration to write functions in managed code to which you pass XML values, and use XML processing capabilities provided by the System.Xml namespace. An example is to apply XSL transformation to XML data. Alternatively, you can deserialize the XML into one or more managed classes and operate on them by using managed code. |
26 | | - |
27 | | -- You can write Transact-SQL stored procedures and functions that start the processing on the XML column for your business needs. |
28 | | - |
29 | | -## Example: Applying XSL Transformation |
30 | | - Consider a CLR function **TransformXml()** that accepts an **xml** data type instance and an XSL transformation stored in a file, applies the transformation to the XML data, and then returns the transformed XML in the result. Following is a skeleton function that is written in C#: |
31 | | - |
32 | | -``` |
33 | | -public static SqlXml TransformXml (SqlXml XmlData, string xslPath) { |
34 | | - // Load XSL transformation |
35 | | - XslCompiledTransform xform = new XslCompiledTransform(); |
36 | | - XPathDocument xslDoc = new XPathDocument (xslPath); |
37 | | - xform.Load(xslDoc); |
38 | | - |
39 | | - // Load XML data |
40 | | - XPathDocument xDoc = new XPathDocument (XmlData.CreateReader()); |
41 | | - |
42 | | - // Return the transformed value |
43 | | - MemoryStream xsltResult = new MemoryStream(); |
44 | | - xform.Transform(xDoc, null, xsltResult); |
45 | | - SqlXml retSqlXml = new SqlXml(xsltResult); |
46 | | - return (retSqlXml); |
47 | | -} |
48 | | -``` |
49 | | - |
50 | | - After the assembly is registered and a user-defined [!INCLUDE[tsql](../../includes/tsql-md.md)] function is created, **SqlXslTransform()** corresponding to **TransformXml()**, the function can be invoked from Transact-SQL as shown in the following query: |
51 | | - |
52 | | -``` |
53 | | -SELECT SqlXslTransform (xCol, 'C:\MyFile\xsltransform.xsl') |
54 | | -FROM T |
55 | | -WHERE xCol.exist('/book/title/text()[contains(.,"custom")]') =1; |
56 | | -``` |
57 | | - |
58 | | - The query result contains a rowset of the transformed XML. |
59 | | - |
60 | | - The CLR integration into [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] expands the possibilities for decomposing XML data into tables or property promotion, and querying XML data by using managed classes in the System.Xml namespace. For more information, see [XML Data (SQL Server)](../../relational-databases/xml/xml-data-sql-server.md). |
61 | | - |
62 | | - |
| 19 | + |
| 20 | +Your business logic can be added to XML data in several ways: |
| 21 | + |
| 22 | +- You can write row or column constraints to enforce domain-specific constraints during insertion and modification of XML data. |
| 23 | + |
| 24 | +- You can write a trigger on the XML column that fires when you insert or update values in the column. The trigger can contain domain-specific validation rules or populate property tables. |
| 25 | + |
| 26 | +- The Database Engine includes the ability to execute managed code. You can use this common language runtime (CLR) integration to write functions in managed code to which you pass XML values, and use XML processing capabilities provided by the System.Xml namespace. An example is to apply XSL transformation to XML data. Alternatively, you can deserialize the XML into one or more managed classes and operate on them by using managed code. |
| 27 | + |
| 28 | +- You can write Transact-SQL stored procedures and functions that start the processing on the XML column for your business needs. |
| 29 | + |
| 30 | +## Example: Applying XSL transformation |
| 31 | + |
| 32 | +Consider a CLR function `TransformXml()` that accepts an **xml** data type instance and an XSL transformation stored in a file, applies the transformation to the XML data, and then returns the transformed XML in the result. Following is a skeleton function that is written in C#: |
| 33 | + |
| 34 | +```csharp |
| 35 | +public static SqlXml TransformXml (SqlXml XmlData, string xslPath) { |
| 36 | + // Load XSL transformation |
| 37 | + XslCompiledTransform xform = new XslCompiledTransform(); |
| 38 | + XPathDocument xslDoc = new XPathDocument (xslPath); |
| 39 | + xform.Load(xslDoc); |
| 40 | + |
| 41 | + // Load XML data |
| 42 | + XPathDocument xDoc = new XPathDocument (XmlData.CreateReader()); |
| 43 | + |
| 44 | + // Return the transformed value |
| 45 | + MemoryStream xsltResult = new MemoryStream(); |
| 46 | + xform.Transform(xDoc, null, xsltResult); |
| 47 | + SqlXml retSqlXml = new SqlXml(xsltResult); |
| 48 | + return (retSqlXml); |
| 49 | +} |
| 50 | +``` |
| 51 | + |
| 52 | +After the assembly is registered and a user-defined [!INCLUDE[tsql](../../includes/tsql-md.md)] function is created, `SqlXslTransform()` corresponding to `TransformXml()`, the function can be invoked from Transact-SQL as shown in the following query: |
| 53 | + |
| 54 | +```sql |
| 55 | +SELECT SqlXslTransform (xCol, 'C:\MyFile\xsltransform.xsl') |
| 56 | +FROM T |
| 57 | +WHERE xCol.exist('/book/title/text()[contains(.,"custom")]') = 1; |
| 58 | +``` |
| 59 | + |
| 60 | +The query result contains a rowset of the transformed XML. |
| 61 | + |
| 62 | +The CLR integration into [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] expands the possibilities for decomposing XML data into tables or property promotion, and querying XML data by using managed classes in the System.Xml namespace. For more information, see [XML Data (SQL Server)](../../relational-databases/xml/xml-data-sql-server.md). |
0 commit comments