Ознакомиться со структурой программ, использующие средства ODBC, реализовать и выполнить с использованием простейших функций ODBC запросы, связанные с модификацией таблиц.

• ознакомиться со структурой программы ODBC;
• изучить функции выполнения подготовительных операций в ODBC-программе;
• ознакомиться со средствами обработки ошибок в ODBC-программе;
• изучить функции непосредственного и подготавливаемого выполнения SQL-операторов, передачи параметров;
• настроить среду выполнения, разработать и отладить ODBC-программу.

1. Структура ODBC-программы и функции инициализации

Общая структура ODBC-программы имеет вид:



• Идентификатор окружения каждого приложения ODBC описывается функцией SQLAllocEnv, который должен быть освобожден в конце приложения с помощью функции SQLFreeEnv. Тип идентификатора окружения HENV.

RETCODE SQLAllocEnv (env)

HENV env - указатель области хранения в памяти идентификатора окружения.

RETCODE SQLFreeEnv (env)

HENV env - имя идентификатора окружения, который должен быть освобожден.

• Идентификатор соединения представляет собой соединение между источником данных и прикладной программой. Для каждого источника данных, с которым приложение предполагает соединиться должен быть назначен идентификатор соединения SQLAllocConnect и освобожден SQLFreeConnect. Приложение может соединиться с источником данных, используя SQLConnect и разъединиться, используя SQLDisconnect. Тип идентификатора соединения HDBC.

RETCODE SQLAllocConnect (env, dbc)

HENV env - указатель на идентификатор окружения прикладной программы.

HDBC dbc - указатель области хранения памяти для идентификатора соединения.

RETCODE SQLFreeConnect (dbc)

HDBC dbc - указатель области памяти для освобождаемого идентификатора соединения.

RETCODE SQLConnect(dbc, szDSN, sbDSN, szUID, sbUID, szAuthStr, cbAuthStr)

HDBC dbc - идентификатор соединения.

UCHAR szDSN - строка с именем источника данных, с которым прикладная программа собирается соединиться.

SWORD sbDSN - длина строки источника данных, если это имя имеет нулевое окончание, то этот параметр можно установить в SQL_NTS, который является константой ODBC и используется вместо длины параметра, если параметр содержит строку с нулевым окончанием.

UCHAR szUID - имя пользователя.

SWORD sbUID - длина имени пользователя или SQL_NTS.

UCHAR szAuthStr - пароль пользователя.

SWORD cbAuthStr - длина пароля.

RETCODE SQLDisconnect (dbc)

HDBC dbc - идентификатор доступа для отсоединения.

• Идентификатор оператора аналогичен идентификатору окружения или соединения за исключением того, что он ссылается на SQL-оператор. Идентификатор соединения может быть связан несколькими идентификаторами операторов, но каждый идентификатор оператора связан только со своим идентификатором соединения. Чтобы назначить идентификатор оператора, приложение вызывает функцию SQLAllocStmt, а для освобождения SQLFreeStmt. Тип идентификатора оператора HSTMT.

RETCODE SQLAllocStmt (dbc, stmt)

HDBC dbc - идентификатор соединения.

HSTMT stmt - указатель области хранения в памяти для идентификатора оператора.

RETCODE SQLFreeStmt (stmt, fOption)

HSTMT stmt -идентификатор оператора.

UWORD fOption - одна из следующих опций:

SQL_CLOSE - закрывает курсор, связанный с hstmt, (если он был определен) и отбрасывает все ожидаемые результаты. Прикладная программа может вновь открыть этот курсор позднее, вновь выполнить оператор SELECT с теми же самыми или другими значениями параметров. Если курсор не открыт, то эта опция не повлияет на программу.

SQL_DROP - освобождает hstmt, освобождает все ресурсы, связанные с ним, закрывает курсор, если он открыт, и отбрасывает все ожидаемые строки. Эта опция завершает все обращения к hstmt. hstmt обязательно должен быть переназначен для повторного использования. Эта опция освобождает все ресурсы, которые были определены с помощью функции SQLFreeStmt.

