he next version of SQL Server (code name Yukon) has extensive support for the Common Language Runtime (CLR).
Previous versions of SQL Server (2000 and earlier) had a mechanism for creating custom data types. These data types were nothing more than aliases to system data types. In Yukon, you can create your own fully functional custom data types.The process of creating a UDT begins with creating a .NET class that supports the proper API. Creating and using a UDT comes in two phases: creating the library and registering the UDT with SQL Server. The first step is to create your new data type in Visual Studio .NET. The listing for this article shows how to create a Social Security Number data type. When you create your UDT you will do the following:
- Create a new class library
- Import assembles
- Add two attributes to your class (Serializable() and SqlUserDefinedDataType)
- Implement the INullable interface
- Add required methods and properties to your class
- Compile your class
- Register your class library with SQL Server
Creating a Class Library
The initial phase of this process is to create a new class library. You create a new class by selecting New and then Project from the Visual Studio .NET menu. Select Class Library from either the C# or Visual Basic.NET (VB.NET) Projects list (this article demonstrates using VB.NET).
After creating your class library, you need to import the following assemblies
- System
- System.Data.SQL
- System.Data.SQLTypes
Adding Attributes
After adding the appropriate references, you need to “decorate” the class with two attributes. These attributes are Serializable() and SqlUserDefinedType. The Serializable attribute gives the CLR the ability to take the class and serialize it or to turn it into XML. SQL Server uses this capability to store and retrieve the class from its data store. The SqlUserDefineType attribute is used by SQL Server to determine how it should manage your class. This attribute has a number of properties. The two most important are Format and MaxByteSize. The Format property instructs SQL Server how to store the object. The MaxByteSize property determines how many bytes your data type can consume.
Implement the Object Interface
After decorating the class, you need to implement the .NET Framework INullable Interface. Interfaces are implemented using the Implements statement. The following snippet demonstrates how to implement the INullable interface.
Public ReadOnly Property _ IsNull() As Boolean Implements _ System.Data.SqlTypes_ .INullable.IsNull Get Return Me._IsNull End Get End Property
After implementing the INullable interface, you are required to implement the ToString() and Parse() methods and the Null() property
The ToString method is a common function found on most .NET classes. This function returns a representation of your data type as a string. Remember when you return the value from the ToString function you need to include a representation of NULL values. The following snippet shows the ToString method for this article’s example.
Public Overrides Function_ ToString() As String If Me.IsNull Then Return "NULL" Else Return Me._cInternalValue End If End Function
The other method that needs attention is the Parse() method. This is the method that SQL Server calls whenever someone inserts or updates data defined as your data type. The API for this method is as follows:
Parse(cData as SqlString) _ as
As you can see, this function receives a parameter declared as type SqlString. Upon receiving this code, you perform a number of tasks. The first task is to determine whether or not the data passed in is NULL. If it is, return Nothing from this method.
The second task is to convert the passed-in data to a .NET data type. This is done with the Convert class. After converting the passed-in data to a .NET data type, you can validate the data. If the data passed in does not conform to your rules, you can throw an exception. Figure 1 shows what an error thrown from a custom data type looks like.
Registering the Class After you have created and compiled the class into a DLL, you need to go to SQL Server and perform two tasks.
The following SQL code demonstrates how to perform these tasks:
Using the Class
There are a couple of items to note from the above example. The first item is the use of the Cast() statement. In order to insert data into a custom data type, you need to cast the SQL Server data types into your own data types. The next item to note is the syntax for querying data from a custom data type. The syntax for querying data from a custom data type is As you can see, creating custom data types in SQL Server Yukon is pretty simple stuff. Finally, you can create your own “real” data types with validation rules and all. I hope you can see now how to take advantage of this feature with minimal effort. About Our Editorial ProcessAt DevX, we’re dedicated to tech entrepreneurship. Our team closely follows industry shifts, new products, AI breakthroughs, technology trends, and funding announcements. Articles undergo thorough editing to ensure accuracy and clarity, reflecting DevX’s style and supporting entrepreneurs in the tech sphere. See our full editorial policy. About Our JournalistCharlie Frank Charlie has over a decade of experience in website administration and technology management. As the site admin, he oversees all technical aspects of running a high-traffic online platform, ensuring optimal performance, security, and user experience. View Author Digital banking tackles fraud with advanced methods Johannah Lopez April 24, 2024 1:55 PM Wealth accumulation: Path to personal freedom and societal impact Cameron Wiggins April 24, 2024 1:25 PM Japan’s finance minister warns of currency market intervention Rashan Dixon April 24, 2024 1:14 PM TabaPay set to acquire Synapse’s assets April Isaacs April 24, 2024 11:58 AM Baton Rouge Entrepreneurship Week 2024 announced Cameron Wiggins April 24, 2024 11:36 AM Netherlands thriving in European venture capital growth Noah Nguyen April 23, 2024 5:42 PM Fintech startup Ramp sees formidable growth Cameron Wiggins April 23, 2024 5:14 PM Is Bitcoin the New Gold? Understanding Cryptocurrency as a Hedge Against Inflation Rashan Dixon April 23, 2024 4:05 PM Zipline delivers millionth order, aims higher Rashan Dixon April 23, 2024 3:49 PM Embracer Group splits into three, boosts efficacy Johannah Lopez April 23, 2024 1:58 PM Predicted 2025 COLA sees modest growth Noah Nguyen April 23, 2024 1:50 PM Unexpected eviction unsettles Indianapolis businesses Cameron Wiggins April 23, 2024 11:46 AM Final April disability payment scheduled for release Johannah Lopez April 23, 2024 8:08 AM Social Security amends SSI eligibility for 2024 Johannah Lopez April 23, 2024 8:01 AM Silver tsunami presents opportunity for young entrepreneurs Johannah Lopez April 23, 2024 8:00 AM Unexpected eviction disrupts Indianapolis businesses Cameron Wiggins April 23, 2024 7:51 AM Embracer Group restructures into three entities April Isaacs April 23, 2024 7:07 AM Mercedes-AMG unveils powerful, innovative 2025 GT 63 S E Performance Johannah Lopez April 22, 2024 5:45 PM Google poised for notable organizational changes Johannah Lopez April 22, 2024 5:29 PM Merging Catholic faith with entrepreneurial education April Isaacs April 22, 2024 3:59 PM AI entrepreneur raises $13.8 million via LinkedIn April Isaacs April 22, 2024 3:35 PM Why ChatGPT Is So Important Today Grace Phillips April 22, 2024 3:07 PM How Tech Advancements and Tools Have Enhanced Business Kyle Lewis April 22, 2024 2:22 PM Mountain biking’s technological advances highlighted in 2024 event Johannah Lopez April 22, 2024 1:22 PM St. Louis mourns closure of cherished local establishments Noah Nguyen April 22, 2024 1:05 PM |