Серверные курсоры API

Ограничения серверного курсора API

При использовании серверных курсоров API приложение не может выполнять следующие инструкции:

• инструкции Transact-SQL, которые SQL Server не поддерживает в серверных курсорах;

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

• инструкции SELECT, которые содержат предложения COMPUTE, COMPUTE BY, FOR BROWSE или INTO;

• инструкцию EXECUTE, которая содержит ссылку на удаленную хранимую процедуру.

Реализация серверного курсора API

Поставщик OLE DB для собственного клиента SQL Server и драйвер ODBC для собственного клиента SQL Server оповещает сервер об операциях с курсором при помощи следующих специальных системных хранимых процедур:

• процедура sp_cursoropen определяет инструкцию SQL, которая будет назначена курсору и параметрам курсора, а затем производит заполнение курсора;

• процедура sp_cursorfetch выполняет выборку из курсора строки или группы строк;

• процедура sp_cursorclose закрывает курсор и освобождает его ресурсы;

• процедура sp_cursoroption задает различные параметры курсора;

• процедура sp_cursor служит для запроса о выполнении нацеленных обновлений;

• процедура sp_cursorprepare компилирует план выполнения из инструкции или пакета инструкций Transact-SQL, связанных с курсором, но не создает курсор;

• процедура sp_cursorexecute создает и заполняет курсор в соответствии с планом выполнения, который был создан процедурой sp_cursorprepare;

• процедура sp_cursorunprepare удаляет план выполнения из sp_cursorprepare;

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

Эти системные хранимые процедуры отображаются приложением SQL Server Profiler в трассировках приложений ADO, OLE DB и ODBC, использующих серверные курсоры API. Они предназначены только для внутреннего использования поставщиком OLE DB для собственного клиента SQL Server и драйвером ODBC для собственного клиента SQL Server. Весь объем функциональных возможностей этих процедур доступен приложениям при использовании функций курсоров API-интерфейсов баз данных. Указание процедур непосредственно в приложениях не поддерживается.

Когда SQL Server выполняет инструкцию соединения, другие инструкции для этого соединения не могут быть выполнены до тех пор, пока не будут обработаны или отменены все результаты первой инструкции. Это правило распространяется и на использование серверных курсоров API, однако для приложения это выглядит так, будто SQL Server начал поддерживать несколько активных инструкций для одного соединения. Это происходит потому, что полный результирующий набор хранится в серверном курсоре, а в SQL Server передаются лишь инструкции, выполняющие системные хранимые процедуры sp_cursor. SQL Server выполняет эту хранимую процедуру и, как только клиент получает результирующий набор, может выполнить любую другую инструкцию. Перед передачей управления приложению поставщик OLE DB и драйвер ODBC всегда получают все результаты хранимой процедуры sp_cursor. Это позволяет приложениям обмениваться выборками между несколькими активными серверными курсорами.

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

Поскольку после любого вызова хранимой процедуры sp_cursor необработанных результатов для соединения не остается, несколько инструкций Transact-SQL могут быть выполнены одновременно для одного соединения при условии, что они все выполняются серверными курсорами API.

Указание серверных курсоров API

Сводка использования в API-интерфейсах серверных курсоров API:

• Интерфейс OLE DB

  • Откройте объект сеанса, откройте объект команды, укажите текст команды.

  • Задайте свойства набора строк для управления работой курсора, например DBPROP_OTHERINSERT, DBPROP_OTHERUPDATEDELETE, DBPROP_OWNINSERT, DBPROP_OWNUDPATEDELETE.

  • Выполните объект команды.

  • Отправьте строки в результирующий набор при помощи методов IRowset::GetNextRows, IRowsetLocate::GetRowsAt, IRowsetLocate::GetRowsAtBookmark и IRowsetScroll::GetRowsAtRatio.

• Интерфейс ODBC

  • Установите соединение и вызовите функцию SQLAllocHandle, чтобы назначить дескрипторы инструкций.

  • Вызовите функцию SQLSetStmtAttr, чтобы задать атрибуты SQL_ATTR_CURSOR_TYPE, SQL_ATTR_CONCURRENCY и SQL_ATTR_ROW_ARRAY_SIZE. Поведение курсора можно также указать, задав атрибуты SQL_ATTR_CURSOR_SCROLLABLE и SQL_ATTR_CURSOR_SENSITIVITY.

  • Выполните инструкцию Transact-SQL с помощью функций SQLExecDirect или SQLPrepare и SQLExecute.

  • Выполните выборку строк или группы строк с помощью функции SQLFetch или SQLFetchScroll.

• Интерфейс ADO

  • Определите объект Connection и объект Recordset, а затем выполните метод Open для объекта Connection.

  • Выполните метод Open для объекта Recordset, указав параметры CursorType или LockType.

  • Выполните выборку строк при помощи методов набора записей Move, MoveFirst, MoveLast, MoveNext и MovePrevious.

Серверные курсоры API и параметры SET

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

См. также

Основные понятия