• [アーティクル]

OPEN (Transact-SQL)

Transact-SQL サーバー カーソルをオープンし、DECLARE CURSOR または SET cursor_variable ステートメントで指定される Transact-SQL ステートメントを実行することによって、カーソルを生成します。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

OPEN { { [ GLOBAL ] cursor_name } | cursor_variable_name }

引数

  • GLOBAL
    cursor_name でグローバル カーソルを参照することを指定します。

  • cursor_name
    宣言済みのカーソルの名前を指定します。cursor_name という名前のグローバル カーソルとローカル カーソルの両方がある場合、GLOBAL を指定すると、cursor_name 引数はグローバル カーソルを参照します。GLOBAL を指定しないと、cursor_name 引数はローカル カーソルを参照します。

  • cursor_variable_name
    カーソルを参照するカーソル変数の名前を指定します。

説明

INSENSITIVE または STATIC オプションと共にカーソルが宣言されている場合、OPEN を実行すると結果セットを格納する一時テーブルが作成されます。結果セット内の行のサイズが SQL Server テーブルの最大行サイズを超えると、OPEN は失敗します。KEYSET オプションと共にカーソルが宣言されている場合、OPEN を実行するとキーセットを格納する一時テーブルが作成されます。一時テーブルは tempdb に格納されます。

カーソルをオープンした後、最後にオープンしたカーソル内の該当する行数を受け取るには、@@CURSOR_ROWS 関数を使用します。

注意注

SQL Server では、キーセット ドリブンまたは静的な Transact-SQL カーソルの非同期的な生成がサポートされません。OPEN や FETCH などの Transact-SQL カーソル操作は、一括処理されます。したがって、Transact-SQL カーソルを非同期に生成する必要がありません。SQL Server では、各カーソル操作に対するクライアントのラウンド トリップによる低待機時間の問題が OPEN にある場合、非同期のキーセット ドリブンまたは静的な API (アプリケーション プログラミング インターフェイス) サーバー カーソルが引き続きサポートされます。

例

次の例では、カーソルをオープンし、すべての行をフェッチします。

DECLARE Employee_Cursor CURSOR FOR
SELECT LastName, FirstName
FROM AdventureWorks2008R2.HumanResources.vEmployee
WHERE LastName like 'B%';

OPEN Employee_Cursor;

FETCH NEXT FROM Employee_Cursor;
WHILE @@FETCH_STATUS = 0
BEGIN
    FETCH NEXT FROM Employee_Cursor
END;

CLOSE Employee_Cursor;
DEALLOCATE Employee_Cursor;