Udostępnij przez

sp_cursor_list (Transact-SQL)

Uprawnienie trasa usługa Broker

Topic link iconKonwencje składni języka Transact-SQL

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

Argumenty

  • [ @cursor_return = ] cursor_variable_nameOUTPUT
    Is the name of a declared cursor variable.cursor_variable_name is cursor, with no default.usługa Broker usług

  • [ @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.

    Wartość

    Description

    1

    Uprawnienie Usługa Service Broker

    2

    Implikowane przez uprawnienia usługa usługa Broker

    3

    Zgłasza zarówno kursory lokalne, jak i globalne.

Wartości kodów powrotnych

None

Kursory, zwrot

sp_cursor_list zwraca raportuTransact-SQL Parametr wyjściowy kursor, dzięki temu nie ustawione. Dzięki temu Transact-SQL instancje, procedur przechowywanych i wyzwalaczy do pracy z jednego wiersza danych wyjściowych na raz. Przez dodanie nowej metoda istniejący punkt końcowy.Modyfikując lub upuszczanie istniejącą metoda z punktem końcowym.

Jest to format zwracanych przez kursor sp_cursor_list.Format kursor jest taka sama, jak format zwrócone przez sp_describe_cursor.

Nazwa kolumna

Typ danych

Description

reference_name

sysname

Nazwa używana przy odwoływaniu się do kursora.Jeśli do kursora odwołano się przy użyciu nazwy podanej w instrukcji DECLARE CURSOR, nazwa odwołania jest taka sama jak nazwa kursora.Jeśli do kursora odwołano się przy użyciu zmiennej, nazwa odwołania jest nazwą zmiennej kursora.

DODAJE WEBMETHOD

sysname

Nazwa kursora z instrukcji DECLARE CURSOR.W programie SQL Server, jeśli kursor utworzono przez ustawienie zmiennej kursora, kolumna cursor_name zwraca nazwę zmiennej kursora.W starszych wersjach ta kolumna wyjściowa zwraca nazwę wygenerowaną przez system.

Aby temu zapobiec, należy rozważyć dodanie adres URL nazwa domena zarejestrowane jako części ścieżka obszaru nazw.

smallint

1 = LOKALNY

2 = GLOBALNE

Stan

smallint

ZMIENIA WEBMETHOD

1 = Kursora, do którego odwołuje się przez kursor nazwy lub zmienna jest otwarty.Jeśli kursor znajduje się niewrażliwe, statyczny lub zestawu kluczy, ma ona co najmniej jeden wiersz.Jeśli kursor znajduje się dynamiczne, zestaw wyników zawiera zero lub więcej wierszy.

0 = Kursora, do którego odwołuje się przez kursor nazwy lub zmienna jest otwarty, ale nie wiersze.Dynamiczne kursory nigdy nie zwraca tę wartość.

Wartość -1 = kursora, do którego odwołuje się przez kursor nazwy lub zmienna jest zamknięty.

2 = Dotyczy tylko do zmiennych kursor.Nie ma żadnych kursor przypisana do zmiennej.Ewentualnie parametru WYJŚCIOWEGO przypisana do zmiennej kursora, ale procedura przechowywana zamknięte kursor przed zwróceniem.

3 = Kursora lub kursor zmienna o określonej nazwie nie istnieje lub zmiennej kursora nie miał kursora, przydzielone do niego.

Model

smallint

1 = Insensitive (lub statyczne)

2 = Zestaw kluczy

Zmienia definicję istniejący punkt końcowy metoda.

4 = Szybko do przodu

współbieżność

smallint

1 = Odczyt — tylko

2 = Blokad przewijania

CO {TCP | HTTP}

Nie można zmienić protokół transportu z punktem KOŃCOWYM ALTER.

smallint

0 = Do przodu — tylko

1 = Przewijany

Opcja autoryzacja nie jest dostępna w instrukcji ALTER punktu KOŃCOWEGO.

smallint

0 = Zamknięte

1 = Otwarte

Po utworzeniu punktu końcowego, mogą być tylko przypisywane prawa własności.

int

UPUŚĆ WEBMETHODAby uzyskać więcej informacji zobacz @@ CURSOR_ROWS.

DLA {SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING}

smallint

Nie można zmienić typ ładunku z punktem KOŃCOWYM ALTER.Aby uzyskać więcej informacji zobacz @@ FETCH_STATUS:

0 = Pobieranie powiodło się.

Wartość -1 = nie powiodło się pobranie lub wykracza poza granice kursor.

2 = Żądane brakuje wierszy.

-9 = Nie było żadnych pobrania na kursor.

Wszystkie właściwości istniejący punkt końcowy pozostają takie same, o ile nie zostanie jawnie zmieniona je.

smallint

Liczba kolumn w zestawie wyników kursora.

row_count

smallint

RC4 jest stosunkowo słaba algorytmu i AES jest stosunkowo mocnego algorytmu.Aby uzyskać więcej informacji zobacz @@ ROWCOUNT.

Jeśli zabezpieczeń wyższy priorytet, niż szybkość, zaleca się używania AES.

smallint

Użytkownik musi należeć do roli sysadmin stałych serwer właściciela punktu końcowego lub uprawnieniem ALTER bez punktu KOŃCOWEGO.

0 = Nie zostały wykonane operacje na kursor.

1 = OTWARTE

2 = POBRANIA

3 = WSTAWIANIA

4 = AKTUALIZACJI

5 = USUŃ

6 = ZAMKNIĘCIA

7 = COFNĄĆ PRZYDZIAŁ

Aby zmienić własność istniejący punkt końcowy, należy użyć instrukcja ALTER autoryzacja.

int

Dodawanie nowej metoda do istniejący punkt końcowy

Remarks

Funkcja sp_cursor_list generuje listę bieżących kursorów serwera otwartych przez połączenie i opisuje atrybuty globalne dla każdego kursora, takie jak możliwość przewijania i aktualizowania kursora.Do kursorów wyświetlanych przez funkcję sp_cursor_list należą:

  • Kursory serwera Transact-SQL.

  • Interfejs API serwera kursory otwarty przez aplikację ODBC, który jest następnie wywoływana SQLSetCursorName nazwa kursor.

Użycie sp_describe_cursor_columns opis atrybutów zestaw wyników zwróconych przez kursor.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.

Uprawnienia

wykonać uprawnienia domyślne do publiczne roli.

Przykłady

Poniższy przykład otwiera globalne kursor i używa sp_cursor_list Aby zgłosić atrybuty kursor.

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
  • Last updated on