Отримання даних

План

Лекція № 22

Тема: Підготовка і виконання запиту. Отримання даних. Відключення.

1. Підготовка і виконання запитів SQL

2. Отримання даних

3. Відключення від джерела даних

Підготовка і виконання запитів SQL

Останнє, що додаток повинен зробити після підключення до джерела даних, але перш, ніж воно буде здатне здійснювати запити SQL, — це отримати дескриптор оператора (statement handle) або hstmt. Щоб отримати дескриптор hstmt, достаточш оголосити змінну типу SQLHSTMT і викликати функцію SQLAllocHancUe, переду! їй як аргументи константу SQL_HANDLE__STMT і адреса оголошеною змінно» hstmt. Нижче приведений фрагмент коди, що демонструє, як це зробити:

SQLSTMT hstmt;

SQLRETURN re = SQLAllocHandle<SQL_HANDLE_STMT

hdbc, Shstmt);

Як тільки додаток отримає дескриптор hstmt, воно зможе передавати джерелу енних оператори SQL. Існує два разных способу організації виконання джерелом даних запиту SQL. Перший має на увазі застосування функції SQLExecDirect, другим аргументом якої є оператор SQL, як показано в прикладі, приведеному нижче. Ця функція додасть в таблицю UserMaster новий рядок даних:

SOLRETURN гс =::SQLExecDirect(hstmt

(unsigned char*)"INSERT INTO " "UserMaster VALUES('USERLD' " "'User Name', 0)", SQL_NTS))

Другий спосіб виконання оператора має на увазі його попередню підготовку за допомогою функції SQLPrepare, а також його подальше виконання за допомогою функції SQLExecute, як показано в прикладі, приведеному нижче.

SQLRETURN re;

LPCSTR szSQL = "INSERT INTO UserMaster "

"values('UserlD2', 'Just Another User', 0) "/

if (SQL_SUCCESS == (re =::SQLPrepare (hstmt

(unsigned char*)szSQL, SQL_NTS)))

(if (SQL_SUCCESS == (re =::SQLExecute (hstmt)))

При частому виконанні різних операторів SQL подібна комбінація функцій SQLPrepare/SQLExecute набагато ефективніша, ніж просто виклик функції SQLExecDirect. Це пов'язано з тим, що при кожному виклику функції SQLExecDirect вираз повинен відкомпілюватися (compiled) основний DBMS. Проте при попередньому виклику функції SQLPrepare вираз відкомпілюється тільки один раз, а потім кожного разу використовуватиметься функцією SQLExecute в готовому вигляді.

У попередньому розділі продемонстровані два разных способу застосування оператора SQL, що додає дані в таблицю. Але що, якщо в результаті виконання оператора SQL будуть повернені дані, і як передати їх в змінні застосування? Для цього призначена наступна група функцій ODBC. Коли функція ODBC повертає результуючий набір даних (result set) (або набір результатов— resuitset), змінні застосування необхідно пов'язати (bind) з полями повертаних даних. ODBC надає щонайширший набір різноманітних типів даних, доступних для застосування у складі застосування, що розробляється.

Якщо гнучкість додатку є одному з головних завдань проекту, то користь від застосування функцій SQLNumResultCols, SQLDescribeCol і SQLGetData в його складі буде вельми ощутима. Ці функції дозволяють розробникові створювати додатки баз даних, не піклуючись заздалегідь про те, скільки полів і якого типу повертатиме джерело даних у складі результуючого набору даних. Наприклад, ці функції можна було б використовувати у складі додатку, що дозволяє користувачеві самостійно формувати запити, передавані базі даних. У зв'язку з динамічним характером цього застосування йому не буде заздалегідь відома кількість і тип даних полів, повертаних в результаті їх виконання.

Оскільки ж додаток може дізнатися, які саме дані були повернені в результаті запиту, якщо це не було визначено заздалегідь, до виконання запиту? Додаток використовує функції, описані в попередньому розділі, для компіляції і виконання призначених для користувача операторів SQL. Потім ODBC повертає дескриптор результуючого набору даних. Але додатку нічого не відомо ні про кількість полів, повернених в результуючому наборі даних, ні про їх тип. Так, щоб визначити, скільки саме полів (стовпців) було повернено в результуючому наборі даних, додаток звертається до функції SQLNumResultCols. Потім воно викликає функцію SQLNumResultCols для кожного з полів, щоб з'ясувати тип розташованих в них даних. Як тільки тип даних певного поля стає відомий, застосовується функція SQLGetData, що дозволяє витягувати з нього значення. Безумовно, це опис вельми схемний, проте воно дає загальне уявлення про процес застосування цих функцій. Більш детально дана тема розглядається на прикладі другого і третього демонстраційних додатків цього розділу.

Цілком очевидно, що такий рівень гнучкості, який описаний вищим, потрібний зовсім не кожному застосуванню. Більшість розробників баз даних використовують оператори SQL, жорстко задані в коді застосування, а отже, їм не потрібно звертатися до ODBC, щоб з'ясувати тип даних повертаних в результуючому наборі даних. В цьому випадку для витягання даних з результуючого набору даних і привласнення їх змінним додатку можна скористатися функціями SQLBindCol і SQLFetch. Функція SQLBindCol, що відповідає за скріплення даних, дозволяє вказати номер поля результуючого набору даних, тип даних цього поля результуючого набору даних, а також адресу змінної додатку, яка отримає ці дані при виклику функції SQLFetch, що відповідає за вибірку зв'язаних даних.

Звернете увагу, немає ніякої необхідності зв'язувати всі поля, досить зв'язати лише ті поля, дані яких необхідно передати в змінні. Функцію SQLBindCol необхідно викликати один раз, але для кожного використовуваного поля, а функцію SQLFetch після цього можна викликати багато раз, при кожній необхідності прочитати результуючий набір даних. Нижче приведений приклад застосування обох функцій для отримання даних з результуючого набору даних. Цей фрагмент коди має на увазі, що оператори SQL, організуючі повернення результуючого набору даних, вже були виконані:

#define LEN_USERID 16

SDWORD cb;

char szUserID[LEN_USERID];

if (SQL_SUCCESS == (re = SQLBindCol(hstmt, 1

SQL_C_CHAR, szUserlD, LENJJSERID &cb))) {

if (SQL_SUCCESS == (re = SQLFetch(hstmt))) {

// Тепер szUserlD містить значення з першого

// поля поверненого набору результатів.

Дата добавления: 2014-01-07