다음을 통해 공유


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

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

주의

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

특성 이름

유형

설명

SQL_DESC_AUTO_UNIQUE_VALUE

SQLINTEGER

SQL_TRUE는 해당 열이 ID 열임을 나타냅니다.

SQL Server에서는 이 정보를 사용하여 성능을 최적화할 수 있지만 이 특성을 ID 열에 설정하는 데 응용 프로그램은 필요하지 않습니다.

APD(응용 프로그램 매개 변수 설명자) 및 IPD의 모든 매개 변수 유형에는 다음과 같은 특성이 추가됩니다.

특성 이름

유형

설명

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>는 열 서수입니다.