Поделиться через


SQLSetDescRec

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

В этом разделе рассматриваются функции SQLSetDescRec, относящиеся к собственному клиенту SQL Server.

Функция SQLSetDescRec и параметры, возвращающие табличное значение

SQLSetDescRec можно использовать для задания полей дескриптора для параметров с табличным значением и столбцов возвращаемых табличным значением параметров. Столбцы возвращающих табличное значение параметров доступны только в том случае, когда в поле заголовка дескриптора SQL_SOPT_SS_PARAM_FOCUS задан порядковый номер записи, имеющей тип SQL_DESC_TYPE со значением SQL_SS_TABLE. Дополнительные сведения об атрибуте SQL_SOPT_SS_PARAM_FOCUS см. в разделе SQLSetStmtAttr.

В следующей таблице показано сопоставление между параметрами и полями дескриптора.

Параметр Связанный атрибут для типов параметров, отличных от табличного значения, включая столбцы параметров с табличным значением Связанные атрибуты для возвращающих табличное значение параметров
Тип SQL_DESC_TYPE SQL_SS_TABLE
Подтип Пропущено Для записей типа SQL_DATETIME и SQL_INTERVAL этот атрибут должен иметь значение SQL_DESC_DATETIME_INTERVAL_CODE.
Длина SQL_DESC_OCTET_LENGTH Длина имени типа параметра, возвращающего табличное значение. Значение может быть равно SQL_NTS, если имя типа представляет собой строку, завершающуюся нулевым символом, или 0, если имя типа параметра, возвращающего табличное значение, не требуется.
Точность SQL_DESC_PRECISION SQL_DESC_ARRAY_SIZE
Масштабировать SQL_DESC_SCALE Не используется. Значение этого параметра должно быть равно 0.
DataPtr SQL_DESC_DATA_PTR в APD SQL_CA_SS_TYPE_NAME

Этот параметр не является обязательным для вызова хранимых процедур; если он не требуется, можно задать значение NULL. Параметр должен быть задан для инструкций SQL, не являющихся вызовами процедур.

DataPtr также служит уникальным значением, которое приложение может использовать для идентификации этого табличного параметра при использовании привязки строк переменной.
StringLengthPtr SQL_DESC_OCTET_LENGTH_PTR SQL_DESC_OCTET_LENGTH_PTR

Для параметра, возвращающего табличное значение, этот параметр равен числу строк для переноса или значению SQL_DATA_AT_EXEC. Это указатель на значение, которое содержит количество строк для передачи с помощью SQLExecDirect.
ИндикаторPtr SQL_DESC_INDICATOR_PTR SQL_DESC_INDICATOR_PTR

Дополнительные сведения о табличном значении параметров см. в разделе "Параметры с табличным значением" (ODBC).

Поддержка методом SQLSetDescRec улучшенных функций даты и времени

Для типов даты и времени допускаются следующие значения.

Атрибут Тип Подтип Длина Точность Масштабировать
datetime SQL_DATETIME SQL_CODE_TIMESTAMP 4 3 3
smalldatetime SQL_SQL_DATETIME SQL_CODE_TIMESTAMP 8 0 0
Дата SQL_DATETIME SQL_CODE_DATE 6 0 0
Время 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).

Поддержка методом SQLSetDescRec больших определяемых пользователем типов в среде CLR

SQLSetDescRec поддерживает большие определяемые пользователем типы CLR (UDTs). Дополнительные сведения см. в разделе "Крупные определяемые пользователем типы CLR" (ODBC).

См. также

SQLSetDescRec
Подробные сведения о реализации API-интерфейсов ODBC