Asignación de tipos de datos de SQL Server Native Client en conjuntos de filas y parámetros

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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.

Tipo de datos de SQL Server	Tipo de datos de OLE DB
bigint	DBTYPE_I8
binary	DBTYPE_BYTES
bit	DBTYPE_BOOL
char	DBTYPE_STR
datetime	DBTYPE_DBTIMESTAMP
datetime2	DBTYPE_DBTIME2
decimal	DBTYPE_NUMERIC
float	DBTYPE_R8
image	DBTYPE_BYTES
int	DBTYPE_I4
money	DBTYPE_CY
nchar	DBTYPE_WSTR
ntext	DBTYPE_WSTR
numeric	DBTYPE_NUMERIC
nvarchar	DBTYPE_WSTR
real	DBTYPE_R4
smalldatetime	DBTYPE_DBTIMESTAMP
smallint	DBTYPE_I2
smallmoney	DBTYPE_CY
sql_variant	DBTYPE_VARIANT, DBTYPE_SQLVARIANT
sysname	DBTYPE_WSTR
text	DBTYPE_STR
timestamp	DBTYPE_BYTES
tinyint	DBTYPE_UI1
UDT	DBTYPE_UDT
uniqueidentifier	DBTYPE_GUID
varbinary	DBTYPE_BYTES
varchar	DBTYPE_STR
XML	DBTYPE_XML

El proveedor OLE DB de SQL Server Native Client admite conversiones de datos solicitadas por el consumidor, 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 en Visual Basic y el DBTYPE_VARIANT, DBTYPE_SQLVARIANT en OLEDB.

Cuando los datos sql_variant se capturan como DBTYPE_VARIANT, se incluyen en una estructura VARIANT en el búfer. Pero 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 tienen que 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 usar IColumnsInfo para obtener la información de columna y usarla al crear el enlace. Cuando se usa 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 tiene que establecerse 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.

Id. de propiedad

Descripción

SSPROP_ALLOWNATIVEVARIANT

Tipo: VT_BOOL R (lectura) y W (escritura): Lectura/Escritura Valor predeterminado: VARIANT_FALSE Descripción: determina si los datos se capturan como están en DBTYPE_VARIANT o DBTYPE_SQLVARIANT. VARIANT_TRUE: el tipo de columna se devuelve como DBTYPE_SQLVARIANT, en cuyo caso el búfer contendrá la estructura SSVARIANT. VARIANT_FALSE: el tipo de columna se devuelve como DBTYPE_VARIANT y el búfer contendrá la estructura VARIANT.

Consulte también

Tipos de datos (OLE DB)