Поделиться через


sp_cursoroption (Transact-SQL)

Область применения: SQL Server

Задает параметры курсора или возвращает сведения о курсоре, созданные хранимой процедурой sp_cursoropen . sp_cursoroption вызывается путем ID = 8 указания в пакете табличного потока данных (TDS).

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_cursoroption cursor , code , value
[ ; ]

Аргументы

курсор

handle Значение, созданное SQL Server и возвращаемое хранимой процедуройsp_cursoropen. Параметр курсора является int и не может бытьNULL.

code

Служит для указания различных коэффициентов возвращаемых значений курсора. Параметр кода имеет значение int и должен быть одним из следующих значений:

Значение Имя Описание
0x0001 TEXTPTR_ONLY Возвращает не фактические данные, а текстовый указатель для определенных назначенных столбцов типа text или image.

TEXTPTR_ONLY позволяет использовать текстовые указатели в качестве дескрипторов для объектов BLOB-объектов, которые позже могут быть выборочно извлечены или обновлены с помощью средств Transact-SQL или DBLIB (например, Transact-SQL READTEXT или DBLIB DBWRITETEXT).
0 Если присвоено значение, все столбцы текста и изображения в списке выбора возвращают текстовые указатели, а не данные.
0x0002 CURSOR_NAME Присваивает имя, указанное в значении курсору, что позволяет ODBC использовать операторы Transact-SQL, расположенныеDELETE UPDATE/на курсорах, открытых с помощьюsp_cursoropen.

Строка может иметь любой символьный тип данных или UNICODE.
Так как операторы Transact-SQL работают по умолчанию на первой строке в жировом курсоре, sp_cursor SETPOSITION следует использовать для размещения курсора перед выдачой позиционированного UPDATEDELETE/оператора.UPDATE/DELETE
0x0003 TEXTDATA Возвращает фактические данные, а не текстовый указатель, для определенных столбцов текста или изображения на последующих извлечениях (то есть это отменяет эффект TEXTPTR_ONLY).

Если TEXTDATA включено для определенного столбца, строка возвращается или обновляется, а затем может быть возвращена TEXTPTR_ONLY. Как и при использовании TEXTPTR_ONLY, параметр значения представляет собой целое число, указывающее номер столбца, а нулевое значение возвращает все текстовые столбцы или столбцы изображения.
0x0004 SCROLLOPT Параметр прокрутки. Дополнительные сведения см. в разделе "Возвращаемые значения кода".
0x0005 CCOPT Параметр управления параллелизмом. Дополнительные сведения см. в разделе "Возвращаемые значения кода".
0x0006 ROWCOUNT Количество строк, находящихся в результирующем наборе.

Примечание. Возможно ROWCOUNT , значение изменилось с момента возврата значения, возвращаемого sp_cursoropen при использовании асинхронной совокупности. -1 Значение возвращается, если число строк неизвестно.

значение

Указывает значение, возвращаемое кодом. значением является обязательный параметр, который вызывает 0x0001значение входных данных или 0x0003 код. 0x0002

Значение 2 кода — это строковый тип данных. Любое другое входное значение кода или возвращаемое значением является int.

Значения кода возврата

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

Возвращаемое значение Description
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

Параметр значения возвращает одно из следующих SCROLLOPT значений.

Возвращаемое значение Description
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

Параметр значения возвращает одно из следующих CCOPT значений.

Возвращаемое значение Description
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC