COL_NAME (Transact-SQL)

Artigo
10/16/2024

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

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.

Convenciones de sintaxis de Transact-SQL

Sintaxis

COL_NAME ( table_id , column_id )

Argumentos

table_id
El número de identificación de la tabla que contiene esa columna. El argumento id_tabla tiene un tipo de datos int.

column_id
El número de identificación de la columna. El argumento id_columna tiene un tipo de datos int.

Tipos de valores devueltos

sysname

Excepciones

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

En SQL Server, un usuario solo puede ver los metadatos de los 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 COL_NAME, es posible que devuelvan NULL si el usuario no tiene los permisos correctos para el objeto. Vea Configuración de visibilidad de los metadatos para obtener más información.

Observaciones

Los parámetros table_id y column_id generan juntos una cadena de nombre de columna.

Vea OBJECT_ID (Transact-SQL)para más información sobre cómo obtener los números de identificación de tablas y columnas.

Ejemplos

En este ejemplo se devuelve el nombre de la primera columna de una tabla Employee de ejemplo.

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

Este es el conjunto de resultados.

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

Consulte también

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

Compartir por