INDEXKEY_PROPERTY(Transact-SQL)

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Managed Instance

인덱스 키에 대한 정보를 반환합니다. XML 인덱스에 대해서는 NULL을 반환합니다.

중요

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 sys.index_columns(Transact-SQL)를 사용합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

INDEXKEY_PROPERTY ( object_ID ,index_ID ,key_ID ,property )  

참고

SQL Server 2014 이전 버전의 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조하세요.

인수

object_ID
테이블 또는 인덱싱된 뷰의 개체 ID입니다. object_IDint 입니다.

index_ID
인덱스 ID입니다. index_IDint 입니다.

key_ID
인덱스 키 열 위치입니다. key_IDint 입니다.

property
정보를 반환할 속성의 이름입니다. property 는 문자열이며 다음 값 중 하나일 수 있습니다.

Description
ColumnId 인덱스의 key_ID 위치에 있는 열 ID입니다.
IsDescending 인덱스 열이 저장되는 순서

1 = 내림차순 0 = 오름차순

반환 형식

int

예외

오류가 발생하거나 호출자가 개체를 볼 수 있는 권한을 갖고 있지 않으면 NULL을 반환합니다.

사용자는 소유하고 있거나 사용 권한을 부여 받은 보안 개체의 메타데이터만 볼 수 있습니다. 즉, 사용자가 개체에 대한 사용 권한이 없으면 INDEXKEY_PROPERTY와 같은 메타데이터 내보내기 기본 제공 함수가 NULL을 반환합니다. 자세한 내용은 Metadata Visibility Configuration을 참조하세요.

예제

다음 예에서는 1 테이블의 인덱스 ID 1과 키 열 Production.Location에 대해 두 속성이 반환됩니다.

USE AdventureWorks2012;  
GO  
SELECT   
    INDEXKEY_PROPERTY(OBJECT_ID('Production.Location', 'U'),  
        1,1,'ColumnId') AS [Column ID],  
    INDEXKEY_PROPERTY(OBJECT_ID('Production.Location', 'U'),  
        1,1,'IsDescending') AS [Asc or Desc order];  

결과 집합은 다음과 같습니다.

Column ID   Asc or Desc order   
----------- -----------------   
1           0  
  
(1 row(s) affected)  

관련 항목

INDEX_COL(Transact-SQL)
INDEXPROPERTY(Transact-SQL)
sys.objects(Transact-SQL)
sys.indexes(Transact-SQL)
sys.index_columns(Transact-SQL)