sp_describe_cursor (Transact-SQL)

適用対象: SQL サーバー

サーバー カーソルの属性を報告します。

Transact-SQL 構文表記規則

構文

sp_describe_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    , [ @cursor_source = ] { N'local' | N'global' | N'*cursor_source*' }
    , [ @cursor_identity = ] N'cursor_identity'
[ ; ]

引数

[ @cursor_return = ] cursor_return OUTPUT

カーソル出力を受け取る宣言済みカーソル変数の名前。 @cursor_return は、既定値のない int 型の OUTPUT パラメーターであり、 sp_describe_cursor が呼び出された時点でカーソルに関連付けてはなりません。 返されるカーソルは、スクロール可能な動的な読み取り専用カーソルです。

[ @cursor_source = ] { N'local' |N'global' |N'cursor_source' }

レポート対象のカーソルを、 local カーソル、 global カーソル、またはカーソル変数の名前を使用して指定するかどうかを指定します。 @cursor_source は nvarchar(30)で、既定値はありません。

[ @cursor_identity = ] N'cursor_identity'

DECLARE CURSOR ステートメントによって作成されたカーソルの名前。 @cursor_identity は nvarchar(128)で、既定値はありません。

• カーソルに LOCAL キーワードがある場合、または既定で LOCAL に設定されている場合、 @cursor_identity は local。

• カーソルに GLOBAL キーワードがある場合、または既定で GLOBAL に設定されている場合、 @cursor_identity は global。 @cursor_identity ODBC アプリケーションによって開かれた API サーバー カーソルの名前を指定し、 SQLSetCursorNameを呼び出すことによって名前を付けることもできます。

• それ以外の場合、 @cursor_identity は、開いているカーソルに関連付けられているカーソル変数の名前です。

リターン コードの値

なし。

返されるカーソル

sp_describe_cursor は、その結果セットを Transact-SQL cursor 出力パラメーターにカプセル化します。 これにより、Transact-SQL のバッチ、ストアド プロシージャ、およびトリガーは、一度に 1 行ずつ出力を操作できます。 これは、データベース API 関数からプロシージャを直接呼び出すことはできません。 cursor出力パラメーターはプログラム変数にバインドする必要がありますが、データベース API ではcursorパラメーターまたは変数のバインドはサポートされていません。

次の表は、 sp_describe_cursorを使用して返されるカーソルの形式を示しています。 カーソルの形式は、 sp_cursor_listを使用して返される形式と同じです。

解説

sp_describe_cursor は、スクロールや更新の機能など、サーバー カーソルに対してグローバルな属性を記述します。 カーソルによって返される結果セットの属性の説明には、 sp_describe_cursor_columns を使用します。 カーソルによって参照されるベース テーブルのレポートには、 sp_describe_cursor_tables を使用します。 接続に表示されている Transact-SQL サーバー カーソルのレポートを取得するには、 sp_cursor_listを使用します。

DECLARE CURSOR ステートメントは、sql Server がDECLARE CURSORに含まれるSELECT ステートメントを使用してサポートできないカーソルの種類を要求する場合があります。 SQL Server は、 SELECT ステートメントを使用して、カーソルをサポートできる型に暗黙的に変換します。 DECLARE CURSOR ステートメントでTYPE_WARNINGが指定されている場合、SQL Server は変換が完了したことを示す情報メッセージをアプリケーションに送信します。 sp_describe_cursor を呼び出して、実装されているカーソルの種類を決定できます。

アクセス許可

ロール public のメンバーシップが必要です。

例

次の例では、グローバル カーソルを開き、sp_describe_cursor を使用してカーソルの属性をレポートします。

USE AdventureWorks2022;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR STATIC FOR
SELECT LastName
FROM Person.Person;

OPEN abc;

-- Declare a cursor variable to hold the cursor output variable
-- from sp_describe_cursor.
DECLARE @Report CURSOR;

-- Execute sp_describe_cursor into the cursor variable.
EXEC master.dbo.sp_describe_cursor
    @cursor_return = @Report OUTPUT,
    @cursor_source = N'global',
    @cursor_identity = N'abc';

-- Fetch all the rows from the sp_describe_cursor output cursor.
FETCH NEXT from @Report;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
    FETCH NEXT from @Report;
END

-- Close and deallocate the cursor from sp_describe_cursor.
CLOSE @Report;
DEALLOCATE @Report;
GO

-- Close and deallocate the original cursor.
CLOSE abc;
DEALLOCATE abc;
GO

関連するコンテンツ

• カーソル (SQL Server)
• CURSOR_STATUS (Transact-SQL)
• DECLARE CURSOR (Transact-SQL)
• sp_cursor_list (Transact-SQL)
• sp_describe_cursor_columns (Transact-SQL)
• sp_describe_cursor_tables (Transact-SQL)