COL_LENGTH (Transact-SQL)COL_LENGTH (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Esta función devuelve la longitud definida de una columna, en bytes.This function returns the defined length of a column, in bytes.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

COL_LENGTH ( 'table' , 'column' )   

ArgumentosArguments

' table '' table '
El nombre de la tabla para la que se quiere determinar la información de longitud de columna.The name of the table whose column length information we want to determine. table es una expresión de tipo nvarchar.table is an expression of type nvarchar.

' column '' column '
El nombre de la columna cuya longitud se quiere determinar.The column name whose length we want to determine. column es una expresión de tipo nvarchar.column is an expression of type nvarchar.

Tipo de valor devueltoReturn type

smallintsmallint

ExcepcionesExceptions

Devuelve NULL si se produce un error o si el autor de la llamada no tiene el permiso correcto para ver el objeto.Returns NULL on error, or if a caller does not have the correct permission to view the object.

En SQL ServerSQL Server, un usuario solo puede ver los metadatos de los elementos protegibles que posea o para los que se le haya concedido permiso.In SQL ServerSQL Server, a user can only view the metadata of securables that the user owns, or on which the user has been granted permission. Esto significa que las funciones integradas de emisión de metadatos como COL_LENGTH es posible que devuelvan NULL, si el usuario no tiene el permiso correcto para el objeto.This means that metadata-emitting, built-in functions such as COL_LENGTH might return NULL, if the user does not have correct permission on the object. Vea Configuración de visibilidad de los metadatos para obtener más información.See Metadata Visibility Configuration for more information.

NotasRemarks

Para las columnas de tipo varchar declaradas con el especificador max (varchar(max) ), COL_LENGTH devuelve el valor -1.For varchar columns declared with the max specifier (varchar(max)), COL_LENGTH returns the value -1.

EjemplosExamples

En este ejemplo se muestran los valores devueltos para una columna de tipo varchar(40) y una columna de tipo nvarchar(40):This example shows the return values for a column of type varchar(40) and a column of type 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.Here is the result set.

VarChar     NVarChar  
40          80  

Vea tambiénSee also

Expresiones (Transact-SQL)Expressions (Transact-SQL)
Funciones de metadatos (Transact-SQL)Metadata Functions (Transact-SQL)
COL_NAME (Transact-SQL)COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)COLUMNPROPERTY (Transact-SQL)