COL_LENGTH (Transact-SQL)

Actualizado: 17 de julio de 2006

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

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


COL_LENGTH ( 'table' , 'column' ) 

'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.

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

En SQL Server 2005, un usuario sólo puede ver los metadatos de asegurables 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.

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

smallint

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

USE AdventureWorks;
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;

Éste es el conjunto de resultados.

VarChar     NVarChar
40          80

Versión Historial

17 de julio de 2006

Contenido nuevo:
  • Se ha agregado la sección Excepciones.

Adiciones de comunidad

AGREGAR
Mostrar: