Compartir a través de

Tipos definidos por el usuario de CLR grandes (OLE DB)

  • Artículo

En este tema se describen los cambios realizados en OLE DB en SQL Server Native Client para admitir tipos definidos por el usuario (UDT) de Common Language Runtime (CLR) grandes.

Para obtener más información acerca de la compatibilidad con UDT CLR grandes en SQL Server Native Client, vea Tipos definidos por el usuario de CLR grandes. Para obtener un ejemplo, vea Usar UDT de CLR de gran tamaño (OLE DB).

Formato de datos

SQL Server Native Client utiliza ~0 para representar la longitud de valores de tamaño ilimitado en tipos de objeto grandes (LOB). ~0 también representa el tamaño de UDT CLR superiores a 8.000 bytes.

En la tabla siguiente se muestra la asignación de tipos de datos en parámetros y conjuntos de filas:

Tipo de datos de SQL Server

Tipo de datos de OLE DB

Diseño de memoria

Valor

UDT CLR

DBTYPE_UDT

BYTE[](matriz de bytes)

132 (oledb.h)

Los valores UDT se representan como matrices de bytes. Se admiten conversiones a cadenas hexadecimales y desde cadenas hexadecimales. Los valores literales se representan como cadenas hexadecimales con el prefijo "0x". Una cadena hexadecimal es la representación textual de datos binarios en base 16. Un ejemplo sería una conversión del tipo de servidor varbinary(10) a DBTYPE_STR, que genera una representación hexadecimal de 20 caracteres donde cada par de caracteres representa un único byte.

Propiedades de parámetros

El conjunto de propiedades DBPROPSET_SQLSERVERPARAMETER admite UDT a través de OLE DB. Para obtener más información, vea Usar tipos definidos por el usuario.

Propiedades de columna

El conjunto de propiedades DBPROPSET_SQLSERVERCOLUMN admite la creación de tablas a través de OLE DB. Para obtener más información, vea Usar tipos definidos por el usuario.

Asignación de tipos de datos en ITableDefinition::CreateTable

La información siguiente se usa en estructuras DBCOLUMNDESC utilizadas por ITableDefinition::CreateTable cuando se requieren columnas UDT:

Tipo de datos de OLE DB (wType)

pwszTypeName

Tipo de datos de SQL Server

rgPropertySets

DBTYPE_UDT

No se tiene en cuenta

UDT

Debe incluir un conjunto de propiedades DBPROPSET_SQLSERVERCOLUMN.

ICommandWithParameters::GetParameterInfo

La información que se devuelve en la estructura DBPARAMINFO a través de prgParamInfo es la que se indica a continuación:

Tipo de parámetro

wType

ulParamSize

bPrecision

bScale

dwFlags DBPARAMFLAGS_ISLONG

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

"DBTYPE_UDT"

n

no definido

no definido

clear

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

"DBTYPE_UDT"

~0

no definido

no definido

set

ICommandWithParameters::SetParameterInfo

La información que se proporciona en la estructura DBPARAMBINDINFO debe cumplir lo siguiente:

Tipo de parámetro

pwszDataSourceType

ulParamSize

bPrecision

bScale

dwFlags DBPARAMFLAGS_ISLONG

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

DBTYPE_UDT

n

no se tiene en cuenta

no se tiene en cuenta

Debe establecerse si el parámetro va a pasarse utilizando DBTYPE_IUNKNOWN.

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

DBTYPE_UDT

~0

no se tiene en cuenta

no se tiene en cuenta

no se tiene en cuenta

ISSCommandWithParameters

Las aplicaciones utilizan ISSCommandWithParameters para obtener y establecer las propiedades de parámetros que se definen en la sección Propiedades de parámetros.

IColumnsRowset::GetColumnsRowset

Éstas son las columnas que se devuelven:

Tipo de columna

DBCOLUMN_TYPE

DBCOLUMN_COLUMNSIZE

DBCOLUMN_PRECISION

DBCOLUMN_SCALE

DBCOLUMN_FLAGS_ISLONG

DBCOLUMNS_ISSEARCHABLE

DBCOLUMN_OCTETLENGTH

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

DBTYPE_UDT

n

NULL

NULL

Clear

DB_ALL_EXCEPT_LIKE

n

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

DBTYPE_UDT

~0

NULL

NULL

