sp_describe_cursor (Transact-SQL)

S'applique à : SQL Server

Indique les attributs d'un curseur côté serveur.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @cursor_return = ] sortie de cursor_return

Nom d’une variable de curseur déclarée à recevoir la sortie du curseur. @cursor_return est un paramètre OUTPUT de type int, sans valeur par défaut, et ne doit pas être associé à des curseurs au moment sp_describe_cursor de l’appel. Le curseur retourné est un curseur en lecture seule, dynamique et permettant les défilements.

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

Spécifie si le curseur signalé est spécifié à l’aide du nom d’un curseur local , d’un curseur global ou d’une variable de curseur. @cursor_source est nvarchar(30), sans valeur par défaut.

[ @cursor_identity = ] N’cursor_identity'

Nom d’un curseur créé par une DECLARE CURSOR instruction. @cursor_identity est nvarchar(128), sans valeur par défaut.

• Si le curseur a le LOCAL mot clé ou est défini LOCALpar défaut, @cursor_identity est local.

• Si le curseur a le GLOBAL mot clé ou est défini GLOBALpar défaut, @cursor_identity est global. @cursor_identity peut également être le nom d’un curseur de serveur d’API ouvert par une application ODBC, puis nommé en appelant SQLSetCursorName.

• Sinon, @cursor_identity est le nom d’une variable de curseur associée à un curseur ouvert.

Valeurs des codes de retour

Aucune.

Curseurs retournés

sp_describe_cursor encapsule son jeu de résultats dans un paramètre de sortie Transact-SQL cursor . Cela permet aux lots Transact-SQL, aux procédures stockées et aux déclencheurs d’utiliser la sortie d’une ligne à la fois. Cela signifie également que la procédure ne peut pas être appelée directement à partir des fonctions d’API de base de données. Le cursor paramètre de sortie doit être lié à une variable de programme, mais les API de base de données ne prennent pas en charge les paramètres de liaison cursor ou les variables.

Le tableau suivant montre le format du curseur retourné à l’aide sp_describe_cursorde . Le format du curseur est identique au format retourné à l’aide sp_cursor_listde .

Notes

sp_describe_cursor décrit les attributs globaux à un curseur de serveur, tels que la possibilité de faire défiler et de mettre à jour. Pour sp_describe_cursor_columns obtenir une description des attributs du jeu de résultats retourné par le curseur. Permet sp_describe_cursor_tables d’utiliser un rapport des tables de base référencées par le curseur. Pour obtenir un rapport des curseurs de serveur Transact-SQL visibles sur la connexion, utilisez sp_cursor_list.

Une DECLARE CURSOR instruction peut demander un type de curseur que SQL Server ne peut pas prendre en charge à l’aide de l’instruction SELECT contenue dans le DECLARE CURSOR. SQL Server convertit implicitement le curseur en un type qu’il peut prendre en charge à l’aide de l’instruction SELECT . Si TYPE_WARNING elle est spécifiée dans l’instruction, SQL Server envoie à l’application DECLARE CURSOR un message d’information indiquant qu’une conversion a été effectuée. sp_describe_cursor peut ensuite être appelé pour déterminer le type de curseur implémenté.

autorisations

Nécessite l'appartenance au rôle public .

Exemples

Cet exemple ouvre un curseur global et utilise sp_describe_cursor pour fournir un rapport sur les attributs du curseur.

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

Contenu connexe

• Curseurs (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)