sql_variant (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Tipo de datos que almacena valores de varios tipos de datos admitidos en SQL Server.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sql_variant  

Comentarios

sql_variant puede usarse en columnas, parámetros, variables y los valores devueltos de las funciones definidas por el usuario. sql_variant permite que estos objetos de base de datos admitan valores de otros tipos de datos.

Una columna de tipo sql_variant puede contener filas de tipos de datos diferentes. Por ejemplo, una columna definida como sql_variant puede almacenar valores int, binario y char.

sql_variant puede tener una longitud máxima de 8016 bytes. Esto incluye la información y el valor de tipo base. La longitud máxima del tipo base real es 8.000 bytes.

Un tipo de datos sql_variant debe convertirse en su valor de tipo de datos base antes de poder tomar parte en operaciones como la adición y la sustracción.

Se puede asignar un valor predeterminado a sql_variant. Este tipo de datos también puede incluir NULL como valor subyacente, aunque estos valores NULL no dispondrán de un tipo base asociado. Además, sql_variant no puede tener otro sql_variant como su tipo base.

Una clave única, primaria o externa puede incluir columnas de tipo sql_variant, aunque la longitud total de los valores de datos que integran la clave de una fila determinada no debe superar la longitud máxima de un índice. Ésta es de 900 bytes.

Una tabla puede constar de cualquier número de columnas sql_variant.

No se puede usar sql_variant en CONTAINSTABLE y FREETEXTTABLE.

ODBC no es totalmente compatible con sql_variant. Por tanto, las columnas de consultas de sql_variant se devuelven como datos binarios con el proveedor OLE DB de Microsoft para ODBC (MSDASQL). Por ejemplo, una columna sql_variant que contiene los datos de la cadena de caracteres 'PS2091' se devuelve como 0x505332303931.

Comparar los valores de sql_variant

El tipo de datos sql_variant pertenece a la parte superior de la lista de jerarquías de tipos de datos para conversión. En las comparaciones de sql_variant, el orden de la jerarquía del tipo de datos SQL Server se agrupa en familias de tipos de datos.

Las comparaciones de sql_variant siguen estas reglas:

• Cuando se comparan valores sql_variant de distintos tipos de datos base y los tipos de datos base están en familias de tipos de datos diferentes, el valor cuya familia de tipo de datos ocupa una posición superior en el gráfico de jerarquía se considera el mayor de los dos valores.
• Cuando se comparan valores sql_variant de distintos tipos de datos base y los tipos de datos base están en la misma familia de tipos de datos, el valor cuyo tipo de datos base ocupa una posición inferior en el gráfico de jerarquía se convierte implícitamente al otro tipo de datos y, después, se realiza la comparación.
• Cuando se comparan valores sql_variant de los tipos de datos char, varchar, nchar o nvarchar, en primer lugar se comparan sus intercalaciones por los siguientes criterios: LCID, versión de LCID, marcas de comparación e identificador de orden. Cada uno de estos criterios se compara como valores enteros y en el orden enumerado. Si todos estos criterios son iguales, se comparan los valores reales de las cadenas según la intercalación.

Convertir datos sql_variant

Cuando se usa el tipo de datos sql_variant, SQL Server admite conversiones implícitas de objetos con otros tipos de datos al tipo sql_variant, pero SQL Server no admite conversiones implícitas de datos sql_variant a un objeto con otro tipo de datos.

Restricciones

En la lista siguiente se muestran los tipos de valores que no se pueden almacenar mediante sql_variant:

• datetimeoffset¹
• geography
• geometry
• hierarchyid
• image
• ntext
• nvarchar(max)
• rowversion (timestamp)
• text
• ntext
• varbinary(max)
• Tipos definidos por el usuario
• xml

¹ SQL Server 2012 y las versiones posteriores no restringen datetimeoffset.

Ejemplos

A. Usar un tipo de datos sql_variant en una tabla

En este ejemplo se crea una tabla con varios tipos de datos sql_variant. Luego se recupera la información de SQL_VARIANT_PROPERTY sobre el valor colA de 46279.1, donde colB =1689, teniendo en cuenta que tableA tiene colA que es del tipo sql_variant y colB.

CREATE TABLE tableA(colA sql_variant, colB INT)  
INSERT INTO tableA values ( CAST(46279.1 as decimal(8,2)), 1689)  
SELECT   SQL_VARIANT_PROPERTY(colA,'BaseType') AS 'Base Type',  
         SQL_VARIANT_PROPERTY(colA,'Precision') AS 'Precision',  
         SQL_VARIANT_PROPERTY(colA,'Scale') AS 'Scale'  
FROM      tableA  
WHERE     colB = 1689  

El conjunto de resultados es el siguiente: Tenga en cuenta que cada uno de estos tres valores es sql_variant.

Base Type    Precision    Scale  
---------    ---------    -----  
decimal      8           2  
  
(1 row(s) affected)  

B. Usar un tipo de datos sql_variant como una variable

En este ejemplo se crea una variable mediante el tipo de datos sql_variant y después se recupera información de SQL_VARIANT_PROPERTY sobre una variable denominada @v1.

DECLARE @v1 sql_variant;  
SET @v1 = 'ABC';  
SELECT @v1;  
SELECT SQL_VARIANT_PROPERTY(@v1, 'BaseType');  
SELECT SQL_VARIANT_PROPERTY(@v1, 'MaxLength');  

Consulte también

CAST y CONVERT (Transact-SQL)
SQL_VARIANT_PROPERTY (Transact-SQL)