Set

DB_ALL_EXCEPT_LIKE

0

También se definen las columnas siguientes para los UDT:

Identificador de columna

Tipo

Descripción

DBCOLUMN_UDT_CATALOGNAME

DBTYPE_WSTR

Para las columnas UDT, nombre del catálogo donde se define el UDT.

DBCOLUMN_UDT_SCHEMANAME

DBTYPE_WSTR

Para las columnas UDT, nombre del esquema donde se define el UDT.

DBCOLUMN_UDT_NAME

DBTYPE_WSTR

Para las columnas UDT, nombre de una sola parte del UDT.

DBCOLUMN_ASSEMBLY_TYPENAME

DBTYPE_WSTR

Para las columnas UDT, nombre de tipo completo del UDT. El nombre completo del tipo de ensamblado permite crear instancias de un objeto de ese tipo con el método Type.GetType.

IColumnsInfo::GetColumnInfo

La información que se devuelve en la estructura DBCOLUMNINFO es la siguiente:

Tipo de parámetro

wType

ulColumnSize

bPrecision

bScale

dwFlags

DBCOLUMNFLAGS_ISLONG

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

DBTYPE_UDT

n

~0

~0

Borrar

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

DBTYPE_UDT

~0

~0

~0

Set

Conjunto de filas COLUMNS (conjuntos de filas de esquema)

Para los tipos UDT se devuelven los siguientes valores de columna:

Tipo de columna

DATA_TYPE

COLUMN_FLAGS, DBCOLUMFLAGS_ISLONG

CHARACTER_OCTET_LENGTH

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

DBTYPE_UDT

Clear

n

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

DBTYPE_UDT

Set

0

También se definen las siguientes columnas adicionales para los UDT:

Identificador de columna

Tipo

Descripción

SS_UDT_CATALOGNAME

DBTYPE_WSTR

Para las columnas UDT, nombre del catálogo donde se define el UDT.

SS_UDT_SCHEMANAME

DBTYPE_WSTR

Para las columnas UDT, nombre del esquema donde se define el UDT.

SS_UDT_NAME

DBTYPE_WSTR

Para las columnas UDT, nombre de una sola parte del UDT.

SS_ASSEMBLY_TYPENAME

DBTYPE_WSTR

Para las columnas UDT, se trata del nombre de tipo completo del UDT. El nombre completo del tipo de ensamblado permite crear instancias de un objeto de ese tipo con el método Type.GetType.

Con respecto al conjunto de filas PROCEDURE_PARAMETERS, DATA_TYPE contiene los mismos valores que el conjunto de filas de esquema COLUMNS, y TYPE_NAME contiene UDT. También se definen las mismas columnas adicionales.

Los tipos definidos por el usuario no aparecerán en el conjunto de filas de esquema PROVIDER_TYPES.

Enlaces y conversiones

Tipo de datos de enlace

UDT a servidor

No UDT a servidor

UDT desde servidor

No UDT desde servidor

DBTYPE_UDT

Compatible (5)

Error (1)

Compatible (5)

Error (4)

DBTYPE_BYTES

Compatible (5)

N/D

Compatible (5)

N/D

DBTYPE_WSTR

Compatible (2), (5)

N/D

Compatible (3), (5), (6)

N/D

DBTYPE_BSTR

Compatible (2), (5)

N/D

Compatible (3), (5)

N/D

DBTYPE_STR

Compatible (2), (5)

N/D

Compatible (3), (5)

N/D

DBTYPE_IUNKNOWN

Compatible (6)

N/D

Compatible (6)

N/D

DBTYPE_VARIANT (VT_UI1 | VT_ARRAY)

Compatible (5)

N/D

Compatible (3), (5)

N/D

DBTYPE_VARIANT (VT_BSTR)

Compatible (2), (5)

N/D

N/D

N/D

Clave de los símbolos

Símbolo

Significado

1

Si se especifica un tipo de servidor distinto de DBTYPE_UDT con ICommandWithParameters::SetParameterInfo y el tipo de descriptor de acceso es DBTYPE_UDT, se produce un error cuando se ejecuta la instrucción. El error será DB_E_ERRORSOCCURRED y el estado del parámetro será DBSTATUS_E_BADACCESSOR.

Es un error especificar un parámetro de tipo UDT en un parámetro de servidor que no es un UDT.

