Compartir vía

COL_NAME (Transact-SQL)

Aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Analítica (PDW)Base de datos SQL en Microsoft Fabric

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 el error o si un autor de la llamada no tiene el permiso correcto para ver el objeto.

Un usuario solo puede ver los metadatos de elementos protegibles que posee el usuario o en los que se concede permiso al usuario. Esto significa que las funciones integradas que emiten metadatos, como COL_NAME , por ejemplo, pueden devolver NULL, si el usuario no tiene permisos correctos en el objeto. Para obtener más información, consulte Configuración de visibilidad de metadatos.

Observaciones

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

Para obtener más información sobre cómo obtener números de identificación de tabla y columna, consulte OBJECT_ID.

Ejemplos

Los ejemplos de código de este artículo usan la base de datos de ejemplo de AdventureWorks2025 o AdventureWorksDW2025, que puede descargar de la página principal de Ejemplos de Microsoft SQL Server y proyectos de comunidad.

A. Devuelve nombres de las dos primeras columnas de una tabla

En este ejemplo se devuelve el nombre de las dos primeras columnas de la Person.Person tabla.

USE AdventureWorks2022;
GO

SELECT COL_NAME(OBJECT_ID('Person.Person'), 1) AS FirstColumnName,
       COL_NAME(OBJECT_ID('Person.Person'), 2) AS SecondColumnName;

Este es el conjunto de resultados.

FirstColumnName    SecondColumnName
-----------------  -----------------
BusinessEntityID    PersonType

Contenido relacionado

  • Last updated on