SQLSetDescRec
적용 대상:
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
이 항목에서는 SQL Server Native Client와 관련된 SQLSetDescRec 기능에 대해 설명합니다.
SQLSetDescRec 및 테이블 반환 매개 변수
SQLSetDescRec를 사용하여 테이블 반환 매개 변수 및 테이블 반환 매개 변수 열에 대한 설명자 필드를 설정할 수 있습니다. 테이블 반환 매개 변수 열은 설명자 헤더 필드 SQL_SOPT_SS_PARAM_FOCUS가 SQL_DESC_TYPE이 SQL_SS_TABLE로 설정된 레코드의 서수로 설정된 경우에만 사용할 수 있습니다. SQL_SOPT_SS_PARAM_FOCUS 대한 자세한 내용은 SQLSetStmtAttr을 참조 하세요.
다음 표에서는 매개 변수와 설명자 필드 간의 매핑에 대해 설명합니다.
| 매개 변수 | 테이블 반환 매개 변수 열을 포함하여 테이블 반환이 아닌 매개 변수 형식에 대한 관련 특성 | 테이블 반환 매개 변수에 대한 관련 특성 |
|---|---|---|
| Type | SQL_DESC_TYPE | SQL_SS_TABLE |
| SubType | 무시됨 | 형식 SQL_DATETIME 또는 SQL_INTERVAL 레코드의 경우 SQL_DESC_DATETIME_INTERVAL_CODE 설정합니다. |
| 길이 | SQL_DESC_OCTET_LENGTH | 테이블 반환 매개 변수 형식 이름의 길이입니다. 형식 이름이 null로 종료된 경우 SQL_NTS, 테이블 반환 매개 변수 형식 이름이 필요하지 않은 경우 0일 수 있습니다. |
| 정밀도 | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| 스케일 | SQL_DESC_SCALE | 사용되지 않습니다. 이 매개 변수는 0이어야 합니다. |
| DataPtr | APD의 SQL_DESC_DATA_PTR | SQL_CA_SS_TYPE_NAME 이 매개 변수는 저장 프로시저 호출에 대해 선택 사항이며, 필요하지 않은 경우 NULL을 지정할 수 있습니다. 프로시저 호출이 아닌 SQL 문에 대해 이 매개 변수를 지정해야 합니다. 또한 DataPtr 은 변수 행 바인딩을 사용할 때 애플리케이션에서 이 테이블 반환 매개 변수를 식별하는 데 사용할 수 있는 고유한 값으로 사용됩니다. |
| StringLengthPtr | SQL_DESC_OCTET_LENGTH_PTR | SQL_DESC_OCTET_LENGTH_PTR 테이블 반환 매개 변수의 경우 이 값은 전송할 행 수나 SQL_DATA_AT_EXEC입니다. SQLExecDirect를 사용하여 전송할 행 수를 보유하는 값에 대한 포인터입니다. |
| IndicatorPtr | SQL_DESC_INDICATOR_PTR | SQL_DESC_INDICATOR_PTR |
테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.
향상된 날짜 및 시간 기능에 대한 SQLSetDescRec 지원
날짜/시간 형식에 허용되는 값은 다음과 같습니다.
| 특성 | Type | SubType | 길이 | 정밀도 | 스케일 |
|---|---|---|---|---|---|
| 날짜/시간 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| date | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| time | SQL_SS_TIME2 | 0 | 10 | 0..7 | 0..7 |
| datetime2 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 16 | 0..7 | 0..7 |
| datetimeoffset | SQL_SS_TIMESTAMPOFFSET | 0 | 20 | 0..7 | 0..7 |
자세한 내용은 날짜 및 시간 개선 사항(ODBC)을 참조하세요.
큰 CLR UDT에 대한 SQLSetDescRec 지원
SQLSetDescRec 는 큰 CLR UDT(사용자 정의 형식)를 지원합니다. 자세한 내용은 ODBC(큰 CLR 사용자 정의 형식)를 참조하세요.