sp_cursorprepare (Transact-SQL)
imleçdeyim veya toplu iş yürütme planına derler, ancak imleçoluşturmaz. deyim derlenmiş daha sonra tarafından kullanılan sp_cursorexecute.Bu yordam, bağlanmış olan sp_cursorexecute, aynı işlev olan sp_cursoropen, ancak iki aşama. bölüneceğinisp_cursorprepare is invoked by specifying ID = 3 in a tabular data stream (TDS) packet.
Sözdizimi
sp_cursorprepare prepared_handle OUTPUT, params , stmt , options
[ , scrollopt [ , ccopt ] ]
Bağımsız değişkenler
prepared_handle
Hazırlanmış bir SQL Server tarafından oluşturulan ele bir tamsayı değer döndürür tanımlayıcısı.Not
prepared_handlesonradan için sağlanan bir sp_cursorexecute bir imleçaçmak için yordam.Bir tanıtıcı oluşturulduktan sonra oturumu kapatıncaya kadar veya açıkça aracılığıyla kaldırılıncaya dek varsa bir sp_cursorunprepare yordam.
params
Parametreli deyimleri tanımlar.params deyimparametre imleyicileri için değişkenleri tanımını değiştirdi.paramsçağıran için gerekli bir parametre bir ntext, nchar, veya nvarchar Giriş değeri.deyim değil parametrelenmiştir, boş bir değer girin.Not
Kullanımı bir ntextGirişdize değeri stmt parametrelenmiştir ve scrollopt PARAMETERIZED_STMT değerdir on.
stmt
imleçsonuç kümesitanımlar. stmt Parametresi gereklidir ve için çağıran bir ntext, nchar veya nvarchar Giriş değeri.Not
Kuralları belirtme stmt değeri aynı olan sp_cursoropen, istisna ile stmt dize veri türü olmalıdır ntext.
options
sonuç kümesi sütunlar imleçaçıklamasını döndürür isteğe bağlı bir parametre. optionsaşağıdakileri gerektirir int Giriş değeri.Değer
Açıklama
0x0001
RETURN_METADATA
scrollopt
Kaydırma seçeneği.scrolloptaşağıdakilerden birini gerektirir isteğe bağlı bir parametredir int giriş değerleri.Değer
Açıklama
0x0001
ANAHTAR KÜMESİ
0X0002
DİNAMİK
0X0004
FORWARD_ONLY
0X0008
STATİK
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
İstenen değer tarafından tanımlanan imleç için uygun olabileceğinden stmt, bu parametre gören olarak, hem girdi hem de çıktı.Bu gibi durumlarda SQL Server atar uygun bir değer.
ccopt
Eşzamanlılık denetim seçeneği.ccoptaşağıdakilerden birini gerektirir isteğe bağlı bir parametredir int giriş değerleri.Değer
Açıklama
0x0001
READ_ONLY
0X0002
scroll_locks (daha önce lockcc da bilinir)
0X0004
İYİMSER (daha önce optcc da bilinir)
0X0008
İYİMSER (daha önce optccval da bilinir)
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
Olduğu gibi scrollpt, SQL Server Talep iletiden farklı bir değer atayabilirsiniz.
Açıklamalar
rpc durum parametresi aşağıdakilerden biridir:
Değer |
Açıklama |
---|---|
0 |
Başarı |
0x0001 |
Hatası |
1FF6 |
meta verilerdöndüremedi.
Not
Bunun nedeni, bir sonuç kümesi deyim üretmez olur; Örneğin, bir INSERT veya DDL deyimolur.
|
Örnekler
Zaman stmt parametrelenmiştir ve scrollopt PARAMETERIZED_STMT değeri on, dize biçimi aşağıdaki gibidir:
{ <yerel değişken adı><veri türü> } [, …n
Ayrıca bkz.