Поддержка API ODBC для расширенных функций даты и времени

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

Расширенные типы даты и времени (напримерdate, , datetime2timeиdatetimeoffset) требуют, чтобы драйвер ODBC поддерживал более широкие метаданные, расширенную точность и более гибкую семантику привязки.
Следующие API ODBC и массового копирования группируются в соответствии с тем, как они способствуют обнаружению, привязке, извлечению, управлению дескриптором и приему расширенных значений даты и времени.

Обнаружение схем и метаданных (типы даты и времени)

Эти API помогают приложениям определять поддерживаемые типы даты и времени, метаданные столбца и характеристики параметров.

Функция Цель
SQLColumns Извлекает метаданные для столбцов, включая расширенные типы даты и времени
SQLColAttribute Возвращает атрибуты столбца, такие как тип, точность и масштабирование полей даты и времени
SQLDescribeCol Предоставляет описания столбцов, включая сведения о типе даты и времени
SQLDescribeParam Возвращает метаданные параметров, включая формат и точность параметров даты и времени
SQLGetTypeInfo Список поддерживаемых типов данных SQL, включая расширенные категории даты и времени
SQLProcedureColumns Извлекает метаданные для параметров хранимой процедуры, включая типы даты и времени.
SQLSpecialColumns Определяет специальные столбцы, такие как метки времени и поля управления версиями

Поддержка привязки и параметров для типов даты и времени

Эти функции привязывают переменные и параметры приложения к значениям даты и времени.

Функция Цель
SQLBindCol Привязывает буферы приложения к результирующих столбцам, содержащим значения даты и времени
SQLBindParameter Привязка параметров даты и времени для подготовленных или прямых инструкций
SQLPutData Потоковая передача больших или переменных данных даты и времени во время выполнения

Получение значений даты и времени

Эти API извлекают расширенные значения даты и времени из выполняемых инструкций.

Функция Цель
SQLFetch Получение последовательных строк, содержащих значения даты и времени
SQLFetchScroll Получение строк с помощью прокручиваемых курсоров с столбцами даты и времени
SQLGetData Извлекает значения столбцов даты и времени в гибких форматах буфера

Дескриптор и управление атрибутами для типов даты и времени

Расширенные значения даты и времени требуют точных полей дескриптора для точности, масштабирования и макета хранилища.

Функция Цель
SQLGetDescField Извлекает метаданные дескриптора для полей даты и времени
SQLGetDescRec Извлекает полную запись дескриптора, включая тип и точность
SQLSetDescField Задает поля дескриптора для правильного представления значений даты и времени
SQLSetDescRec Задает полную запись дескриптора для буферов, в котором хранятся сведения о дате и времени.

Поддержка массового копирования (BCP) для типов даты и времени

Операции массового копирования позволяют приема и извлечения расширенных значений даты и времени.

Функция Цель
bcp_bind Привязывает переменные узла к столбцам массового копирования, содержащим расширенные данные даты и времени
bcp_colfmt Определяет форматы столбцов для значений даты и времени во время экспорта и импорта BCP
bcp_getcolfmt Извлекает сведения о формате для столбцов, содержащих типы даты и времени
bcp_gettypename Возвращает имена типов SQL Server, включая расширенные типы даты и времени
bcp_setcolfmt Задает определения формата для массовых операций с типами даты и времени