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 следует использовать для размещения курсора перед выдачой позиционированного UPDATE DELETE /оператора.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 |