次の方法で共有

sp_cursoroption (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server

カーソル オプションを設定するか、 sp_cursoropen ストアド プロシージャによって作成されたカーソル情報を返します。 sp_cursoroption は、表形式データ ストリーム (TDS) パケットで ID = 8 を指定することによって呼び出されます。

Transact-SQL 構文表記規則

構文

sp_cursoroption cursor , code , value
[ ; ]

引数

cursor

SQL Server によって生成され、sp_cursoropen ストアド プロシージャによって返されるhandle値。 cursor パラメーターは int であり、NULLすることはできません。

code

カーソル戻り値のさまざまな要因を指定するために使用されます。 code パラメーターは int で、次のいずれかの値である必要があります。

Value 名前 説明
0x0001 TEXTPTR_ONLY 指定された特定の text 列または image 列の実際のデータではなくテキスト ポインターを返します。

TEXTPTR_ONLYでは、後で Transact-SQL または DBLIB 機能 (Transact-SQL READTEXTや DBLIB DBWRITETEXT など) を使用して選択的に取得または更新できる BLOB オブジェクトに対して、テキスト ポインターをハンドルとして使用できます。
0値が割り当てられている場合、選択リスト内のすべてのテキスト列と画像列は、データではなくテキスト ポインターを返します。
0x0002 CURSOR_NAME value で指定された名前をカーソルに割り当てます。これにより、ODBC は、sp_cursoropenを介して開かれたカーソルで Transact-SQL の位置指定されたUPDATE/DELETE ステートメントを使用できます。

文字列は、任意の文字または Unicode データ型として指定できます。
Transact-SQL の位置指定 UPDATE/DELETE ステートメントは既定で fat カーソルの最初の行で動作するため、 sp_cursor SETPOSITION を使用して、位置指定された UPDATE/DELETE ステートメントを発行する前にカーソルを配置する必要があります。
0x0003 TEXTDATA 後続のフェッチ時の特定のテキスト列または画像列に対して、テキスト ポインターではなく実際のデータを返します (つまり、 TEXTPTR_ONLYの影響を元に戻します)。

特定の列に対して TEXTDATA が有効になっている場合、行は再フェッチまたは更新され、 TEXTPTR_ONLYに戻すことができます。 TEXTPTR_ONLYと同様に、value パラメーターは列番号を指定する整数であり、ゼロの値はすべてのテキスト列またはイメージ列を返します。
0x0004 SCROLLOPT スクロール オプションです。 詳細については、「 コード値を返す」を参照してください。
0x0005 CCOPT コンカレンシー制御オプション。 詳細については、「 コード値を返す」を参照してください。
0x0006 ROWCOUNT 結果セット内の現在の行数。

注: 非同期作成が使用されている場合、sp_cursoropenによって返される値以降、ROWCOUNTが変更されている可能性があります。 行数が不明な場合は、 -1 値が返されます。

value

codeによって返される値を指定します。 value は、 0x0001、 0x0002、または 0x0003 code 入力値を呼び出す必須のパラメーターです。

2のコード値は文字列データ型です。 その他の コード 値の入力または value によって返される値は intです。

リターン コードの値

value パラメーターは、次のいずれかのcode値を返します。

戻り値 説明
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

value パラメーターは、次のいずれかのSCROLLOPT値を返します。

戻り値 説明
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

value パラメーターは、次のいずれかのCCOPT値を返します。

戻り値 説明
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC

関連するコンテンツ