Compartir a través de

  • Artículo

COL_LENGTH (Transact-SQL)

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

Icono de vínculo a temasConvenciones 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 y Solucionar problemas 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 AdventureWorks2008R2;
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.

VarChar     NVarChar
40          80