sp_describe_cursor_tables (Transact-SQL)

Crea un report degli oggetti o delle tabelle di base a cui fa riferimento un cursore del server.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_describe_cursor_tables 
     [ @cursor_return = ] output_cursor_variable OUTPUT 
     { [ , [ @cursor_source = ] N'local'
     , [@cursor_identity = ] N'local_cursor_name' ] 
   | [ , [ @cursor_source = ] N'global'
     , [ @cursor_identity = ] N'global_cursor_name' ] 
   | [ , [ @cursor_source = ] N'variable'
     , [ @cursor_identity = ] N'input_cursor_variable' ] 
     } 

Argomenti

[ @cursor_return = ] output_cursor_variableOUTPUT

Nome di una variabile di cursore dichiarata per la ricezione dell'output del cursore. output_cursor_variable è di tipo cursor e non prevede alcun valore predefinito. È inoltre necessario che la variabile non sia associata ad alcun cursore al momento della chiamata della stored procedure sp_describe_cursor_tables. Il cursore restituito è di tipo scorrevole, dinamico e di sola lettura.

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

Specifica se il cursore oggetto del report viene specificato utilizzando il nome di un cursore locale, di un cursore globale o di una variabile di cursore. Il parametro è di tipo nvarchar(30).

[ @cursor_identity = ] N'local_cursor_name'

Nome di un cursore creato da un'istruzione DECLARE CURSOR con la parola chiave LOCAL specificata in modo esplicito o utilizzata per impostazione predefinita. local_cursor_name è di tipo nvarchar(128).

[ @cursor_identity = ] N'global_cursor_name'

Nome di un cursore creato da un'istruzione DECLARE CURSOR con la parola chiave GLOBAL specificata in modo esplicito o utilizzata per impostazione predefinita. global_cursor_name può inoltre essere il nome di un cursore API del server aperto da un'applicazione ODBC che ha specificato il cursore tramite una chiamata di SQLSetCursorName. global_cursor_name è di tipo nvarchar(128).

[ @cursor_identity = ] N'input_cursor_variable'

Nome di una variabile di cursore associata a un cursore aperto. input_cursor_variable è di tipo nvarchar(128).

Osservazioni

La stored procedure sp_describe_cursor_tables descrive le tabelle di base a cui fa riferimento un cursore del server. Utilizzare sp_describe_cursor_columns per ottenere una descrizione degli attributi del set dei risultati restituito dal cursore. Utilizzare sp_describe_cursor per ottenere una descrizione delle caratteristiche globali del cursore, come il supporto dello scorrimento e degli aggiornamenti. Utilizzare sp_cursor_list per ottenere un report dei cursori del server Transact-SQL visibili nella connessione.

Autorizzazioni

È richiesta l'appartenenza al ruolo public.

Valori restituiti

Nessuno

Cursori restituiti

sp_describe_cursor_tables incapsula il report generato come parametro di output cursor Transact-SQL. In questo modo i batch, le stored procedure e i trigger Transact-SQL possono elaborare l'output una riga alla volta. Ciò significa inoltre che non è possibile chiamare direttamente la procedura da funzioni API. Il parametro di output cursor deve essere associato a una variabile di programma, ma le API non supportano l'associazione di parametri o variabili cursor.

Nella tabella seguente viene descritto il formato del cursore restituito da sp_describe_cursor_tables.

Esempi

Nell'esempio seguente viene aperto un cursore globale ed eseguita la stored procedure sp_describe_cursor_tables per creare un report sulle tabelle a cui fa riferimento il cursore.

USE AdventureWorks
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Contact
WHERE LastName LIKE 'S%'

OPEN abc
GO
-- Declare a cursor variable to hold the cursor output variable
-- from sp_describe_cursor_tables.
DECLARE @Report CURSOR

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

-- Fetch all the rows from the sp_describe_cursor_tables 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_tables.
CLOSE @Report
DEALLOCATE @Report
GO

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

Vedere anche

Riferimento

CURSOR_STATUS (Transact-SQL)
DECLARE CURSOR (Transact-SQL)
sp_cursor_list (Transact-SQL)
sp_describe_cursor (Transact-SQL)
sp_describe_cursor_columns (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Altre risorse

Cursori (Motore di database)

Guida in linea e informazioni

Assistenza su SQL Server 2005