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

непосредственное

Непосредственное выполнение целесообразно использовать в следующих случаях:

• SQL– операторы, которые должны быть выполнены, выполняются только один раз;

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

Непосредственное выполнение реализуется с помощью функции SQLExecDirect()и представляет наиболее быстрый способ запускаSQL– оператора при одноразовом выполнении.

Синтаксис функции имеет вид:

RETCODESQLExecDirect(hstmt,szSqlStr,sbSqlStr)

подготавливаемое выполнение

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

SQLPrepare() подготавливаетSQL– строку для выполнения. Синтаксис её ничем не отличается от синтаксисаSQLExecDirect(). СинтаксисSQLExecute() следующий:

RETCODESQLExecute(hsmt)

где HSMT– предварительно назначенный идентификатор оператора.

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

79 Выборка результатов.

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

Результирующее множество представляет собой набор строк и столбцов, которые были определены SQL– оператором или функцией каталога.

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

Курсор автоматически генерируется для каждого результирующего множества. Непосредственно после создания результирующего множества, курсор устанавливается перед первой строкой данных. Для продвижения курсора следует вызывать функцию SQLFetch(). Данная функция продвигает курсор вперед на одну строку до тех пор, пока он не будет установлен за последней строкой результирующего множества.

Для определения числа столбцов, которые были возвращены с помощью подготовленного или выполненного оператора, прикладная программа выполняет функцию SQLNumResultCols(), которая имеет следующий синтаксис:

RETCODE SQLNumResultCols (hstmt, pccol)

Для возвращения числа строк, на которые воздействовал SQL– оператор, прикладная программа вызывает функциюSQLRowCount(). Данная функция возвращает число строк на которые воздействовал операторupdate,insertилиdeleteи имеет следующий синтаксис:

RETCODESQLRowCount(hstmt,pcrow)

В ODBCсуществует две функции базового уровня для выборки результатов:SQLBindCol()иSQLFetch().ФункцияSQLBindCol() определяет область хранения данных результирующего множества, аSQLFetch() осуществляет выборку данных в области хранения. Алгоритм программы предполагает выполнение следующих шагов:

1. Вызов SQLBindCol() один раз для каждого столбца, который должен быть возвращен из результирующего множества,

2. Вызов SQLFetch() для перемещения курсора на следующую строку и возврата данных из связанных столбцов,

3. Повторение шага 2 до тех пор пока SQLFetch() не возвратитSQL_NO_DATA_FOUND. Это указывает на то, что был достигнут конец результирующего множества.

Функция SQLFetch() извлекает строку данных из результирующего множества для выполненногоSQL– оператора. Драйвер возвращает данные для всех столбцов, которые были связаны для предварительного хранения данных с помощью функцииSQLBindCol(). Синтаксис функцииSQLFetch():

RETCODESQLFetch(hstmt)

Здесь HSTMT– идентификатор выполненного оператора.

Функция SQLBindCol() назначает область хранения в памяти и тип данных для столбца результирующего множества. Она определяет:

• Буфер хранения для получения содержимого столбца данных в результирующем множестве,

• Длину указанного буфера хранения,

• Область памяти для хранения длины столбца выборки

• Преобразование типа данных.

Синтаксис данной функции имеет следующий вид:

RETCODE SQLBindCol (hstmt, icol, fcType, rgbValue, cbValueMax,pcbValue)