sp_cursorexecute (języka Transact-SQL)

Tworzy i wypełnia kursor na podstawie planu wykonania, utworzony przez sp_cursorprepare.Ta procedura w połączeniu z sp_cursorprepare, ma taką samą funkcja jak sp_cursoropen, ale jest podzielony na dwie fazy.sp_cursorexecute is invoked by specifying ID =4 in a tabular data stream (TDS) packet.

Ikona łącza do tematu Języka Transact-SQL składni konwencje

Składnia

sp_cursorexecute prepared_handle, cursor 
    [ , scrollopt [ OUTPUT ]
    [ , ccopt [ OUTPUT ]
    [ ,rowcount OUTPUT [ ,bound param] [,...n] ] ] ] ]

Argumenty

prepared_handle
Jest gotowa instrukcja dojście wartość zwracana przez sp_cursorprepare.prepared_handlejest wymagany parametr, który wzywa do int wartości wejściowych.
cursor
Jest identyfikatorem SQL generowany przez serwer kursor .cursor jest wymaganym parametrem dostarczona na wszystkich kolejnych procedur, które oddziaływanie kursor, takich jak sp_cursorfetch
scrollopt
Przewiń listę opcji.scrolloptParametr opcjonalny, który wymaga jest int wartości wejściowych.sp_cursorexecute scrollopt Parametr ma te same opcje wartości, jak sp_cursoropen.

Ostrzeżenie

Wartość PARAMETERIZED_STMT nie jest obsługiwana.

Ważne:

Jeśli scrollopt wartość nie zostanie określona, wartość domyślna to zestaw KLUCZY, niezależnie od scrollopt wartość określona w sp_cursorprepare.
ccopt
Opcja Kontrola waluty.ccoptParametr opcjonalny, który wymaga jest int wartości wejściowych.sp_cursorexecute ccopt Parametr ma te same opcje wartości, jak sp_cursoropen.

Ważne:

Jeśli ccopt wartość nie zostanie określona, wartością domyślną jest OPTIMISTIC, niezależnie od ccopt wartość określona w sp_cursorprepare.

Ważne:
Jeśli scrollopt wartość nie zostanie określona, wartość domyślna to zestaw KLUCZY, niezależnie od scrollopt wartość określona w sp_cursorprepare.

Ważne:
Jeśli ccopt wartość nie zostanie określona, wartością domyślną jest OPTIMISTIC, niezależnie od ccopt wartość określona w sp_cursorprepare.

rowcount
To parametr opcjonalny, który oznacza liczbę wierszy buforu pobierania za pomocą AUTO_FETCH.Wartość domyślna to 20 wierszy.rowcountzachowuje się inaczej, przypisywany jako wartości wejściowej lub zwracanej wartości.

Jako wartości wejściowej	Jako wartość zwracana
Gdy AUTO_FETCH jest określany za pomocą kursorów FAST_FORWARD rowcount reprezentuje liczbę wierszy, aby umieścić w buforze pobierania.	Reprezentuje liczbę wierszy w zestaw wyników.Gdy scrollopt jest określona wartość AUTO_FETCH, rowcount zwraca liczbę wierszy, które pobrano do buforu pobierania.

bound_param
Oznacza fakultatywne dodatkowe parametry.

Ostrzeżenie

Wszystkie parametry po piątym są przekazywane razem plan instrukcja jako parametry wejściowe.

Zwracana wartość kodu

rowcountmoże zwracać następujące wartości.

Wartość	Opis
-1	Liczba wierszy jest nieznana.
-n	Asynchroniczne zapełnianie są włączone.

Uwagi

Parametry scrollopt i ccopt

scrollopti ccopt są przydatne, gdy plany buforowane są zastępowane dla pamięci podręcznej serwera, co oznacza, że trzeba ponownie skompilowana przygotowanej uchwyt identyfikujący instrukcja .scrollopt i ccopt wartości parametrów musi odpowiadać wartości wysyłane oryginalne żądanie do sp_cursorprepare.

Ostrzeżenie

PARAMETERIZED_STMT nie powinny być przypisane do scrollopt.

Brak pasujących wartości spowoduje ponowną kompilację planów Negacja przygotowanie i wykonać operacji.