SQL_UNBIND - освобождает все буферы столбцов, которые повторно используются функцией SQLBindCol для данного идентификатора оператора.

SQL_RESET_PARAMS - освобождает все буферы параметров, которые были установлены функцией SQLBindCol для данного идентификатора оператора.

2. Средства отслеживания ошибок

Для отслеживания ошибок в ODBC используется функция SQLError, которая возвращает сообщение об ошибке при неудачном завершении какой-либо функции ODBC.

Каждая ODBC-функция возвращает RETCODE, который принимает одно из нижеследующих значений:

• SQL_SUCCESS Операция выполнена без ошибки.;
• SQL_SUCCESS_WITH_INFO Функция завершена, но при вызове SQLError указывает на ошибку. В большинстве случаев это возникает, когда значение, которое должно быть возвращено очень большого размера, чем это предусмотрено буфером прикладной программы;
• SQL_ERROR Функция не была завершена из-за возникшей ошибки. При вызове SQLError можно будет получить больше информации о сложившейся ситуации;
• SQL_INVALID_HANDLE Не правильно определен идентификатор окружения, соединения или оператора. Это часто случается, когда идентификатор используется после того, как он был освобожден или если был определен нулевой указатель;
• SQL_NO_DATA_FOUND Больше нет подходящей информации. Фактически это не является ошибкой. Чаще всего такой статус возникает при использовании курсора, когда больше нет строк для его продвижения;
• SQL_NEED_DATA Необходимы данные для параметра.

RETCODE SQLError (henv, hdbc, hsmt, szSqlState, pfNativeError, szErrorMsg, cbErrorMsgMax, cbErrorMsg)

HENV henv - идентификатор окружения.

HDBC hdbc - идентификатор соединения.

HSTMT hsmt - идентификатор оператора.

UCHAR szSqlState - SQLSTATE в качестве строки завершения.

SDWORD pfNativeError - в этом параметре и будет возвращена ошибка, возникшая в СУБД, а также ее собственный код. Если соответствующего собственного кода ошибки не существует, то возвращается ноль.

UCHAR szErrorMsg - указатель на буфер, куда будет возвращен текст ошибки (строка с нулевым окончанием).

SWORD cbErrorMsgMax - максимальный размер вышеописанного буфера, должен быть меньше или равен SQL_MAX_MESSAGE_LENGTH-1.

SWORD cbErrorMsg - сюда возвращается число байт, скопированных в буфер.

3. Непосредственное и подготавливаемое выполнение операторов SQL

Непосредственное выполнение используется в тех случаях, когда

• SQL-операторы, которые должны быть выполнены, будут выполняться только один раз;
• не требуется информации о результирующем множестве до выполнения оператора;

SQLExecDirect представляет собой самый быстрый способ запустить SQL-оператор при одноразовом выполнении.

RETCODE SQLExecDirect (hstmt, szSqlStr, cbSqlStr)

HSTMT hstmt- идентификатор оператора.

UCHAR szSqlStr- строка с SQL-оператором.

SDWORD cbSqlStr - длина строки szSqlStr.

Подготавливаемое выполнение предпочтительнее использовать, когда необходима информация о результирующем множестве до выполнения оператора или когда требуется выполнить SQL-оператор более одного раза. Для этого необходимы две функции SQLPrepare и SQLExecute.

SQLPrepare подготавливает SQL-строку для выполнения:

RETCODE SQLPrepare (hstmt, szSqlStr, cbSqlStr)

HSTMT hstmt - идентификатор оператора

UCHAR szSqlStr- строка с SQL-оператором

SDWORD cbSqlStr - длина строки szSqlStr

SQLExecute выполняет подготовленный оператор:

RETCODE SQLExecute(hstmt)

HSTMT hstmt - идентификатор оператора