2

Los datos se convierten de una cadena hexadecimal a datos binarios.

3

Los datos se convierten de datos binarios a una cadena hexadecimal.

4

Puede producirse una validación cuando se utiliza CreateAccessor o GetNextRows. El error es DB_E_ERRORSOCCURRED. El estado del enlace se establece en DBBINDSTATUS_UNSUPPORTEDCONVERSION.

5

Puede utilizarse BY_REF.

6

Los parámetros UDT pueden enlazarse como DBTYPE_IUNKNOWN en DBBINDING. El enlace a DBTYPE_IUNKNOWN indica que la aplicación desea procesar los datos como un flujo mediante la interfaz ISequentialStream. Cuando un consumidor especifica wType en un enlace como un tipo DBTYPE_IUNKNOWN y la columna o el parámetro de salida correspondiente del procedimiento almacenado es un UDT, SQL Server Native Client devuelve ISequentialStream. Para un parámetro de entrada, SQL Server Native Client consultará la interfaz ISequentialStream.

En el caso de UDT grandes, puede decidir no enlazar la longitud de los datos UDT mientras utiliza el enlace DBTYPE_IUNKNOWN. Sin embargo, la longitud debe enlazarse en los UDT pequeños. Un parámetro DBTYPE_UDT puede especificarse como un UDT grande si se cumplen una o varias de las siguientes condiciones:

  • ulParamParamSize es ~0.

  • DBPARAMFLAGS_ISLONG está establecido en la estructura DBPARAMBINDINFO.

Para los datos de fila, el enlace DBTYPE_IUNKNOWN solamente se permite en los UDT grandes. Puede averiguar si una columna es un tipo UDT grande utilizando el método IColumnsInfo::GetColumnInfo en la interfaz IColumnsInfo del objeto Command o Rowset. Una columna DBTYPE_UDT es una columna UDT grande si se cumplen una o varias de las siguientes condiciones:

  • La marca DBCOLUMNFLAGS_ISLONG está establecida en el miembro dwFlags de la estructura DBCOLUMNINFO.

  • El miembro ulColumnSize de DBCOLUMNINFO es ~0.

DBTYPE_NULL y DBTYPE_EMPTY pueden enlazarse en parámetros de entrada, pero no en parámetros de salida ni en resultados. Cuando se enlazan en parámetros de entrada, el estado debe establecerse en DBSTATUS_S_ISNULL para DBTYPE_NULL o DBSTATUS_S_DEFAULT para DBTYPE_EMPTY. DBTYPE_BYREF no puede utilizarse con DBTYPE_NULL ni con DBTYPE_EMPTY.

DBTYPE_UDT también puede convertirse a DBTYPE_EMPTY y DBTYPE_NULL. Sin embargo, DBTYPE_NULL y DBTYPE_EMPTY no pueden convertirse a DBTYPE_UDT. Este comportamiento es coherente con el de DBTYPE_BYTES. ISSCommandWithParameters se utiliza para procesar UDT como parámetros.

Las conversiones de datos que proporcionan los servicios principales de OLE DB (IDataConvert) no son aplicables a DBTYPE_UDT.

No se admite ningún otro enlace.

Comparaciones en IRowsetFind

En los tipos UDT, solo se admiten las siguientes comparaciones:

  • EQ

  • NE

  • IGNORE

Si se intenta realizar cualquier otra comparación, se devuelve DB_E_BADCOMPAREOP.

Compatibilidad de BCP con los UDT

Los valores UDT pueden importarse y exportarse solo como valores de caracteres o binarios.

Comportamiento del cliente de nivel inferior en los UDT

Los UDT están sujetos a la asignación de tipos con clientes de nivel inferior, tal y como se indica a continuación:

Versión del cliente

DBTYPE_UDT

(longitud menor o igual a 8.000 bytes)

DBTYPE_UDT

(longitud mayor que 8.000 bytes)

SQL Server 2005

UDT

varbinary(max)

SQL Server 2008 y posterior

UDT

UDT

Cuando DataTypeCompatibility (SSPROP_INIT_DATATYPECOMPATIBILITY) se establece en "80", los tipos UDT grandes se muestran a los clientes del mismo modo que se muestran a los clientes de nivel inferior.

Vea también

Conceptos

Tipos definidos por el usuario de CLR grandes