sp_describe_cursor_columns (Transact-SQL)

Articolo
08/21/2023

Si applica a:SQL Server

Crea un report degli attributi associati alle colonne del set di risultati in un cursore del server.

Sintassi

  
sp_describe_cursor_columns   
   [ @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_variable OUTPUT
Nome di una variabile di cursore dichiarata per ricevere l'output del cursore. output_cursor_variable è cursore, senza impostazione predefinita e non deve essere associato ad alcun cursore al momento in cui viene chiamato sp_describe_cursor_columns. Il cursore restituito è di tipo scorrevole, dinamico e di sola lettura.

[ @cursor_source= ] { N'local' | N'global' | N'variable' }
Specifica se il cursore di cui viene generato il report viene specificato utilizzando il nome di un cursore locale, di un cursore globale o di una variabile di cursore. Il parametro è nvarchar(30).

[ @cursor_identity= ] N'local_cursor_name'
Nome di un cursore creato da un'istruzione DECLARE CURSOR con la parola chiave LOCAL o impostato sul valore predefinito LOCAL. local_cursor_name è nvarchar(128).

[ @cursor_identity= ] N'global_cursor_name'
Nome di un cursore creato da un'istruzione DECLARE CURSOR con la parola chiave GLOBAL o impostato sul valore predefinito GLOBAL. global_cursor_name è nvarchar(128).

global_cursor_name può essere anche il nome di un cursore del server API aperto da un'applicazione ODBC e quindi denominato chiamando SQLSetCursorName.

[ @cursor_identity= ] N'input_cursor_variable'
Nome di una variabile di cursore associata a un cursore aperto. input_cursor_variable è nvarchar(128).

Valori del codice restituito

Nessuno

Cursori restituiti

sp_describe_cursor_columns incapsula il report come parametro di output del cursore Transact-SQL. In questo modo, i batch Transact-SQL, le stored procedure e i trigger possono funzionare con l'output di una riga alla volta. Questo significa inoltre che 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 di database non supportano parametri o variabili del cursore di associazione.

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

Nome colonna	Tipo di dati	Descrizione
column_name	sysname (nullable)	Nome assegnato alla colonna del set di risultati. La colonna è NULL se è stata specificata senza la clausola AS.
ordinal_position	int	Posizione relativa della colonna a partire dalla prima colonna a sinistra del set di risultati. La prima colonna si trova nella posizione 0.
column_characteristics_flags	int	Maschera di bit che indica le informazioni archiviate in DBCOLUMNFLAGS in OLE DB. I possibili valori sono i seguenti: 1 = Segnalibro 2 = Lunghezza fissa 4 = Ammette valori Null 8 = Controllo delle versioni delle righe 16 = Colonna aggiornabile (viene impostata per le eventuali colonne di cursore prive della clausola FOR UPDATE; un cursore può includere una sola colonna di questo tipo) Quando i valori bit vengono combinati, vengono applicate le caratteristiche dei valori bit combinati. Se, ad esempio, il valore bit è 6, la colonna è a lunghezza fissa (2) e ammette valori Null (4).
column_size	int	Dimensioni massime consentite per un valore della colonna.
data_type_sql	smallint	Numero che indica il tipo di dati di SQL Server della colonna.
column_precision	tinyint	Precisione massima della colonna in base al valore bPrecision in OLE DB.
column_scale	tinyint	Numero di cifre a destra del separatore decimale per i tipi di dati numerici o decimali in base al valore bScale in OLE DB.
order_position	int	Se la colonna partecipa all'ordinamento del set di risultati, posizione della colonna nella chiave di ordinamento relativa alla prima colonna a sinistra.
order_direction	varchar(1)(nullable)	A = La colonna è inclusa nella chiave di ordinamento e l'ordine è crescente. D = La colonna è inclusa nella chiave di ordinamento e l'ordine è decrescente. NULL = La colonna non partecipa all'ordinamento.
hidden_column	smallint	0 = La colonna è inclusa nell'elenco di selezione. 1 = Riservato per utilizzi futuri.
columnid	int	ID della colonna di base. Se la colonna del set di risultati è stata creata in base a un'espressione, columnid è -1.
objectid	int	ID dell'oggetto o della tabella di base che include la colonna. Se la colonna del set di risultati è stata creata in base a un'espressione, objectid è -1.
dbid	int	ID del database contenente la tabella di base che include la colonna. Se la colonna del set di risultati è stata creata in base a un'espressione, dbid è -1.
dbname	sysname (ammette valori Null)	Nome del database contenente la tabella di base che include la colonna. Se la colonna del set di risultati è stata creata in base a un'espressione, dbname è NULL.

Osservazioni:

La stored procedure sp_describe_cursor_columns descrive gli attributi delle colonne di un set di risultati di un cursore del server, quali il nome e il tipo di dati di ogni colonna. Utilizzare sp_describe_cursor per ottenere una descrizione degli attributi globali del cursore del server. Utilizzare sp_describe_cursor_tables per ottenere un report delle tabelle di base a cui fa riferimento il cursore. Per ottenere un report dei cursori transact-SQL server visibili nella connessione, usare sp_cursor_list.

Autorizzazioni

È richiesta l'appartenenza al ruolo public.

Esempi

Nell'esempio seguente viene aperto un cursore globale e viene utilizzata la stored procedure sp_describe_cursor_columns per creare un report delle colonne utilizzate nel cursore.

USE AdventureWorks2022;  
GO  
-- Declare and open a global cursor.  
DECLARE abc CURSOR KEYSET FOR  
SELECT LastName  
FROM Person.Person;  
GO  
OPEN abc;  
  
-- Declare a cursor variable to hold the cursor output variable  
-- from sp_describe_cursor_columns.  
DECLARE @Report CURSOR;  
  
-- Execute sp_describe_cursor_columns into the cursor variable.  
EXEC master.dbo.sp_describe_cursor_columns  
    @cursor_return = @Report OUTPUT  
    ,@cursor_source = N'global'   
    ,@cursor_identity = N'abc';  
  
-- Fetch all the rows from the sp_describe_cursor_columns 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_columns.  
CLOSE @Report;  
DEALLOCATE @Report;  
GO  
-- Close and deallocate the original cursor.  
CLOSE abc;  
DEALLOCATE abc;  
GO

Vedi anche

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