sp_describe_cursor_columns (Transact-SQL)

Argumenty

• [ @cursor_return = ] output_cursor_variableOUTPUT
  Is the name of a declared cursor variable to receive the cursor output.output_cursor_variable is cursor, with no default, and must not be associated with any cursors at the time sp_describe_cursor_columns is called.Kursor, zwracana jest kursor przewijaną, dynamiczne, tylko do odczytu.

• [ @ cursor_source = { N'local "| N'global " | N'variable " }
  Określa, czy kursor jest podana w deklaracji jest określona przy użyciu nazwy kursor lokalny, globalny kursora lub zmiennej kursora.Parametr jest nvarchar(30).

• [ @cursor_identity = ] N'local_cursor_name'
  Is the name of a cursor created by a DECLARE CURSOR statement that either has the LOCAL keyword or that defaulted to LOCAL.local_cursor_name is nvarchar(128).

• [ @cursor_identity = ] N'global_cursor_name'
  Is the name of a cursor created by a DECLARE CURSOR statement that either has the GLOBAL keyword or that defaulted to GLOBAL.global_cursor_name is nvarchar(128).

  global_cursor_nameZwraca true Jeśli wystąpienie jest dobrze sformułowany, na podstawie jego typu OGC (Otwieranie lokalizacji geograficznych Consortium).

• [ @cursor_identity = ] N'input_cursor_variable'
  Is the name of a cursor variable associated with an open cursor.input_cursor_variable is nvarchar(128).

Wartości kodów powrotnych

None

Kursory, zwrot

sp_describe_cursor_columns encapsulates its report as a Transact-SQLcursor output parameter.Dzięki temu Transact-SQL instancje, procedur przechowywanych i wyzwalaczy do pracy z jednego wiersza danych wyjściowych na raz. Oznacza to również, że nie można wywołać procedury bezpośrednio z funkcjami interfejsu API bazy danych.The kursor output parameter must be bound to a program variable, but the database APIs do not support wiązanie kursor parameters or variables.

W poniższej tabela przedstawiono format zwracane przy użyciu kursor sp_describe_cursor_columns.

Remarks

sp_describe_cursor_columns opisuje atrybuty kolumn zestaw wyników kursor serwera, takie jak typ danych i nazwę każdego kursora. Użycie ZMIANA INDEKSU zamiast niego.Użycie sp_describe_cursor_tables raportu tabel bazowych, do którego odnosi się kursor.Aby otrzymać raport o Transact-SQL Użyj kursorów serwera widoczne w danym połączeniu sp_cursor_list.

Uprawnienia

Członkostwo w grupie wymaga publiczne roli.

Przykłady

Poniższy przykład otwiera globalne kursor i używa sp_describe_cursor_columns na kolumny, używanych w kursor.

USE AdventureWorks;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Contact;
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

See Also

Reference

Other Resources