COL_NAME (Transact-SQL)COL_NAME (Transact-SQL)

SE APLICA A: síSQL Server síAzure SQL Database síAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

Esta función devuelve el nombre de una columna de tabla, en función de los valores de número de identificación de tabla y de columna de esa columna de tabla.This function returns the name of a table column, based on the table identification number and column identification number values of that table column.

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

SintaxisSyntax

COL_NAME ( table_id , column_id )  

ArgumentosArguments

table_idtable_id
El número de identificación de la tabla que contiene esa columna.The identification number of the table containing that column. El argumento id_tabla tiene un tipo de datos int.The table_id argument has an int data type.

column_idcolumn_id
El número de identificación de la columna.The identification number of the column. El argumento id_columna tiene un tipo de datos int.The column_id argument has an int data type.

Tipos de valores devueltosReturn types

sysnamesysname

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_NAME, es posible que devuelvan NULL si el usuario no tiene los permisos correctos para el objeto.This means that metadata-emitting, built-in functions such as COL_NAME might return NULL, if the user does not have correct permissions 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

Los parámetros table_id y column_id generan juntos una cadena de nombre de columna.The table_id and column_id parameters together produce a column name string.

Vea OBJECT_ID (Transact-SQL)para más información sobre cómo obtener los números de identificación de tablas y columnas.See OBJECT_ID (Transact-SQL) for more information about obtaining table and column identification numbers.

EjemplosExamples

En este ejemplo se devuelve el nombre de la primera columna de una tabla Employee de ejemplo.This example returns the name of the first column in a sample Employee table.

-- Uses AdventureWorks  
  
SELECT COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 1) AS FirstColumnName,  
COL_NAME(OBJECT_ID('dbo.FactResellerSales'), 2) AS SecondColumnName;  

El conjunto de resultados es el siguiente.Here is the result set.

ColumnName          
------------   
BusinessEntityID  

Vea tambiénSee also

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