使用用户定义类型
适用于：
SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)
SQL Server 2005 (9.x) 介绍了用户定义类型 (UDT)。 UDT 可将对象和自定义数据结构存储在 SQL Server 数据库中，从而扩展了 SQL 类型系统。 UDT 可以包含多种数据类型并且可具有行为，这使它们不同于由单一 SQL Server 系统数据类型构成的传统别名数据类型。 使用生成可验证代码的 .NET 公共语言运行时 (CLR) 所支持的任何语言都可以定义 UDT， 这包括 C# 和 Visual Basic .NET。 数据公开为 .NET 类或结构的字段和属性，行为则由类或结构的方法来定义。
UDT 可用作表的列定义、Transact-SQL 批处理中的变量或 Transact-SQL 函数或存储过程的参数。
适用于 SQL Server 的 OLE DB 驱动程序
适用于 SQL Server 的 OLE DB 驱动程序支持将 UDT 用作带元数据信息的二进制类型，让你能将 UDT 当作对象进行管理。 UDT 列公开为 DBTYPE_UDT，且其元数据通过核心 OLE DB 接口 IColumnRowset 和新增的 ISSCommandWithParameters 接口公开。
注意
IRowsetFind::FindNextRow 方法不适用于 UDT 数据类型 。 如果将 UDT 用作搜索列类型，则返回 DB_E_BADCOMPAREOP。
数据绑定和强制
下表说明将所列数据类型与某一 SQL Server UDT 一同使用时出现的绑定和强制。 UDT 列通过 OLE DB Driver for SQL Server 公开为 DBTYPE_UDT。 可以通过适当的架构行集获取元数据，这样即可将您自行定义的类型作为对象来管理。
| 数据类型 | 到服务器 UDT |
到服务器 non-UDT |
从服务器 UDT |
从服务器 non-UDT |
|---|---|---|---|---|
| DBTYPE_UDT | 支持6 | 错误1 | 支持6 | 错误5 |
| DBTYPE_BYTES | 支持6 | N/A2 | 支持6 | N/A2 |
| DBTYPE_WSTR | 支持3,6 | N/A2 | 支持4,6 | N/A2 |
| DBTYPE_BSTR | 支持3,6 | N/A2 | 支持4 | N/A2 |
| DBTYPE_STR | 支持3,6 | N/A2 | 支持4,6 | N/A2 |
| DBTYPE_IUNKNOWN | 不支持 | N/A2 | 不支持 | N/A2 |
| DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) | 支持6 | N/A2 | 支持4 | N/A2 |
| DBTYPE_VARIANT (VT_BSTR) | 支持3,6 | N/A2 | 空值 | N/A2 |
1如果使用 ICommandWithParameters::SetParameterInfo 指定 DBTYPE_UDT 之外的服务器类型，而取值函数类型为 DBTYPE_UDT，则执行该语句时将出错（DB_E_ERRORSOCCURRED；参数状态为 DBSTATUS_E_BADACCESSOR） 。 否则，数据发送到服务器，但服务器会返回错误，指明不存在将 UDT 转换为参数的数据类型的隐式转换。
2超出本文的范围。
3从十六进制字符串转换为二进制数据。
4从二进制数据转换为十六进制字符串。
5可能在创建取值函数时或在提取时执行验证，错误为 DB_E_ERRORSOCCURRED，且绑定状态设置为 DBBINDSTATUS_UNSUPPORTEDCONVERSION。
6可使用 BY_REF。
可绑定 DBTYPE_NULL 和 DBTYPE_EMPTY 用于输入参数，但不能用于输出参数或结果。 为输入参数进行绑定时，状态必须设置为 DBSTATUS_S_ISNULL 或 DBSTATUS_S_DEFAULT。
还可以将 DBTYPE_UDT 转换为 DBTYPE_EMPTY 和 DBTYPE_NULL，但无法将 DBTYPE_NULL 和 DBTYPE_EMPTY 转换为 DBTYPE_UDT。 这与 DBTYPE_BYTES 的情况是一致的。
备注
借助继承自 ICommandWithParameters 的新接口 ISSCommandWithParameters，可将 UDT 当作参数处理 。 应用程序必须使用此接口为 UDT 参数至少设置 DBPROPSET_SQLSERVERPARAMETER 属性集的 SSPROP_PARAM_UDT_NAME。 否则，ICommand::Execute 将返回 DB_E_ERRORSOCCURRED 。 此接口和属性集将在后文中介绍。
如果在某列中插入用户定义类型，而该列的大小不足以包含该类型的所有数据，则 ICommand::Execute 将返回 S_OK，且状态为 DB_E_ERRORSOCCURRED 。
OLE DB 核心服务 (IDataConvert) 提供的数据转换不适用于 DBTYPE_UDT 。 不支持其他绑定。
OLE DB 行集的添加和更改内容
OLE DB Driver for SQL Server 在许多核心 OLE DB 架构行集中添加了新值或进行了更改。
PROCEDURE_PARAMETERS 架构行集
在 PROCEDURE_PARAMETERS 架构行集中添加了以下内容。
| 列名称 | 类型 | 说明 |
|---|---|---|
| SS_UDT_CATALOGNAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 |
| SS_UDT_SCHEMANAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 |
| SS_UDT_NAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 |
| SS_UDT_ASSEMBLY_TYPENAME | DBTYPE_WSTR | 程序集限定名，其中包括 CLR 引用所需的类型名称和所有程序集标识。 |
SQL_ASSEMBLIES 架构行集
适用于 SQL Server 的 OLE DB 驱动程序公开一个新的提供程序特定的架构行集，它描述了注册的 UDT。 可以将 ASSEMBLY 服务器指定为 DBTYPE_WSTR，但它在行集中不存在。 如果未指定，行集将默认使用当前服务器。 下表中定义了 SQL_ASSEMBLIES 架构行集：
| 列名称 | 类型 | 说明 |
|---|---|---|
| ASSEMBLY_CATALOG | DBTYPE_WSTR | 包含该类型的程序集的目录名称。 |
| ASSEMBLY_SCHEMA | DBTYPE_WSTR | 包含该类型的程序集的架构名称或所有者名称。 尽管程序集的作用域为数据库而不是架构，但它们仍具有在此所反映的所有者。 |
| ASSEMBLY_NAME | DBTYPE_WSTR | 包含该类型的程序集的名称。 |
| ASSEMBLY_ID | DBTYPE_UI4 | 包含该类型的程序集的对象 ID。 |
| PERMISSION_SET | DBTYPE_WSTR | 指示程序集的访问范围的值。 这些值包括“SAFE”、“EXTERNAL_ACCESS”和“UNSAFE”。 |
| ASSEMBLY_BINARY | DBTYPE_BYTES | 程序集的二进制表示形式。 |
SQL_ASSEMBLIES_ DEPENDENCIES 架构行集
适用于 SQL Server 的 OLE DB 驱动程序公开一个新的提供程序特定的架构行集，它描述了所指定的服务器的程序集依赖项。 ASSEMBLY_SERVER 可由调用方指定为 DBTYPE_WSTR，但在该行集中不存在。 如果未指定，行集将默认使用当前服务器。 SQL_ASSEMBLY_DEPENDENCIES 架构行集的定义见下表：
| 列名称 | 类型 | 说明 |
|---|---|---|
| ASSEMBLY_CATALOG | DBTYPE_WSTR | 包含该类型的程序集的目录名称。 |
| ASSEMBLY_SCHEMA | DBTYPE_WSTR | 包含该类型的程序集的架构名称或所有者名称。 尽管程序集的作用域为数据库而不是架构，但它们仍具有在此所反映的所有者。 |
| ASSEMBLY_ID | DBTYPE_UI4 | 程序集的对象 ID。 |
| REFERENCED_ASSEMBLY_ID | DBTYPE_UI4 | 所引用的程序集的对象 ID。 |
SQL_USER_TYPES 架构行集
适用于 SQL Server 的 OLE DB 驱动程序公开一个新的架构行集 SQL_USER_TYPES，它描述了何时添加指定服务器所注册的 UDT。 UDT_SERVER 必须由调用方指定为 DBTYPE_WSTR，但它在该行集中不存在。 在下表中定义 SQL_USER_TYPES 架构行集。
| 列名称 | 类型 | 说明 |
|---|---|---|
| UDT_CATALOGNAME | DBTYPE_WSTR | 对于 UDT 列，此属性是一个字符串，它指定定义 UDT 的目录的名称。 |
| UDT_SCHEMANAME | DBTYPE_WSTR | 对于 UDT 列，此属性是一个字符串，它指定定义 UDT 的架构的名称。 |
| UDT_NAME | DBTYPE_WSTR | 包含 UDT 类的程序集的名称。 |
| UDT_ASSEMBLY_TYPENAME | DBTYPE_WSTR | 完整类型名称 (AQN) 包括带有命名空间前缀（如果适用）的类型名称。 |
COLUMNS 架构行集
COLUMNS 架构行集添加了以下列：
| 列名称 | 类型 | 说明 |
|---|---|---|
| SS_UDT_CATALOGNAME | DBTYPE_WSTR | 对于 UDT 列，此属性是一个字符串，它指定定义 UDT 的目录的名称。 |
| SS_UDT_SCHEMANAME | DBTYPE_WSTR | 对于 UDT 列，此属性是一个字符串，它指定定义 UDT 的架构的名称。 |
| SS_UDT_NAME | DBTYPE_WSTR | UDT 的名称 |
| SS_UDT_ASSEMBLY_TYPENAME | DBTYPE_WSTR | 完整类型名称 (AQN) 包括带有命名空间前缀（如果适用）的类型名称。 |
OLE DB 属性集的添加和更改内容
OLE DB Driver for SQL Server 在许多核心 OLE DB 属性集中添加了新值或进行了更改。
DBPROPSET_SQLSERVERPARAMETER 属性集
为通过 OLE DB 支持 UDT，适用于 SQL Server 的 OLE DB 驱动程序实现新的 DBPROPSET_SQLSERVERPARAMETER 属性集，该属性集包含以下值：
| 名称 | Type | 说明 |
|---|---|---|
| SSPROP_PARAM_UDT_CATALOGNAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 对于 UDT 参数，此属性是一个字符串，它指定定义用户定义类型的目录的名称。 |
| SSPROP_PARAM_UDT_SCHEMANAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 对于 UDT 参数，此属性是一个字符串，它指定定义用户定义类型的架构的名称。 |
| SSPROP_PARAM_UDT_NAME | DBTYPE_WSTR | 由三部分组成的名称标识符。 对于 UDT 列，此属性是一个字符串，它指定仅由一个部分组成的用户定义类型名称。 |
SSPROP_PARAM_UDT_NAME 是必需的。 SSPROP_PARAM_UDT_CATALOGNAME 和 SSPROP_PARAM_UDT_SCHEMANAME 是可选的。 如果任何属性指定有误，将返回 DB_E_ERRORSINCOMMAND。 如果未指定 SSPROP_PARAM_UDT_CATALOGNAME 和 SSPROP_PARAM_UDT_SCHEMANAME，则必须在定义表的同一数据库和架构中定义 UDT。 如果 UDT 定义没有位于表所在的架构中（但位于相同的数据库中），则必须指定 SSPROP_PARAM_UDT_SCHEMANAME。 如果 UDT 定义位于不同的数据库中，则必须指定 SSPROP_PARAM_UDT_CATALOGNAME 和 SSPROP_PARAM_UDT_SCHEMANAME。
DBPROPSET_SQLSERVERCOLUMN 属性集
为支持在 ITableDefinition 接口中创建表，适用于 SQL Server 的 OLE DB 驱动程序向 DBPROPSET_SQLSERVERCOLUMN 属性集添加了如下三个新列 。
| 名称 | 说明 | 类型 | 说明 |
|---|---|---|---|
| SSPROP_COL_UDT_CATALOGNAME | UDT_CATALOGNAME | VT_BSTR | 对于 DBTYPE_UDT 类型的列，此属性是一个字符串，它指定定义 UDT 的目录的名称。 |
| SSPROP_COL_UDT_SCHEMANAME | UDT_SCHEMANAME | VT_BSTR | 对于 DBTYPE_UDT 类型的列，此属性是一个字符串，它指定定义 UDT 的架构的名称。 |
| SSPROP_COL_UDT_NAME | UDT_NAME | VT_BSTR | 对于 DBTYPE_UDT 类型的列，此属性是一个字符串，它指定仅由一个部分组成的 UDT 名称。 对于其他列类型，此属性返回空字符串。 |
备注
UDT 不出现在 PROVIDER_TYPES 架构行集中。 所有列都具有读写访问权限。
ADO 将通过使用“说明”列中的相应条目引用这些属性。
SSPROP_COL_UDTNAME 是必需的。 SSPROP_COL_UDT_CATALOGNAME 和 SSPROP_COL_UDT_SCHEMANAME 是可选的。 如果任何属性指定有误，将返回 DB_E_ERRORSINCOMMAND 。
如果既未指定 SSPROP_COL_UDT_CATALOGNAME 也未指定 SSPROP_COL_UDT_SCHEMANAME，则必须在定义表的同一数据库和架构中定义 UDT。
如果 UDT 定义没有与表位于同一架构中（但位于同一数据库中），则必须指定 SSPROP_COL_UDT_SCHEMANAME。
如果 UDT 定义位于不同的数据库中，则必须指定 SSPROP_COL_UDT_CATALOGNAME 和 SSPROP_COL_UDT_SCHEMANAME。
OLE DB 接口的添加和更改内容
OLE DB Driver for SQL Server 在许多核心 OLE DB 接口中添加了新值或进行了更改。
ISSCommandWithParameters 接口
为通过 OLE DB 支持 UDT，适用于 SQL Server 的 OLE DB 驱动程序字符串实现了大量更改，包括添加 ISSCommandWithParameters 接口 。 这一新接口继承自核心 OLE DB 接口 ICommandWithParameters 。 除了从 ICommandWithParameters 继承的三个方法（GetParameterInfo、MapParameterNames 和 SetParameterInfo）之外，ISSCommandWithParameters 还提供 GetParameterProperties 和 SetParameterProperties 方法，它们用于处理服务器特定的数据类型 。
注意
ISSCommandWithParameters 接口也利用新的 SSPARAMPROPS 结构 。
IColumnsRowset 接口
除了 ISSCommandWithParameters 接口，适用于 SQL Server 的 OLE DB 驱动程序还向调用 IColumnsRowset::GetColumnRowset 方法所返回的行集添加了下列新值 。
| 列名 | 类型 | 说明 |
|---|---|---|
| DBCOLUMN_SS_UDT_CATALOGNAME | DBTYPE_WSTR | UDT 目录名称标识符。 |
| DBCOLUMN_SS_UDT_SCHEMANAME | DBTYPE_WSTR | UDT 架构名称标识符。 |
| DBCOLUMN_SS_UDT_NAME | DBTYPE_WSTR | UDT 名称标识符。 |
| DBCOLUMN_SS_ASSEMBLY_TYPENAME | DBTYPE_WSTR | 程序集限定名，其中包括 CLR 引用所需的类型名称和所有程序集标识。 |
通过查看上表指定的已添加的 UDT 元数据，可在 DBCOLUMN_TYPE 设置为 DBTYPE_UDT 时将服务器 UDT 列与其他二进制类型区分开。 如果该数据不完整，服务器类型为 UDT。 对于非 UDT 服务器类型，这些列的返回结果始终为 NULL。
另请参阅
适用于 SQL Server 的 OLE DB 驱动程序功能
ISSCommandWithParameters (OLE DB)
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