Aracılığıyla paylaş

  • Makale

sp_cursor_list (Transact-SQL)

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

Topic link iconTransact-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.

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