Compartir a través de

COL_LENGTH (Transact-SQL)

  • Artículo

Actualizado: 17 de julio de 2006

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.

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

Notas

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

Tipo devuelto

smallint

Ejemplos

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

Vea también

Referencia

Expresiones (Transact-SQL)
Funciones de metadatos (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)

Otros recursos

Modificar las propiedades de una columna

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006
Contenido nuevo:
  • Se ha agregado la sección Excepciones.