Сводка по функциям ODBC
В следующей таблице перечислены функции ODBC, сгруппированные по типу задачи, а также обозначение соответствия и краткое описание цели каждой функции. Дополнительные сведения о обозначениях соответствия см. в ODBC и стандартном интерфейсе командной строки. Дополнительные сведения о синтаксисе и семантике для каждой функции см. в справочнике по API ODBC.
Приложение может вызвать функцию SQLGetInfo для получения сведений о соответствии драйвера. Чтобы получить сведения о поддержке определенной функции в драйвере, приложение может вызывать SQLGetFunctions.
| Задача | Имя функции | Соответствие | Характер использования |
|---|---|---|---|
| подключение к источнику данных; | SQLAllocHandle | ISO 92 | Получает среду, соединение, оператор или дескриптор. |
| SQLConnect | ISO 92 | Подключается к определенному драйверу по имени источника данных, идентификатору пользователя и паролю. | |
| SQLDriverConnect | ODBC | Подключается к конкретному драйверу, строка подключения или запрашивает, что диспетчер драйверов и драйвер отображают диалоговые окна подключения для пользователя. | |
| SQLBrowseConnect | ODBC | Возвращает последовательные уровни атрибутов подключения и допустимые значения атрибутов. Если для каждого атрибута подключения задано значение, подключается к источнику данных. | |
| Получение сведений об драйвере и источнике данных | SQLDataSources SQLDrivers |
ISO 92 ODBC |
Возвращает список доступных источников данных. Возвращает список установленных драйверов и их атрибутов. |
| SQLGetInfo | ISO 92 | Возвращает сведения о конкретном драйвере и источнике данных. | |
| SQLGetFunctions | ISO 92 | Возвращает поддерживаемые функции драйвера. | |
| SQLGetTypeInfo | ISO 92 | Возвращает сведения о поддерживаемых типах данных. | |
| Настройка и получение атрибутов драйвера | SQLSetConnectAttr SQLGetConnectAttr |
ISO 92 ISO 92 |
Задает атрибут подключения. Возвращает значение атрибута подключения. |
| SQLSetEnvAttr | ISO 92 | Задает атрибут среды. | |
| SQLGetEnvAttr | ISO 92 | Возвращает значение атрибута среды. | |
| SQLSetStmtAttr | ISO 92 | Задает атрибут оператора. | |
| SQLGetStmtAttr | ISO 92 | Возвращает значение атрибута оператора. | |
| Настройка и извлечение полей дескриптора | SQLGetDescField SQLGetDescRec |
ISO 92 ISO 92 |
Возвращает значение одного дескриптора. Возвращает значения нескольких полей дескриптора. |
| SQLSetDescField | ISO 92 | Задает одно поле дескриптора. | |
| SQLSetDescRec | ISO 92 | Задает несколько полей дескриптора. | |
| SQLCopyDesc | ISO 92 | Копирует сведения дескриптора из одного дескриптора в другой. | |
| Подготовка запросов SQL | SQLPrepare | ISO 92 | Подготавливает инструкцию SQL для последующего выполнения. |
| SQLBindParameter | ODBC | Назначает хранилище для параметра в инструкции SQL. | |
| SQLGetCursorName | ISO 92 | Возвращает имя курсора, связанное с дескриптором инструкции. | |
| SQLSetCursorName | ISO 92 | Указывает имя курсора. | |
| SQLSetScrollOptions | ODBC | Задает параметры, управляющие поведением курсора. | |
| Отправка запросов | SQLExecute SQLExecDirect |
ISO 92 ISO 92 |
Выполняет подготовленную инструкцию. Выполняет инструкцию. |
| SQLNativeSql | ODBC | Возвращает текст инструкции SQL, переведенной драйвером. | |
| SQLDescribeParam | ODBC | Возвращает описание определенного параметра в инструкции. | |
| SQLNumParams | ISO 92 | Возвращает количество параметров в инструкции. | |
| SQLParamData | ISO 92 | Используется в сочетании с SQLPutData для предоставления данных параметров во время выполнения. (Полезно для длинных значений данных.) | |
| SQLPutData | ISO 92 | Отправляет часть или все значения данных для параметра. (Полезно для длинных значений данных.) | |
| Получение результатов и сведений о результатах | SQLRowCount SQLNumResultCols |
ISO 92 ISO 92 |
Возвращает количество строк, затронутых запросом вставки, обновления или удаления. Возвращает число столбцов в результирующем наборе. |
| SQLDescribeCol | ISO 92 | Описывает столбец в результирующем наборе. | |
| SQLColAttribute | ISO 92 | Описывает атрибуты столбца в результирующем наборе. | |
| SQLBindCol | ISO 92 | Назначает хранилище для результирующих столбцов и задает тип данных. | |
| SQLFetch | ISO 92 | Возвращает несколько строк результатов. | |
| SQLFetchScroll | ISO 92 | Возвращает прокручиваемые строки результатов. | |
| SQLGetData | ISO 92 | Возвращает часть или все один столбец одной строки результирующий набор. (Полезно для длинных значений данных.) | |
| SQLSetPos | ODBC | Помещает курсор в извлекаемый блок данных и позволяет приложению обновлять данные в наборе строк или обновлять или удалять данные в результирующем наборе. | |
| SQLBulkOperations | ODBC | Выполняет массовые вставки и операции массовой закладки, включая обновление, удаление и получение по закладке. | |
| SQLMoreResults | ODBC | Определяет, доступны ли дополнительные результирующие наборы и, если да, инициализирует обработку для следующего результирующий набор. | |
| SQLGetDiagField | ISO 92 | Возвращает дополнительные диагностические сведения (одно поле структуры диагностических данных). | |
| SQLGetDiagRec | ISO 92 | Возвращает дополнительные диагностические сведения (несколько полей структуры диагностических данных). | |
| Получение сведений о системных таблицах источника данных (функции каталога) | SQLColumnPrivileges SQLColumns |
ODBC Открытие группы |
Возвращает список столбцов и связанных привилегий для одной или нескольких таблиц. Возвращает список имен столбцов в указанных таблицах. |
| SQLForeignKeys | ODBC | Возвращает список имен столбцов, составляющих внешние ключи, если они существуют для указанной таблицы. | |
| SQLPrimaryKeys | ODBC | Возвращает список имен столбцов, составляющих первичный ключ для таблицы. | |
| SQLProcedureColumns | ODBC | Возвращает список входных и выходных параметров, а также столбцы, составляющие результирующий набор для указанных процедур. | |
| SQLProcedures | ODBC | Возвращает список имен процедур, хранящихся в определенном источнике данных. | |
| SQLSpecialColumns | Открытие группы | Возвращает сведения о оптимальном наборе столбцов, однозначно определяющих строку в указанной таблице, или столбцы, которые автоматически обновляются при обновлении любого значения в строке транзакцией. | |
| SQLStatistics | ISO 92 | Возвращает статистику по одной таблице и списку индексов, связанных с таблицей. | |
| SQLTablePrivileges | ODBC | Возвращает список таблиц и привилегий, связанных с каждой таблицей. | |
| SQLTables | Открытие группы | Возвращает список имен таблиц, хранящихся в определенном источнике данных. | |
| Завершение инструкции | SQLFreeStmt | ISO 92 | Завершает обработку инструкций, отменяет ожидающие результаты и, при необходимости, освобождает все ресурсы, связанные с дескриптором инструкции. |
| SQLCloseCursor | ISO 92 | Закрывает курсор, открытый в дескрипторе инструкции. | |
| SQLCancel | ISO 92 | Отменяет обработку инструкции. | |
| SQLCancelHandle | ODBC | Отменяет обработку инструкции или подключения. | |
| SQLEndTran | ISO 92 | Фиксирует или откатывает транзакцию. | |
| Завершение подключения | SQLDisconnect SQLFreeHandle |
ISO 92 ISO 92 |
Закрывает подключение. Освобождает среду, дескриптор подключения, оператора или дескриптора. |