테이블 반환 매개 변수 구성 열의 설명자 필드

적용 대상: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

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

설명

SQL_DESC_AUTO_UNIQUE_VALUE는 테이블 반환 매개 변수뿐 아니라 다른 기능에 대해서도 사용됩니다.

특성 이름 형식 Description
SQL_DESC_AUTO_UNIQUE_VALUE SQLINTEGER SQL_TRUE는 해당 열이 ID 열임을 나타냅니다.

SQL Server 이 정보를 사용하여 성능을 최적화할 수 있지만 애플리케이션은 ID 열에 대해 설정할 필요가 없습니다.

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

특성 이름 형식 Description
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_ORDERSQL_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)