SQLPrepare и SQLExecDirect отличаются тем, что при вызове SQLPrepare оператор SQL в действительности не выполняется, вместо этого определяется путь доступа к данным источника данных. Использование подготавливаемого выполнения удобно для операторов, которые будут выполняться более одного раза. Так как путь доступа к данным уже определен, то выполнение может осуществляться несколько быстрее, чем при использовании SQLExecDirect. Кроме того, каждый вызов SQLExecute передает базе данных только идентификатор для планирования обращения, а не весь SQL-оператор.

4. Использование параметров при выполнении

Параметры используются при непосредственном и подготавливаемом выполнении. Маркеры параметров определяются в SQL-операторах с помощью знаков "?". Например, SELECT n_post FROM s WHERE town=? или INSERT INTO p(name, town) VALUES (?,?). Для того, чтобы связать буфер с маркерами параметров, прикладная программа должна вызвать SQLBindParameter:

RETCODE SQLBindParameter (hsmt, ipar, fParamType, fCType, fSqlType, cbColDef, ibScale, rgbValue, cbValueMax, pcValue)

HSTMT hsmt - идентификатор оператора, он должен быть точно тем же идентификатором оператора, с которым этот оператор подготавливается и выполняется.

UWORD ipar - номер параметра для связи. В операторе SQL операторы нумеруются слева направо, начиная с 1. Например, для следующего SQL-оператора используется три параметрических маркера : INSERT INTO j (n_izd, name, town) VALUES (?,?,?). Чтобы связать эти параметры, SQLBindParameter вызывается три раза с ipar, установленным в 1, 2 и 3 соответственно.

SWORD fParamType - является типом параметра для связи и может принимать одно из трех значений: SQL_PARAM_INPUT, SQL_PARAM_INPUT_OUTPUT или SQL_PARAM_OUTPUT. SQL_PARAM_INPUT используется для процедур, использующих параметры ввода. SQL_PARAM_INPUT_OUTPUT маркирует параметр ввода/вывода в процедуре. SQL_PARAM_OUTPUT маркирует значение возврата или параметр вывода в процедуре.

SWORD fCType - является С-типом данных для параметра. Это тип данных из которого необходимо конвертировать данные.

SWORD fSqlType - является ODBC типом данных для параметра. Это тип данных в которых конвертируются данные и он должен совпадать с SQL-типом столбца, соответствующего этому параметрическому маркеру.

UDWORD сbColDef - точность столбца или выражения соответствующего маркера параметра.

SWORD ibScale - размер столбца или выражения соответствующего маркера параметра

PTR rgbValue - указатель буфера для данных параметра, который при вызове SQLExecute или SQLExecuteDirect содержит действительные значения параметра.

SDWORD сbValueMax - максимальная длина буфера rgbValue.

SDWORD pcbValue - указатель буфера для длины параметра.

Ниже приведены основные значения С- и SQL-типов параметров.

С-тип		SQL-тип
SQL_C_BINARY	SQL_C_FLOAT	SQL_BINARY	SQL_DOUBLE
SQL_C_BIT	SQL_C_TIME	SQL_BIT	SQL_FLOAT
SQL_C_CHAR	SQL_C_DEFAULT	SQL_CHAR	SQL_INTEGER
SQL_C_DATE	SQL_C_SLONG	SQL_DATE	SQL_REAL
SQL_C_DOUBLE	SQL_C_SSHORT	SQL_DECIMAL	SQL_SMALLINT
		SQL_TIME	SQL_VARCHAR

5. Настройка доступа к источнику данных

Настройка доступа к источнику данных включает:

• редактирование файла .odbc.ini.;
• определение переменной ODBCINI;
• установка переменных окружения СУБД;
• включение необходимых заголовочных файлов.

Для настройки источника данных, необходимо проверить находится ли системный текстовый файл .odbc.ini в домашней директории пользователя и отредактировать его, настроив на требуемые источники данных.

В файле .odbc.ini должен быть под некоторым идентификатором описан требуемый источник данных, имя которого используется функцией SQLConnect(), и далее должен присутствовать раздел с данным именем, в котором содержатся атрибуты, описывающие источник данных. Файл .odbc.ini должен содержать имя источника данных, имя сервера баз данных, имя базы данных и другие атрибуты.

