테이블 반환 매개 변수 구성 요소 열에 대한 설명자 필드

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

이 섹션에서 설명하는 테이블 반환 매개 변수 설명자 필드는 구현 매개 변수 설명자(IPD)에 대한 핸들과 함께 SQLSetDescField 및 SQLSetDescField를 사용하여 조작됩니다.

설명

SQL_DESC_AUTO_UNIQUE_VALUE 테이블 반환 매개 변수 및 기타 기능에 사용됩니다.

Attribute name	Type	설명
SQL_DESC_AUTO_UNIQUE_VALUE	SQLINTEGER	SQL_TRUE는 해당 열이 ID 열임을 나타냅니다. SQL Server는 이 정보를 사용하여 성능을 최적화할 수 있지만 애플리케이션에서 ID 열에 대해 설정할 필요는 없습니다.

APD(애플리케이션 매개 변수 설명자) 및 IPD의 모든 매개 변수 유형에는 다음과 같은 특성이 추가됩니다.

Attribute name	Type	설명
SQL_CA_SS_COLUMN_COMPUTED	SQLSMALLINT	SQL_TRUE 이 열이 계산됨을 나타냅니다. SQL Server는 이 정보를 사용하여 성능을 최적화할 수 있지만 애플리케이션에서 계산 열에 대해 설정할 필요는 없습니다. 테이블 반환 매개 변수 열이 아닌 바인딩의 경우 이 특성이 무시됩니다.
SQL_CA_SS_COLUMN_IN_UNIQUE_KEY	SQLSMALLINT	SQL_TRUE는 테이블 반환 매개 변수 열이 고유 키에 참여함을 나타냅니다. 이 경우 쿼리 성능이 향상될 수 있습니다. 테이블 반환 매개 변수 열이 아닌 바인딩의 경우 이 특성이 무시됩니다.
SQL_CA_SS_COLUMN_SORT_ORDER	SQLSMALLINT	테이블 반환 매개 변수 열의 정렬 순서를 나타냅니다. 이 경우 쿼리 성능이 향상될 수 있습니다. 테이블 반환 매개 변수 열이 아닌 바인딩의 경우 이 특성이 무시됩니다. 가능한 값은 다음과 같습니다. SQL_SS_ASCENDING_ORDER SQL_SS_DESCENDING_ORDER SQL_SS_ORDER_UNSPECIFIED SQL_SS_ASCENDING_ORDER 및 SQL_SS_DESCENDING_ORDER 이외의 값은 SQLSTATE HY024 및 '잘못된 특성 값'과 함께 오류를 생성하며 이 특성의 기본값인 SQL_SS_ORDER_UNSPECIFIED 처리됩니다.
SQL_CA_SS_COLUMN_SORT_ORDINAL	SQLSMALLINT	테이블 반환 매개 변수의 전체 순서를 정의하는 열 집합에서 테이블 반환 매개 변수 열의 서수를 나타냅니다. 이 경우 쿼리 성능이 향상될 수 있습니다. 테이블 반환 매개 변수 열이 아닌 바인딩의 경우 이 특성이 무시됩니다. 정렬 서수는 1부터 시작합니다. 기본값인 0은 테이블 반환 매개 변수 열에 열 순서가 없음을 나타냅니다.
SQL_CA_SS_COLUMN_HAS_DEFAULT_VALUE	SQLSMALLINT	테이블 반환 매개 변수의 모든 행에 해당 열의 기본값이 지정될지 여부를 나타냅니다. 테이블 반환 매개 변수의 경우 기본값을 행 단위로 선택할 수 없습니다. SQL_FALSE 값은 행에 기본값이 아닌 값이 있음을 나타냅니다. 기본값입니다. SQL_TRUE 값은 모든 행의 기본값이 해당 열에 지정됨을 나타냅니다. SQL_TRUE 설정하면 서버에 데이터가 전송되지 않습니다. 이 필드는 서버 처리에 열 값이 필요하지 않은 경우 ID 또는 계산 열과 함께 사용할 수도 있습니다.

이러한 특성은 테이블 반환 매개 변수 열에 대해서만 유효하고 다른 매개 변수에 대해서는 무시됩니다.

테이블 반환 매개 변수 열에 대해 SQL_CA_SS_COL_HAS_DEFAULT_VALUE 설정된 경우 해당 열에 대한 SQL_DESC_DATA_PTR null 포인터여야 합니다. 그렇지 않으면 SQLExecute 또는 SQLExecDirect는 SQL_ERROR 반환합니다. 진단 레코드는 SQLSTATE=07S01 및 "매개 변수 <p>, 열 <c>에 대한 기본 매개 변수의 잘못된 사용"을 사용하여 생성됩니다. 여기서 <p> 는 매개 변수 서수이고 <c> 는 열 서수입니다.

참고 항목

테이블 반환 매개 변수(ODBC)