如何:創(chuàng)建和運(yùn)行 CLR SQL Server 用戶定義的類型
通過(guò)將“用戶定義的類型”添加到 SQL Server 項(xiàng)目,可以創(chuàng)建 SQL 用戶定義的類型。部署成功后,可以將該類型用于可使用系統(tǒng)類型的所有上下文,包括列定義、變量、參數(shù)、函數(shù)結(jié)果、光標(biāo)、觸發(fā)器和復(fù)制等。UDT 為用戶提供了 SQL Server 數(shù)據(jù)類型系統(tǒng)的擴(kuò)展性,還提供了定義復(fù)雜結(jié)構(gòu)類型的功能。
注意; 在默認(rèn)情況下,Microsoft SQL Server 中關(guān)閉了公共語(yǔ)言運(yùn)行庫(kù) (CLR) 集成功能。必須啟用該功能才能使用 SQL Server 項(xiàng)目項(xiàng)。若要啟用 CLR 集成,請(qǐng)使用 sp_configure 存儲(chǔ)過(guò)程的“啟用 clr”選項(xiàng)。有關(guān)更多信息,請(qǐng)參見(jiàn)啟用 CLR 集成。注意; 顯示的對(duì)話框和菜單命令可能會(huì)與幫助中的描述不同,具體取決于您現(xiàn)用的設(shè)置或版本。若要更改設(shè)置,請(qǐng)?jiān)凇肮ぞ摺辈藛紊线x擇“導(dǎo)入和導(dǎo)出設(shè)置”。有關(guān)更多信息,請(qǐng)參見(jiàn) Visual Studio 設(shè)置。
創(chuàng)建用戶定義的類型創(chuàng)建 SQL 用戶定義的類型打開(kāi)一個(gè)現(xiàn)有的“SQL Server 項(xiàng)目”,或者創(chuàng)建一個(gè)新項(xiàng)目。有關(guān)更多信息,請(qǐng)參見(jiàn)如何:創(chuàng)建 SQL Server 項(xiàng)目。
從“項(xiàng)目”菜單中選擇“添加新項(xiàng)”。
在“添加新項(xiàng)”對(duì)話框 中選擇“用戶定義的類型”。
為新的 UDT 鍵入“名稱”。
添加用于定義和創(chuàng)建 UDT 的代碼。請(qǐng)參見(jiàn)下面的第一個(gè)示例。
注意; C++ 示例在編譯時(shí)必須使用 /clr:safe 編譯器選項(xiàng)。
對(duì)于 Visual Basic 和 Visual C#,在“解決方案資源管理器”中,打開(kāi)“TestScripts”文件夾,再雙擊“Test.sql”文件。
對(duì)于 Visual C++,在“解決方案資源管理器”中,雙擊“debug.sql”文件。
將代碼添加到“Test.sql”(Visual C++ 中為“debug.sql”)文件中以執(zhí)行 UDT。請(qǐng)參見(jiàn)下面的第二個(gè)示例。
按 F5 生成、部署和調(diào)試 UDT。有關(guān)不進(jìn)行調(diào)試直接部署的信息,請(qǐng)參見(jiàn)如何:將 SQL Server 項(xiàng)目項(xiàng)部署到 SQL Server 中。
在“輸出”窗口 中查看結(jié)果,然后選擇“從此處顯示輸出:數(shù)據(jù)庫(kù)輸出”。
示例此示例創(chuàng)建一個(gè) Point 類型,該類型的用法與其他簡(jiǎn)單類型一樣。使用 Serializable 和 SqlUserDefinedTypeAttribute 屬性來(lái)修飾這個(gè)類聲明。SqlUserDefinedTypeAttribute 的 Format 屬性決定了 UDT 的存儲(chǔ)格式。該類型通過(guò)實(shí)現(xiàn) Parse 和 ToString 方法來(lái)實(shí)現(xiàn)字符串轉(zhuǎn)換。此外,該類型還實(shí)現(xiàn)兩個(gè)屬性過(guò)程,以便為此類所表示的點(diǎn)獲取和設(shè)置 X 和 Y 的值。
Visual Basic 復(fù)制代碼Imports SystemImports System.Data.SqlTypesImports Microsoft.SqlServer.Server
<Serializable()> _<SqlUserDefinedType(Format.Native)> _Public Structure Point Implements INullable
Private m_x As Int32 Private m_y As Int32 Private is_Null As Boolean
Public Property X() As Int32 Get Return (Me.m_x) End Get Set(ByVal Value As Int32) m_x = Value End Set End Property
Public Property Y() As Int32 Get Return (Me.m_y) End Get Set(ByVal Value As Int32) m_y = Value End Set End Property
Public ReadOnly Property IsNull() As Boolean Implements INullable.IsNull Get Return is_Null End Get End Property
Public Shared ReadOnly Property Null() As Point Get Dim pt As Point = New Point pt.is_Null = True Return pt End Get End Property
Public Overrides Function ToString() As String If Me.IsNull() Then Return Nothing Else Return Me.m_x & ':' & Me.m_y End If End Function
Public Shared Function Parse(ByVal s As SqlString) As Point If s = SqlString.Null Then Return Null End If
If s.ToString() = SqlString.Null.ToString() Then Return Null End If
If s.IsNull Then Return Null End If
'Parse input string here to separate out coordinates Dim str As String = Convert.ToString(s) Dim xy() As String = str.Split(':'c)
Dim pt As New Point() pt.X = CType(xy(0), Int32) pt.Y = CType(xy(1), Int32) Return (pt) End Function
Public Function Quadrant() As SqlString
If m_x = 0 And m_y = 0 Then Return 'centered' End If
Dim stringResult As String = ''
Select Case m_x Case 0 stringResult = 'center' Case Is > 0 stringResult = 'right' Case Is < 0 stringResult = 'left' End Select
Select Case m_y Case 0 stringResult = stringResult & ' center' Case Is > 0 stringResult = stringResult & ' top' Case Is < 0 stringResult = stringResult & ' bottom' End Select
Return stringResult End FunctionEnd StructureC# 復(fù)制代碼using System;using System.Data.SqlTypes;using Microsoft.SqlServer.Server;
[Serializable()][SqlUserDefinedType(Format.Native)]public struct Point : INullable{ private Int32 m_x; private Int32 m_y; private bool is_Null;
public Int32 X { get { return (this.m_x); } set { m_x = value; } }
public Int32 Y { get { return (this.m_y); } set { m_y = value; } }
public bool IsNull { get { return is_Null; } }
public static Point Null { get { Point pt = new Point(); pt.is_Null = true; return (pt); } }
public override string ToString() { if (this.IsNull) { return 'NULL'; } else { return this.m_x + ':' + this.m_y; } }
public static Point Parse(SqlString s) { if (s.IsNull) { return Null; }
// Parse input string here to separate out coordinates string str = Convert.ToString(s); string[] xy = str.Split(':');
Point pt = new Point(); pt.X = Convert.ToInt32(xy[0]); pt.Y = Convert.ToInt32(xy[1]); return (pt); }
public SqlString Quadrant() { if (m_x == 0 && m_y == 0) { return 'centered'; }
SqlString stringReturn = '';
if (m_x == 0) { stringReturn = 'center'; } else if (m_x > 0) { stringReturn = 'right'; } else if (m_x < 0) { stringReturn = 'left'; }
if (m_y == 0) { stringReturn = stringReturn + ' center'; } else if (m_y > 0) { stringReturn = stringReturn + ' top'; } else if (m_y < 0) { stringReturn = stringReturn + ' bottom'; }
return stringReturn; }}C++ 復(fù)制代碼#include 'stdafx.h'
#using <System.dll>#using <System.Data.dll>#using <System.Xml.dll>
using namespace System;using namespace System::Data;using namespace System::Data::Sql;using namespace System::Data::SqlTypes;using namespace Microsoft::SqlServer::Server;
// In order to debug your User-Defined Types, add the following to your debug.sql file://// CREATE TABLE test_table (column1 Point)//// INSERT INTO test_table (column1) VALUES ('1:2')// INSERT INTO test_table (column1) VALUES ('-2:3')// INSERT INTO test_table (column1) VALUES ('-3:-4')//// SELECT column1.Quadrant() FROM test_table//// DROP TABLE test_table//[Serializable][SqlUserDefinedType(Format::Native)]public value struct Point : public INullable{private: Int32 m_x; Int32 m_y; bool is_Null;
public: property Int32 X { Int32 get() { return (this->m_x); } void set(Int32 value) { m_x = value; } }
property Int32 Y { Int32 get() { return (this->m_y); } void set(Int32 value) { m_y = value; } }
virtual property bool IsNull { bool get() { return is_Null; } }
static property Point Null { Point get() { Point pt; pt.is_Null = true; return (pt); } }
virtual String ^ToString() override { if (this->IsNull) { return 'NULL'; } else { return this->m_x + ':' + this->m_y; } }
static Point Parse(SqlString s) { if (s.IsNull) { return Null; }
// Parse input string here to separate out coordinates String ^str = Convert::ToString(s); array<String ^> ^xy = str->Split(':');
Point pt; pt.X = Convert::ToInt32(xy[0]); pt.Y = Convert::ToInt32(xy[1]); return (pt); }
SqlString Quadrant() { if (m_x == 0 && m_y == 0) { return 'centered'; }
SqlString stringReturn = '';
if (m_x == 0) { stringReturn = 'center'; } else if (m_x > 0) { stringReturn = 'right'; } else if (m_x < 0) { stringReturn = 'left'; }
if (m_y == 0) { stringReturn = stringReturn + SqlString(' center'); } else if (m_y > 0) { stringReturn = stringReturn + SqlString(' top'); } else if (m_y < 0) { stringReturn = stringReturn + SqlString(' bottom'); }
return stringReturn; }};
將用于執(zhí)行和測(cè)試用戶定義類型 (Point) 的代碼添加到“Test.sql”(Visual C++ 中為“debug.sql”)文件中,該文件在項(xiàng)目的“TestScripts”文件夾中。例如,若要檢查新類型,可以創(chuàng)建一個(gè)使用此類型的表。下面的示例演示如何在創(chuàng)建表的過(guò)程中使用 Point 類型。
復(fù)制代碼CREATE TABLE test_table (column1 Point)go
INSERT INTO test_table (column1) VALUES ('1:2')INSERT INTO test_table (column1) VALUES ('-2:3')INSERT INTO test_table (column1) VALUES ('-3:-4')
select column1.Quadrant() from test_table