В переменной окружения ODBCINI необходимо указать полное имя системного файла .odbc.ini, если он расположен не в домашней директории. Сделать это можно, либо введя с консоли соответствующую команду, либо поместив эту команду в файл загрузки .login. Форма записи команды зависит от используемой программы Shell-интерпретатора.

Системные требования зависят от той СУБД, с которой работает пользователь. Например, при работе с СУБД Informix это обеспечивается переменными окружения, выставленными в файле .cshrc в домашней директории пользователя.

Для получения доступа до ODBC-функций, в программе должен быть описан заголовочный файл sqlext.h. В файле sqltypes.h находятся описание типов данных используемых в ODBC.

Как и любой исходный файл, написанный на языке Си, файл с программой, вызывающей ODBC-функции, должен иметь расширение .с. При компиляции необходимо подключить необходимые библиотеки, используемые в вызываемых функциях. Поскольку в этом случае командная строка принимает достаточно сложный вид, целесообразно на уровне системного администратора оформить командный файл, в котором подключаются необходимые библиотеки.

Последовательность выполнения лабораторной работы

1. Убедиться в наличии и заполненности базы данных поставщиков, деталей, изделий, поставок.
2. Разработать ODBC-программу для решения задачи 1 из соответствующего варианта с помощью функций непосредственного выполнения.
3. Разработать ODBC-программу для решения задачи 2 из соответствующего варианта с помощью функций подготавливаемого выполнения.
4. После выполнения лабораторной работы привести базу данных в исходное состояние.

Требования к разрабатываемой программе

Разрабатываемая программа должна удовлетворять следующим требованиям:

• все используемые функции ODBC должны анализироваться на корректность кода возврата;
• в программе должен быть предусмотрен вывод сообщений обо всех шагах ее выполнения, в том числе и о возможных ошибках;
• при выполнении запросов должно быть предусмотрено использование параметров; параметры варианта задания должны быть введены в ходе выполнения программы и переданы в SQL-запрос;
• при выполнении программы должна контролироваться целостность базы данных;
• программа должна быть достаточно документирована.

Варианты заданий

Вариант 1

1. Из таблицы поставок удалить поставки при заданных параметрах номера поставщика (имени поставщика) и номера детали.
2. Увеличить рейтинг поставщика, выполнившего наибольшую поставку некоторой детали, на указанную величину.

Вариант 2

1. Удалить всех поставщиков из указанного города.
2. Изменить цвет самой тяжелой детали на указанный.

Вариант 3

1. Вставить поставщика с заданными параметрами.
2. Удалить самую легкую деталь.

Вариант 4

1. Удалить поставщика, выполнившего меньше всего поставок.
2. Изменить название детали указанного цвета и веса.

Вариант 5

1. Удалить изделие из заданного города.
2. В таблице поставок изменить номер поставщика при заданном номере детали и изделия.

Вариант 6

1. Увеличить рейтинг поставщика, выполнившего больший суммарный объем поставок, на указанную величину.
2. Вставить деталь с заданными параметрами.

Вариант 7

1. Изменить название и город детали с максимальным весом на указанные значения.
2. Удалить из таблицы поставок все поставки конкретного поставщика.

Вариант 8

1. Увеличить рейтинг поставщика, выполнившего большее число поставок, на указанную величину.
2. Увеличить вес деталей из Лондона на некоторую величину.

Контрольные вопросы

1. Какова структура ODBC-программы? Перечислите ее основные компоненты.
2. С помощью каких средств ODBC можно отследить наличие ошибки?
3. В каких случаях непосредственное выполнение операторов является наиболее эффективным?
4. Когда используется подготавливаемое выполнение?
5. Как описываются маркеры параметров, и какая для этого предусмотрена функция? Каким образом можно связать несколько параметров?
6. С помощью какого параметра можно освободить буферы всех столбцов?
7. Как описать доступ до необходимой базы данных?
8. С помощью какой функции описывается соединение с необходимым источником данных? Каковы ее параметры?