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 Social security policy changes impact retiree benefits Rashan Dixon May 2, 2024 5:43 PM Financial anxiety rises among US adults, says AARP study Noah Nguyen May 2, 2024 5:01 PM Game Pass refreshes library with exciting additions Johannah Lopez May 2, 2024 3:25 PM Google’s pixel 8 pro adopts minimalistic camera finish Johannah Lopez May 2, 2024 1:48 PM Apple’s new Beats Solo Buds offer affordable audio quality Rashan Dixon May 2, 2024 1:23 PM Double social security payments expected certain months April Isaacs May 2, 2024 11:57 AM Market anticipates Federal Reserve’s rate decision Rashan Dixon May 2, 2024 11:29 AM Bitcoin remains sturdy amid crypto market turbulence Johannah Lopez May 2, 2024 8:09 AM Binance founder sentenced to prison, steps down as CEO Noah Nguyen May 2, 2024 7:10 AM U.S. stock futures dip, challenging market optimism Rashan Dixon May 1, 2024 5:20 PM Inadequate information delays necessary assistance Johannah Lopez May 1, 2024 5:15 PM June’s social security payments released early April Isaacs May 1, 2024 3:30 PM Financial instability grows among aging Americans Johannah Lopez May 1, 2024 3:27 PM Google improves split-screen mode for Pixel devices Cameron Wiggins May 1, 2024 11:52 AM Apple AirPods Pro now at lowest price on Amazon April Isaacs May 1, 2024 11:44 AM HSBC’s CEO Noel Quinn set to depart Rashan Dixon May 1, 2024 11:39 AM Leaked designs hint at unique iPhone 16 features April Isaacs May 1, 2024 11:13 AM Yen’s value drops, stirs global market concerns Johannah Lopez May 1, 2024 7:26 AM Boost your business empowers small enterprises Rashan Dixon April 30, 2024 5:40 PM Oil prices drop amidst easing Middle East tensions Rashan Dixon April 30, 2024 5:26 PM National Small Business Week celebrates resilience and innovation April Isaacs April 30, 2024 5:16 PM How to Create and Deploy QR Codes Online: A Comprehensive Guide Rashan Dixon April 30, 2024 5:04 PM Circle fintech firm announces major changes, resumes stablecoin use Cameron Wiggins April 30, 2024 3:06 PM Beauty mogul Jackie Aina shares Forvr Mood entrepreneurial insights Rashan Dixon April 30, 2024 1:28 PM From cart to cafes: Nitro Bar’s inspiring journey Cameron Wiggins April 30, 2024 11:40 AM |