Метаданные параметров и результатов

В этом разделе описывается, что возвращается в полях дескриптора параметров реализации (IPD) и дескриптора строк реализации (IRD) для типов данных даты и времени.

Сведения, возвращаемые в полях IPD

Следующие сведения возвращаются в полях IPD:

Иногда в диапазонах значений имеются разрывы. Например, 9 отсутствует в 8 10.16. Это следствие добавления десятичной запятой, когда точность в долях секунды выше нуля.

datetime2 возвращается в качестве имени smalldatetime типа и datetime поскольку драйвер использует это в качестве общего типа для передачи всех SQL_TYPE_TIMESTAMP значений на сервер.

SQL_CA_SS_VARIANT_SQL_TYPE — это новое поле дескриптора. Это поле было добавлено в IRD и IPD, чтобы приложения могли указывать тип значения, связанный со sqlvariant столбцами и параметрами (SQL_SSVARIANT).

SQL_CA_SS_SERVER_TYPE — это новое поле только IPD, позволяющее приложениям управлять тем, как значения параметров, привязанных как SQL_TYPE_TYPETIMESTAMP (или как SQL_SS_VARIANT с типом C SQL_C_TYPE_TIMESTAMP), отправляются на сервер. Если SQL_DESC_CONCISE_TYPE SQL_TYPE_TIMESTAMP (или SQL_SS_VARIANT и тип C SQL_C_TYPE_TIMESTAMP) при вызове SQLExecute или SQLExecDirect, значение SQL_CA_SS_SERVER_TYPE определяет тип табличного потока данных (TDS) значения параметра следующим образом:

Параметр SQL_CA_SS_SERVER_TYPE по умолчанию — SQL_SS_TYPE_DEFAULT. Параметры SQL_DESC_PRECISION и SQL_DESC_LENGTH проверяются с помощью параметра SQL_CA_SS_SERVER_TYPE, как описано в таблице выше. Если эта проверка завершается ошибкой, возвращается SQL_ERROR, а запись диагностики регистрируется с помощью SQLState 07006 и сообщение "Нарушение атрибута ограниченного типа данных". Эта ошибка также возвращается, если SQL_CA_SS_SERVER_TYPE задано значение, отличное от SQL_SS_TYPE DEFAULT, и DESC_CONCISE_TYPE не SQL_TYPE_TIMESTAMP. Эти проверки выполняются при проверке согласованности дескриптора, например:

• При изменении SQL_DESC_DATA_PTR.

• Во время подготовки или выполнения (при вызове SQLExecute, SQLExecDirect, SQLSetPos или SQLBulkOperations).

• Если приложение принудительно выполняет неотложенную подготовку путем вызова SQLPrepare с отложенной подготовкой или путем вызова SQLNumResultCols, SQLDescribeCol или SQLDescribeParam для инструкции, подготовленной, но не выполненной.

Если SQL_CA_SS_SERVER_TYPE задан вызовом SQLSetDescField, его значение должно быть SQL_SS_TYPE_DEFAULT, SQL_SS_TYPE_SMALLDATETIME или SQL_SS_TYPE_DATETIME. Если это не так, возвращается SQL_ERROR, а запись диагностики регистрируется с помощью SQLState HY092 и сообщения "Недопустимый идентификатор атрибута или параметра".

Атрибут SQL_CA_SS_SERVER_TYPE можно использовать приложениями, которые зависят от функций, поддерживаемых и smalldatetimeне поддерживаются.datetimedatetime2 Например, datetime2 требуется использовать dateadd функции и датированные функции, а datetimesmalldatetime также разрешать арифметические операторы. Большинству приложений не нужно использовать этот атрибут, и его использование следует избежать.

Сведения, возвращаемые в полях IRD

Следующие сведения возвращаются в полях IRD:

См. также

Метаданные (ODBC)