적용 대상:
SQL 서버Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics분석 플랫폼 시스템(PDW)Microsoft Fabric의 SQL 데이터베이스
이 함수는 테이블 열의 테이블 ID 번호와 열 ID 번호 값에 따라 해당 테이블 열의 이름을 반환합니다.
구문
COL_NAME ( table_id , column_id )
인수
table_id
열이 포함된 테이블의 ID 번호입니다. table_id 인수에 int 데이터 형식이 있습니다.
column_id
열의 ID 번호입니다. column_id 인수에 int 데이터 형식이 있습니다.
반환 형식
sysname
예외
오류가 발생하거나 호출자에게 개체를 볼 수 있는 올바른 권한이 없는 경우 반환 NULL 합니다.
사용자는 사용자가 소유하거나 사용자에게 사용 권한이 부여된 보안 개체의 메타데이터만 볼 수 있습니다. 즉, 사용자에게 개체에 대한 올바른 권한이 없는 경우 메타데이터 내보내기 같은 기본 제공 함수 COL_NAME 가 반환 NULL될 수 있습니다. 자세한 내용은 메타데이터 표시 유형 구성을 참조하세요.
설명
table_id 및 column_id 매개 변수는 함께 열 이름 문자열을 생성합니다.
테이블 및 열 ID 번호를 가져오는 방법에 대한 자세한 내용은 OBJECT_ID 참조하세요.
예제
이 문서의 코드 샘플은 AdventureWorks2025 또는 AdventureWorksDW2025 샘플 데이터베이스를 사용합니다. 이 데이터베이스는 Microsoft SQL Server 샘플 및 커뮤니티 프로젝트 홈페이지에서 다운로드할 수 있습니다.
A. 테이블에서 처음 두 열의 이름을 반환합니다.
다음은 표에 있는 처음 두 열의 이름을 반환하는 예제입니다 Person.Person .
USE AdventureWorks2022;
GO
SELECT COL_NAME(OBJECT_ID('Person.Person'), 1) AS FirstColumnName,
COL_NAME(OBJECT_ID('Person.Person'), 2) AS SecondColumnName;
결과 집합은 다음과 같습니다.
FirstColumnName SecondColumnName
----------------- -----------------
BusinessEntityID PersonType