COLUMNPROPERTY (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database SíInstancia administrada de Azure SQL

Esta función devuelve información de la columna o el parámetro.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

COLUMNPROPERTY ( id , column , property )   

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

id
Una expresión que contiene el identificador (Id.) de la tabla o del procedimiento.

column
Una expresión que contiene el nombre de la columna o del parámetro.

property
Para el argumento id, el argumento propiedad especifica el tipo de información que devolverá la función COLUMNPROPERTY. El argumento propiedad puede tener uno de estos valores:

Value Descripción Valor devuelto
AllowsNull Permite valores NULL. 1: TRUE

0: FALSE

NULL: entrada no válida
ColumnId Valor del Id. de columna correspondiente a sys.columns.column_id. Identificador de columna

Nota: Cuando se consultan varias columnas, pueden aparecer espacios en la secuencia de valores de los Id. de columna.
FullTextTypeColumn El valor TYPE COLUMN de la tabla que contiene la información del tipo de documento de la columna. Id. de TYPE COLUMN de texto completo para la expresión de nombre de columna que se pasa como segundo parámetro de esta función.
GeneratedAlwaysType Es el valor de columna generado por el sistema. Corresponde a sys.columns.generated_always_type Válido para : SQL Server 2016 (13.x) y versiones posteriores.

0: no siempre se genera.

1: se genera siempre como comienzo de fila.

2: se genera siempre como fin de fila.
IsColumnSet La columna es un conjunto de columnas. Para obtener más información, vea Usar conjuntos de columnas. 1: TRUE

0: FALSE

NULL: entrada no válida
IsComputed La columna es una columna calculada. 1: TRUE

0: FALSE

NULL: entrada no válida
IsCursorType El parámetro de procedimiento es del tipo CURSOR. 1: TRUE

0: FALSE

NULL: entrada no válida
IsDeterministic La columna es determinista. Esta propiedad solo se aplica a columnas calculadas y columnas de vistas. 1: TRUE

0: FALSE

NULL: entrada no válida No es una columna calculada o una columna de vista.
IsFulltextIndexed La columna se registra para la indización de texto completo. 1: TRUE

0: FALSE

NULL: entrada no válida
IsHidden Es el valor de columna generado por el sistema. Corresponde a sys.columns.is_hidden Válido para : SQL Server 2019 (15.x) y versiones posteriores.

0: no está oculto

1: oculto
IsIdentity La columna utiliza la propiedad IDENTITY. 1: TRUE

0: FALSE

NULL: entrada no válida
IsIdNotForRepl La columna comprueba el valor IDENTITY_INSERT. 1: TRUE

0: FALSE

NULL: entrada no válida
IsIndexable La columna se puede indizar. 1: TRUE

0: FALSE

NULL: entrada no válida
IsOutParam El parámetro de procedimiento es un parámetro de salida. 1: TRUE

0: FALSE

NULL: entrada no válida
IsPrecise La columna es precisa. Esta propiedad solo se aplica a columnas deterministas. 1: TRUE

0: FALSE

NULL: entrada no válida No es una columna determinista
IsRowGuidCol La columna es del tipo de datos uniqueidentifier y se define con la propiedad ROWGUIDCOL. 1: TRUE

0: FALSE

NULL: entrada no válida
IsSparse La columna es una columna dispersa. Para obtener más información, vea Usar columnas dispersas. 1: TRUE

0: FALSE

NULL: entrada no válida
IsSystemVerified El Motor de base de datos puede comprobar las propiedades de determinismo y precisión de la columna. Esta propiedad solo se aplica a columnas calculadas y columnas de vistas. 1: TRUE

0: FALSE

NULL: entrada no válida
IsXmlIndexable La columna XML se puede utilizar en un índice XML. 1: TRUE

0: FALSE

NULL: entrada no válida
Precisión Longitud del tipo de datos de la columna o el parámetro. Longitud del tipo de datos especificado para la columna

-1: xml o tipos de valor grandes

NULL: entrada no válida
Escala Escala del tipo de datos de la columna o del parámetro. El valor de escala.

NULL: entrada no válida
StatisticalSemantics La columna está habilitada para la indización semántica. 1: TRUE

0: FALSE
SystemDataAccess La columna se deriva de una función que tiene acceso a los datos de los catálogos del sistema o de las tablas virtuales del sistema de SQL Server. Esta propiedad solo se aplica a columnas calculadas y columnas de vistas. 1: TRUE (indica acceso de solo lectura)

0: FALSE

NULL: entrada no válida
UserDataAccess La columna se deriva de una función que tiene acceso a los datos de las tablas de usuario, incluidas las vistas y tablas temporales, almacenadas en la instancia local de SQL Server. Esta propiedad solo se aplica a columnas calculadas y columnas de vistas. 1: TRUE (indica acceso de solo lectura)

0: FALSE

NULL: entrada no válida
UsesAnsiTrim ANSI_PADDING se estableció em ON al crear la tabla. Esta propiedad solo se aplica a columnas o parámetros de tipo char o varchar. 1: TRUE

0: FALSE

NULL: entrada no válida

Tipos de valores devueltos

int

Excepciones

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

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 COLUMNPROPERTY, es posible que devuelvan NULL si el usuario no tiene el permiso correcto para el objeto. Vea Configuración de visibilidad de los metadatos para obtener más información.

Observaciones

Cuando se comprueba la propiedad determinista de una columna, primero se comprueba si se trata de una columna calculada. El argumento IsDeterministic devuelve NULL para las columnas no calculadas. Las columnas calculadas se pueden especificar como columnas de índice.

Ejemplos

En este ejemplo se devuelve la longitud de la columna LastName.

USE AdventureWorks2012;  
GO  
SELECT COLUMNPROPERTY( OBJECT_ID('Person.Person'),'LastName','PRECISION')AS 'Column Length';  
GO  

El conjunto de resultados es el siguiente:

Column Length
-------------
50

Vea también

Funciones de metadatos (Transact-SQL)
TYPEPROPERTY (Transact-SQL)