Makale
06/07/2010

sp_cursor_list (Transact-SQL)

Bağlantıda açık imleçler sunucu özniteliklerinin bildirir.

Topic link icon Transact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

[ @cursor_return = ] cursor_variable_nameOUTPUT
Is the name of a declared cursor variable.cursor_variable_name is cursor, with no default.Imleci kaydırılabilir, dinamik ve salt okunur bir imleç olur.
[ @cursor_scope = ] cursor_scope
Specifies the level of cursors to report.cursor_scope is int, with no default, and can be one of these values.

Değer

Açıklama

1

Tüm yerel imleç bildirin.

2

Tüm genel imleçler bildirin.

3

Yerel ve genel imleçler bildirin.

Değer	Açıklama
1	Tüm yerel imleç bildirin.
2	Tüm genel imleçler bildirin.
3	Yerel ve genel imleçler bildirin.

Dönüş Kodu Değerleri

None

Döndürülen imleçler

sp_cursor_list biçiminde raporunu verir...Transact-SQL imleç parametresi, dolayısıyla çıktı değil küme. Bu izin verir. Transact-SQL toplu işlemleri, saklı yordamları ve Tetikleyicileri çıktı bir satır ile aynı anda çalışmak için. Ayrıca, yordamı veritabanı API işlevleri doğrudan çağrılamaz gelir.Imleç çıktı parametresi, bir program değişkenine bağlanmalıdır, ancak veritabanı apı'ları Bağlama imleç parametre veya değişken desteklemez.

Bu biçimi, imleç tarafından döndürülen sp_imleç_list.Biçimi imleç tarafından döndürülen biçimle aynıdır sp_describe_ imleç.

Sütun adı	Veri türü	Açıklama
reference_name	sysname	imleç için başvurmak için kullanılan ad.Imleci için başvuru bir BILDIRMEK CURSOR verilen adı ile ise deyim, başvuru adı imleç adı ile aynıdır.Imleci referansı ile bir değişken varsa, başvuru imleç değişkenin adını addır.
cursor_name	sysname	imleç bir BILDIRMEK imleç ekstresinden adıdır.Içinde SQL Server, imleci bir imleç değişken bir imleç için ayarlama oluşturulduysa cursor_name imleç değişkenin 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 =
Durum	smallint	Aynı değerleri CURSOR_STATUS sistem işlev tarafından bildirilen olarak: 1 Başvuru imleç = imleç tarafından açık veya değişken adıdır.Büyük küçük harf duyarlı, statik imleç veya anahtar kümesi, en az sahip bir satır.Dinamik bir imleç ise sonuç küme sıfır veya daha çok satır bulunur. 0 Başvurulan imleç = imleç adı veya değişken açıktır ancak hiçbir satır vardır.Dinamik imleçler hiçbir zaman bu değeri döndürür. -1 Başvurulan imleç = adı veya değişken imleç tarafından kapatıldı. -2 Yalnızca imleç değişkenleri için aşağıdakilere =.Değişkenine atanan hiçbir imleç yoktur.Büyük bir olasılıkla bir OUTPUT parametresi, bir imleç değişkenine atanan, ancak göndermeden önce imleci saklı yordam kapalı. -3 = Imleç ya da imleci belirtilen ada sahip değişken yok veya imleç değişkeni için ayrılmış olan bir imleç görmemiştir.
modeli	smallint	1 = ınsensitive'i (veya statik) 2 Anahtar kümesi = 3 Dinamik = 4 Hızlı ileri =
eşzamanlılık	smallint	1 Okuma = - yalnızca 2 Kaydırma kilitlerin = 3 Iyimser =
kaydırılabilir	smallint	0 Ileri = - yalnızca 1 Kaydırılabilir =
open_status	smallint	0 Kapalı = 1 Açık =
cursor_rows	int	Sonuçta niteleme sayısını satırları küme.Daha fazla bilgi için bkz: @@ cursor_rows.
fetch_status	smallint	Bu son olan getirme durumunu imleç.Daha fazla bilgi için bkz: @@ fetch_status: 0 Getirme başarılı =. -1 Getirme başarısız oldu = ya da sınırları imleç. -2 Istenen = satır eksik. -9 = Imleç hiçbir getirme oluştu.
column_count	smallint	Imleç sonuç sütunu sayısını ayarlayın.
row_count	smallint	imleç, son operasyondan etkilenen satırların sayısı.Daha fazla bilgi için bkz: @@ rowcount.
last_operation	smallint	Son operasyon imleç gerçekleştirilen: 0 = No imleç işlemler gerçekleşir. 1 AÇIK = 2 GETİRME = 3 EKLEME = 4 GÜNCELLEŞTİRME = 5 SİLME = 6 KAPATMA = 7 = AYIRMASI
cursor_handle	int	imleç sunucu kapsam içinde tanımlayan benzersiz bir değer.

Remarks

sp_cursor_list bağlantı tarafından açılmış olan geçerli sunucu imleçler listesini oluşturur ve her imlecine (scrollability ve imlecin güncelleştirilebilme gibi genel özniteliklerini açıklar.Tarafından listelenen imleçler sp_cursor_list include:

Transact-SQL Sunucu imleçlerdir.
API sunucu imleçler sonra adlı bir ODBC uygulaması tarafından açılmış. SQLSetCursorName imleç adlandırın.

Kullanımı sp_describe_cursor_columns özniteliklerini imleç tarafından döndürülen sonuç kümesinden bir açıklaması.Use sp_describe_cursor_tables for a report of the base tables referenced by the cursor.sp_describe_cursor reports the same information as sp_cursor_list, but only for a specified cursor.

İzinler

Izinleri varsayılan olarak yürütmek Ortak roldür.

Örnekler

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

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

Aracılığıyla paylaş