테이블 반환 매개 변수 구성 요소 열에 대한 설명자 필드
적용 대상: 
SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
이 섹션에서 설명하는 테이블 반환 매개 변수 설명자 필드는 구현 매개 변수 설명자(IPD)에 대한 핸들과 함께 SQLSetDescField 및 SQLSetDescField를 사용하여 조작됩니다.
설명
SQL_DESC_AUTO_UNIQUE_VALUE 테이블 반환 매개 변수 및 기타 기능에 사용됩니다.
| 특성 이름 | Type | 설명 |
|---|---|---|
| SQL_DESC_AUTO_UNIQUE_VALUE | SQLINTEGER | SQL_TRUE는 해당 열이 ID 열임을 나타냅니다. SQL Server는 이 정보를 사용하여 성능을 최적화할 수 있지만 애플리케이션에서 ID 열에 대해 설정할 필요는 없습니다. |
APD(애플리케이션 매개 변수 설명자) 및 IPD의 모든 매개 변수 유형에는 다음과 같은 특성이 추가됩니다.
| 특성 이름 | 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> 는 열 서수입니다.