sp_cursor_list (Transact-SQL)

Sunucu imleçler için bağlantı açık özniteliklerini bildirir.

Transact-SQL sözdizimi kuralları

Sözdizimi

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

Bağımsız değişkenler

• [ @cursor_return= ] cursor_variable_nameOUTPUT
  Bir imleç bildirilen değişken adıdır.cursor_variable_nameİş cursor, ile hiçbir varsayılan.imleç kaydırılabilir, dinamik, salt okunur bir imleçolur.

• [ @cursor_scope= ] cursor_scope
  İmleçler rapor düzey belirtir.cursor_scopeolan int, hiçbir varsayılan ve can ile biri, bu değerler.

  Değer	Açıklama
  1	Tüm yerel imleçler rapor.
  2	Tüm genel imleçler rapor.
  3	Hem yerel hem de genel imleçler rapor.

Dönüş Kodu Değerleri

Hiçbiri

Döndürülen İmleçler

sp_cursor_listalt rapor olarak verir bir Transact-SQL imleç çıkış parametresi, bir sonuç kümesiolarak değil.Böylece, Transact-SQL toplu işlemleri, saklı yordamları ve Tetikleyicileri çıkış bir satır ile her saatçalışmak için.Ayrıca, doğrudan veritabanı API işlevlerini yordamı çağrılamaz anlamına gelir.imleç çıkış parametresi program değişkene bağlı olmalıdır, ancak veritabanı API bağlamaimleç Parametreler veya değişkenleri desteklemez.

Tarafından döndürülen imleç biçimi budur sp_cursor_list.imleç biçimi tarafından döndürülen biçimle aynıdır sp_describe_cursor.

Sütun adı	Veri türü	Açıklama
reference_name	sysname	imleçbaşvurmak için kullanılan ad.imleç referansı üzerinden bir BİLDİRMEK İMLEÇ deyimverilen ad ise, başvuru adı imleç adı ile aynıdır.imleç referansı ile bir değişken ise, başvuru adı imleç değişken adıdır.
cursor_name	sysname	BİLDİRMEK İMLEÇ deyim imleç adı.De SQL Server, imleç bir imleç değişken bir imleç, ayarlama tarafından oluşturulmuş cursor_name imleç değişken adını döndürür.Önceki sürümlerde bu çıktı sütun , sistem tarafından oluşturulan bir ad verir.
cursor_scope	smallint	1 = YEREL 2 = GENEL
status	smallint	Aynı değerleri cursor_status sistem işlevtarafından bildirilen olarak: 1 = Başvurulan imleç adı veya değişken ' % s'imleç imleç tarafından açıktır.Duyarlı, statik imleç veya anahtar kümesi, sahip en az bir satır.Dinamik imleç ise sonuç kümesi sıfır veya daha fazla satır var. 0 = Başvurulan imleç imleç adı veya değişken açıktır ancak hiçbir satır yok.Dinamik imleçler hiçbir zaman bu değeri döndürür. -1 = Başvurulan imleç adı veya değişken ' % s'imleç imleç tarafından kapatılır. -2 Aşağıdakilere yalnızca imleç değişkenleri =.Hiçbir imleç değişkenine atanan vardır.Büyük bir olasılıkla bir çıkış parametresi olan bir imleç değişkenine atanan, ancak saklı yordam dönmeden önce imleç kapalı. -3 = imleç veya imleç belirtilen ada sahip değişken yok veya imleç değişken bir imleç , kendisine ayrılan görmemiştir.
model	smallint	1 = Küçük harf duyarlı (veya statik) 2 = Anahtar kümesi 3 = Dinamik 4 = Hızlı İleri Sar
concurrency	smallint	1 = Salt okunur 2 = Kaydırma kilitleri 3 = İyimser
scrollable	smallint	0 = Salt ileri 1 = Kaydırılabilir
open_status	smallint	0 = Kapalı 1 = Açık
cursor_rows	int	sonuç kümesiniteleme sayısını satırlar.Daha fazla bilgi için bkz: @@ cursor_rows.
fetch_status	smallint	Bu imleçüzerinde son getirme durumu.Daha fazla bilgi için bkz: @@ fetch_status: 0 = Getirme başarılı. -1 = Getirme başarısız oldu veya imleçsınırları. -2 = İstenen satır eksik. "9" Simgesi = imleçhiçbir getirme olmuştur.
column_count	smallint	imleçsonuç kümesisütun sayısı.
row_count	smallint	imleçson operasyonda tarafından etkilenen satırların sayısı.Daha fazla bilgi için bkz: @@ rowcount.
last_operation	smallint	Son işlem imleçgerçekleştirilen: 0 = No gerçekleştirilen işlemler imleç. 1 = AÇIK 2 = GETİRME 3 = EKLE 4 = GÜNCELLEŞTİRME 5 = DELETE 6 = KAPAT 7 = AYIRMASI
cursor_handle	int	Sunucu kapsam içinde imleç tanımlayan benzersiz bir değer.

Açıklamalar

sp_cursor_listbağlantı tarafından açılmış geçerli sunucu imleçler listesini oluşturur ve her imleç, scrollability ve Güncelleştirilebilirlik imleçgibi genel özniteliklerini açıklar.Tarafından listelenen imleçler sp_cursor_list ekleyin:

• Transact-SQLSunucu imleçler.

• API server imleçler sonra adlı bir odbc uygulaması tarafından açılan SQLSetCursorName imleçadı vermek.

Use sp_describe_cursor_columns bir imleçtarafından döndürülen sonuç kümesi özniteliklerini açıklaması.Use sp_describe_cursor_tables ' % s'imleç imleçtarafından başvurulan temel tablolar, rapor.sp_describe_cursoraynı bilgileri raporları sp_cursor_list, ancak yalnızca belirtilen imleç.

İzinler

Yürütme izinleri varsayılan public rolü.

Örnekler

Aşağıdaki örnek genel imleç açar ve kullanan sp_cursor_list imleçözniteliklerini raporlamak için.

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

Ayrıca bkz.

Başvuru

Sistem saklı yordamları (Transact-SQL)