Asignar tipos de datos en conjuntos de filas y parámetros

En conjuntos de filas y como valores de parámetro, el proveedor OLE DB de SQL Server Native Client representa los datos de SQL Server mediante los siguientes tipos de datos definidos por OLE DB, notificados en las funciones IColumnsInfo::GetColumnInfo e ICommandWithParameters::GetParameterInfo. 

El proveedor OLE DB de SQL Server Native Client admite conversiones de datos solicitadas por el consumidor, tal como se muestra en la ilustración.

Los objetos sql_variant pueden contener datos de cualquier tipo de datos de SQL Server excepto text, ntext, image, varchar(max), nvarchar(max), varbinary(max), xml, timestamp y los tipos definidos por el usuario de Common Language Runtime (CLR) de Microsoft .NET Framework. Una instancia de datos sql_variant no puede tener sql_variant como tipo de datos base subyacente. Por ejemplo, la columna puede contener valores smallint en algunas filas, valores float en otras filas y valores char/nchar en el resto.

[!NOTA]

El tipo de datos sql_variant es similar al tipo de datos Variant de Microsoft Visual Basic® y DBTYPE_VARIANT, DBTYPE_SQLVARIANT de OLEDB.

Cuando los datos sql_variant se capturan como DBTYPE_VARIANT, se incluyen en una estructura VARIANT en el búfer. Sin embargo, es posible que los subtipos de la estructura VARIANT no se asignen a los subtipos definidos en el tipo de datos sql_variant. Los datos sql_variant se deben capturar en este caso como DBTYPE_SQLVARIANT para que todos los subtipos coincidan.

Tipo de datos DBTYPE_SQLVARIANT

Para admitir el tipo de datos sql_variant, el proveedor OLE DB de SQL Server Native Client expone un tipo de datos específico del proveedor denominado DBTYPE_SQLVARIANT. Cuando los datos sql_variant se capturan como DBTYPE_SQLVARIANT, se almacenan en una estructura SSVARIANT específica del proveedor. La estructura SSVARIANT contiene todos los subtipos que coinciden con los subtipos del tipo de datos sql_variant.

La propiedad SSPROP_ALLOWNATIVEVARIANT de la sesión también debe estar establecida en TRUE.

Propiedad SSPROP_ALLOWNATIVEVARIANT específica del proveedor

Al capturar los datos, puede especificar explícitamente qué clase de tipo de datos se debería devolver para una columna o para un parámetro. También se puede utilizar IColumnsInfo para obtener la información de columna y utilizarla al crear el enlace. Cuando se utiliza IColumnsInfo para obtener información de columna con fines de enlace, si la propiedad SSPROP_ALLOWNATIVEVARIANT de sesión es FALSE (valor predeterminado), en las columnas sql_variant se devuelve DBTYPE_VARIANT. Si la propiedad SSPROP_ALLOWNATIVEVARIANT es FALSE, no se admite DBTYPE_SQLVARIANT. Si la propiedad SSPROP_ALLOWNATIVEVARIANT está establecida en TRUE, el tipo de columna se devuelve como DBTYPE_SQLVARIANT, en cuyo caso el búfer contendrá la estructura SSVARIANT. Al capturar datos sql_variant como DBTYPE_SQLVARIANT, la propiedad SSPROP_ALLOWNATIVEVARIANT de sesión debe estar establecida en TRUE.

La propiedad SSPROP_ALLOWNATIVEVARIANT forma parte del conjunto de propiedades DBPROPSET_SQLSERVERSESSION específico del proveedor y es una propiedad de sesión.

DBTYPE_VARIANT se aplica a todos los demás proveedores OLE DB.

SSPROP_ALLOWNATIVEVARIANT

SSPROP_ALLOWNATIVEVARIANT es una propiedad de sesión y forma parte del conjunto de propiedades DBPROPSET_SQLSERVERSESSION.

Vea también

Conceptos

Tipos de datos (OLE DB)