sp_cursorprepexec (języka Transact-SQL)

Kompiluje plan dla partialub przesłane kursorinstrukcja , a następnie tworzy i wypełnia kursor. sp_cursorprepexecłączy funkcje sp_cursorprepare i sp_cursorexecute.Tej procedury jest wywoływany przez określenie Identyfikatora = 5 w strumień danych tabelarycznych (TDS) pakiet.

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

Składnia

sp_cursorprepexec prepared handle OUTPUT, cursor OUTPUT, params , statement , options
    [ , scrollopt [ , ccopt [ , rowcount ] ] ]

Argumenty

prepared handle
Jest SQL Server generowanych przygotowanego obsługi identyfikatora.prepared handlejest wymagana i zwraca int.
cursor
Jest SQL Server wygenerowany identyfikator kursor .cursorjest wymaganym parametrem dostarczona na wszystkich kolejnych procedur, które np oddziaływanie tego kursorsp_cursorfetch.
params
Identyfikuje sparametryzowana sprawozdania.params Definicji zmiennych jest podstawiane znaczników parametru w instrukcja.paramsjest wymagany parametr, który wzywa do ntext, nchar, lub nvarchar wartości wejściowych.

Ostrzeżenie

Użycie ntext ciąg wejściowy wartość, gdy stmt jest sparametryzowana i scrollopt wartość PARAMETERIZED_STMT jest dalej.
statement
Definiuje kursor zestaw wyników.statement Parametr jest wymagany i wzywa do ntext, nchar lub nvarchar wartości wejściowych.

Ostrzeżenie

Reguły określania wartości stmt są takie same jak dla sp_cursoropen, z wyjątkiem, stmtTyp danychciąg musi być ntext.
options
Parametr opcjonalny, który zwraca opis kursor zestaw wyników kolumny.optionswymaga następujących int wartości wejściowych.

Wartość

Opis

0X0001

RETURN_METADATA

Wartość	Opis
0X0001	RETURN_METADATA

scrollopt
Opcja przewijania.scrolloptto parametr opcjonalny, który wymaga jednego z następujących int wartości wejściowych.

Wartość	Opis
0X0001	ZESTAW KLUCZY
0X0002	DYNAMICZNE
0X0004	FORWARD_ONLY
0X0008	STATYCZNE
0x10	FAST_FORWARD
0x1000	PARAMETERIZED_STMT
0x2000	AUTO_FETCH
0x4000	AUTO_CLOSE
0x8000	CHECK_ACCEPTED_TYPES
0x10000	KEYSET_ACCEPTABLE
0x20000	DYNAMIC_ACCEPTABLE
0x40000	FORWARD_ONLY_ACCEPTABLE
0x80000	STATIC_ACCEPTABLE
0x100000	FAST_FORWARD_ACCEPTABLE

Ze względu na możliwość, że żądana opcja nie jest odpowiedni dla kursor zdefiniowane przez <stmt>, ten parametr służy jako danych wejściowych i wyjściowych.W takich przypadkach SQL Server przypisuje odpowiedni typ i modyfikuje wartość.

ccopt
Opcja sterowania współbieżności.ccoptto parametr opcjonalny, który wymaga jednego z następujących int wartości wejściowych.

Wartość	Opis
0X0001	TYLKO_DO_ODCZYTU
0X0002	SCROLL_LOCKS (wcześniej znany jako LOCKCC)
0X0004	OPTYMISTYCZNA (wcześniej znany jako OPTCC)
0X0008	OPTIMISTIC (wcześniej znany jako OPTCCVAL)
0x2000	ALLOW_DIRECT
0x4000	UPDT_IN_PLACE
0x8000	CHECK_ACCEPTED_OPTS
0x10000	READ_ONLY_ACCEPTABLE
0x20000	SCROLL_LOCKS_ACCEPTABLE
0x40000	OPTIMISTIC_ACCEPTABLE
0x80000	OPTIMISITC_ACCEPTABLE

Tak jak w przypadku scrollpt, SQL Server można przypisać inną wartość niż żądana.

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.