COL_LENGTH (Transact-SQL)

Artículo
06/18/2013

Devuelve la longitud definida, en bytes, de una columna.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

COL_LENGTH ( 'table' , 'column' )

Argumentos

' table '
Es el nombre de la tabla para la que hay que determinar la información de longitud de columna. table es una expresión de tipo nvarchar.
' column '
Es el nombre de la columna cuya longitud se desea determinar. column es una expresión de tipo nvarchar.

Tipo devuelto

smallint

Excepciones

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.

En SQL Server, un usuario solo puede ver los metadatos de elementos protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como COL_LENGTH, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, vea Configuración de visibilidad de los metadatos.

Comentarios

Para las columnas de tipo varchar declarado con el especificador max (varchar(max)), COL_LENGTH devuelve el valor –1.

Ejemplos

El siguiente ejemplo muestra los valores devueltos de una columna de tipo varchar(40) y una columna de tipo nvarchar(40).

USE AdventureWorks2012;
GO
CREATE TABLE t1(c1 varchar(40), c2 nvarchar(40) );
GO
SELECT COL_LENGTH('t1','c1')AS 'VarChar',
      COL_LENGTH('t1','c2')AS 'NVarChar';
GO
DROP TABLE t1;

El conjunto de resultados es el siguiente.