sp_describe_cursor (Transact-SQL)

Bağımsız değişkenler

• [ @cursor_return = ] output_cursor_variable OUTPUT
  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 is called.Döndürülen imleç kaydırılabilir, dinamik ve salt okunur bir imleç olur.

• [ cursor_source = { N'local '| N'global ' | N'variable ' }
  Imleci, bildirilen bir yerel imleç, genel bir imleç veya imleç değişken adını kullanarak belirtilen olup olmadığını belirtir.Parametre 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_name Ayrıca, bir ODBC uygulaması tarafından açıldığında API sunucu imleci adı olabilir, sonra da çaðýrarak adlı SQLSetCursorName.

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

Dönüş Kodu Değerleri

None

Döndürülen imleçler

sp_describe_cursor encapsulates its result set in a Transact-SQLcursor output parameter.Bu olanak verir. Transact-SQL toplu işlemleri, saklı yordamları ve Tetikleyicileri çıktı bir satır ile aynı anda çalışmak için. Bu, ayrıca yordamı veritabanı API işlevleri doğrudan çağrılamaz anlamına gelir.The imleç output parameter must be bound to a program variable, but the database APIs do not support bağlama imleç parameters or variables.

Aşağıdaki tablo biçimini gösterir imleç kullanılarak döndürülür sp_describe_ imleç.Imlecin biçimi kullanarak döndürdü biçimi ile aynıdır sp_cursor_list.

Remarks

sp_describe_cursor gidin ve güncelleştirme yeteneği gibi bir sunucu imlecine genel özniteliklerini açıklar.Kullanımı sp_describe_cursor_columns özniteliklerini imleç tarafından döndürülen sonuç kümesinden bir açıklaması.Kullanımı sp_describe_cursor_tables imleç tarafından başvurulan temel tablolar hakkında bir rapor için.Transact-SQL Sunucu imleçler görünür bağlantıda bir rapor elde etmek için kullanın. sp_cursor_list.

A DECLARE CURSOR statement may request a cursor type that SQL Server cannot support using the SELECT statement that is contained in the DECLARE CURSOR.SQL Server implicitly converts the cursor to a type it can support using the SELECT statement.If TYPE_WARNING is specified in the DECLARE CURSOR statement, SQL Server sends the application an informational message that a conversion has been completed.sp_describe_cursor can then be called to determine the type of cursor that has been implemented.

İzinler

Üyelik gerektirir Ortak roldür.

Örnekler

Aşağıdaki örnek, bir genel imleç açar ve kullanır sp_describe_cursor imleç öznitelikleri bildirmek için .

USE AdventureWorks;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR STATIC FOR
SELECT LastName
FROM Person.Contact

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

See Also

Reference

Other Resources