sp_cursor_list (Transact-SQL)

Sintassi

sp_cursor_list [ @cursor_return = ] cursor_variable_name OUTPUT 
          , [ @cursor_scope = ] cursor_scope
[;]

Argomenti

• [ @cursor_return = ] cursor_variable_nameOUTPUT
  Nome di una variabile di cursore dichiarata. cursor_variable_name è di tipo cursor e non prevede alcun valore predefinito. Il cursore restituito è di tipo scorrevole, dinamico e di sola lettura.

• [ @cursor_scope = ] cursor_scope
  Specifica il livello dei cursori da restituire. cursor_scope è di tipo int e non prevede alcun valore predefinito. I possibili valori sono i seguenti.

  Valore	Descrizione
  1	Restituisce tutti i cursori locali.
  2	Restituisce tutti i cursori globali.
  3	Restituisce i cursori locali e quelli globali.

Valori restituiti

Nessuno

Cursori restituiti

sp_cursor_list restituisce un report come parametro di output di un cursore Transact-SQL, anziché come set di risultati. In questo modo i batch, le stored procedure e i trigger Transact-SQL possono elaborare l'output una riga alla volta. Non è possibile richiamare direttamente la procedura da funzioni API del database. Il parametro di output del cursore deve essere associato a una variabile di programma, ma le API del database non supportano l'associazione di parametri o variabili del cursore.

Di seguito è riportato il formato del cursore restituito da sp_cursor_list. Il formato del cursore è analogo a quello restituito da sp_describe_cursor.

Osservazioni

La stored procedure sp_cursor_list consente di creare un elenco dei cursori del server aperti nella connessione e di ottenere una descrizione degli attributi globali di ogni cursore, ad esempio se è scorrevole e aggiornabile. I cursori elencati tramite sp_cursor_list sono i seguenti:

• I cursori del server Transact-SQL.

• I cursori API del server aperti in un'applicazione ODBC in cui è stato richiamato successivamente SQLSetCursorName per assegnare un nome al cursore.

Utilizzare sp_describe_cursor_columns per ottenere una descrizione degli attributi del set dei risultati restituito dal cursore. Utilizzare sp_describe_cursor_tables per ottenere un report delle tabelle di base a cui il cursore fa riferimento. La stored procedure sp_describe_cursor restituisce le stesse informazioni di sp_cursor_list, ma solo per il cursore specificato.

Autorizzazioni

Le autorizzazioni di esecuzione vengono assegnate per impostazione predefinita al ruolo public.

Esempi

Nell'esempio seguente viene aperto un cursore globale e viene utilizzata la stored procedure sp_cursor_list per creare un report degli attributi del cursore.

USE AdventureWorks2008R2;
GO
-- Declare and open a keyset-driven cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Person
WHERE LastName LIKE 'S%';
OPEN abc;

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

-- Execute sp_cursor_list into the cursor variable.
EXEC master.dbo.sp_cursor_list @cursor_return = @Report OUTPUT,
      @cursor_scope = 2;

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

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

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

Vedere anche

Riferimento