sp_cursoropen (Transact-SQL)

van toepassing op:SQL Server-

Hiermee opent u een cursor. sp_cursoropen definieert de SQL-instructie die is gekoppeld aan de cursor- en cursoropties en vult de cursor vervolgens in. sp_cursoropen is gelijk aan de combinatie van de Transact-SQL-instructies DECLARE_CURSOR en OPEN. Deze procedure wordt aangeroepen door ID = 2 op te geven in een TDS-pakket (tabellaire gegevensstroom).

Transact-SQL syntaxisconventies

Syntaxis

sp_cursoropen cursor OUTPUT
    , stmt
    [ , scrollopt [ OUTPUT ]
    [ , ccopt [ OUTPUT ]
    [ , rowcount OUTPUT [ , boundparam ] [ , ...n ] ] ] ]
[ ; ]

Argumenten

cursor

Een door SQL Server gegenereerde cursor-id. cursor is een handle waarde die moet worden opgegeven voor alle volgende procedures met de cursor, zoals sp_cursorfetch. De cursor parameter is int en kan niet worden NULL.

cursor kunnen meerdere cursors actief zijn op één databaseverbinding.

stmt-

Een vereiste parameter waarmee de resultatenset van de cursor wordt gedefinieerd. Elke geldige querytekenreeks (syntaxis en binding) van elk tekenreekstype (ongeacht Unicode, grootte, enzovoort) kan fungeren als een geldig stmt waardetype.

Schuifoptie. De parameter scrollopt is int, met een standaardwaarde van NULLen kan een van de volgende waarden zijn.

Vanwege de mogelijkheid dat de aangevraagde waarde niet geschikt is voor de cursor die is gedefinieerd door stmt-, dient deze parameter als invoer en uitvoer. In dergelijke gevallen wijst SQL Server een geschikte waarde toe.

Optie voor gelijktijdigheidsbeheer. is een optionele parameter waarvoor een van de volgende invoerwaarden is vereist.

Net als bij scrollopt, kan SQL Server de aangevraagde waarden overschrijven.

aantal rijen

Het aantal ophaalbufferrijen dat moet worden gebruikt met AUTO_FETCH. De standaardwaarde is 20 rijen. rowcount zich anders gedraagt wanneer deze is toegewezen als invoerwaarde versus een retourwaarde.

afhankelijke

Hiermee wordt het gebruik van extra parameters opgegeven. boundparam is een optionele parameter die moet worden opgegeven als de PARAMETERIZED_STMT waarde is ingesteld op ON.

Codewaarden retourneren

Als er geen fout optreedt, retourneert sp_cursoropen een van de volgende waarden.

Wanneer er een fout optreedt, kunnen de retourwaarden inconsistent zijn en kan de nauwkeurigheid niet worden gegarandeerd.

Wanneer de rowcount parameter is opgegeven als een retourwaarde, vindt de volgende resultatenset plaats.

Als RPC wordt gebruikt, zijn de retourwaarden als volgt.

Als de sp_cursoropen-procedure is uitgevoerd, worden de RPC-retourparameters en een resultatenset met informatie over de TDS-kolomindeling (0xa0 en 0xa1 berichten) verzonden. Als dit niet lukt, worden een of meer TDS-foutberichten verzonden. In beide gevallen worden er geen rijgegevens geretourneerd en wordt het aantal DONE berichten 0. 0x81 wordt geretourneerd (standaard voor SELECT instructies) samen met de 0xa5- en 0xa4 tokenstreams.

Opmerkingen

De parameter stmt

Als stmt- de uitvoering van een opgeslagen procedure opgeeft, kunnen de invoerparameters worden gedefinieerd als constanten als onderdeel van de stmt tekenreeks, of opgegeven als afhankelijkeparam argumenten. Gedeclareerde variabelen kunnen op deze manier worden doorgegeven als afhankelijke parameters.

De toegestane inhoud van de parameter stmt is afhankelijk van het feit of de ALLOW_DIRECT retourwaarde door OR is gekoppeld aan de rest van de waarden:

• Als ALLOW_DIRECT niet is opgegeven, moet een Transact-SQL SELECT- of EXECUTE-instructie voor een opgeslagen procedure met één SELECT instructie worden gebruikt. Bovendien moet de SELECT-instructie als cursor kwalificeren; dat wil gezegd, het kan de trefwoorden SELECT INTO of FOR BROWSEniet bevatten.

• Als ALLOW_DIRECT is opgegeven, kan dit leiden tot een of meer Transact-SQL instructies, inclusief instructies die andere opgeslagen procedures uitvoeren met meerdere instructies. Niet-SELECT instructies of een SELECT-instructie die de trefwoorden SELECT INTO of FOR BROWSE bevat, worden uitgevoerd en leiden niet tot het maken van een cursor. Hetzelfde geldt voor elke SELECT instructie die is opgenomen in een batch met meerdere instructies. In gevallen waarin een SELECT instructie componenten bevat die alleen betrekking hebben op cursors, worden deze componenten genegeerd. Wanneer de waarde van bijvoorbeeld 0x2002is, is dit een aanvraag voor:

  • Een cursor met schuifvergrendelingen, als er slechts één SELECT instructie is die als cursor in aanmerking komt, of

  • Een directe instructieuitvoering als er meerdere instructies zijn, één niet-SELECT instructie of een SELECT-instructie die niet als cursor in aanmerking komt.

De parameter scrollopt

De eerste vijf scrollopt waarden (KEYSEY, DYNAMIC, FORWARD_ONLY, STATICen FAST_FORWARD) sluiten elkaar wederzijds uit.

PARAMETERIZED_STMT en CHECK_ACCEPTED_TYPES kunnen worden gekoppeld door OR aan een van de eerste vijf waarden.

AUTO_FETCH en AUTO_CLOSE kunnen door OR aan FAST_FORWARDworden gekoppeld.

Als CHECK_ACCEPTED_TYPESONis, moeten ten minste één van de laatste vijf waarden (KEYSET_ACCEPTABLE, DYNAMIC_ACCEPTABLE, FORWARD_ONLY_ACCEPTABLE, STATIC_ACCEPTABLEof FAST_FORWARD_ACCEPTABLE) ook ONzijn.

STATIC cursors worden altijd geopend als READ_ONLY. Dit betekent dat de onderliggende tabel niet kan worden bijgewerkt via deze cursor.

De parameter

De eerste vier waarden (READ_ONLY, SCROLL_LOCKSen beide OPTIMISTIC waarden) sluiten elkaar wederzijds uit.

ALLOW_DIRECT en CHECK_ACCEPTED_TYPES kunnen worden gekoppeld door OR aan een van de eerste vier waarden.

UPDT_IN_PLACE kunnen door OR worden gekoppeld aan READ_ONLY, SCROLL_LOCKSof een van de OPTIMISTIC-waarden.

Als CHECK_ACCEPTED_TYPES is ON, moet ten minste één van de laatste vier waarden (READ_ONLY_ACCEPTABLE, SCROLL_LOCKS_ACCEPTABLEen een van de OPTIMISTIC_ACCEPTABLE waarden) ook AAN zijn.

Positioned UPDATE- en DELETE-functies kunnen alleen binnen de ophaalbuffer worden uitgevoerd en alleen als de waarde gelijk is aan SCROLL_LOCKS of OPTIMISTIC. Als SCROLL_LOCKS de opgegeven waarde is, slaagt de bewerking gegarandeerd. Als OPTIMISTIC de opgegeven waarde is, mislukt de bewerking als de rij is gewijzigd sinds deze voor het laatst is opgehaald.

De reden voor deze fout is dat wanneer OPTIMISTIC de opgegeven waarde is, een optimistische valutacontrolefunctie wordt uitgevoerd door tijdstempels of controlesomwaarden te vergelijken, zoals bepaald door SQL Server. Als een van deze rijen niet overeenkomt, mislukt de bewerking.

Het opgeven van UPDT_IN_PLACE als de retourwaarde bepaalt de volgende resultaten:

• Als deze niet is ingesteld bij het uitvoeren van een geplaatste update voor een tabel met een unieke index, verwijdert de cursor de rij uit de werktabel en voegt deze in aan het einde van een van de sleutelkolommen die door de cursor worden gebruikt, waardoor deze kolommen worden gewijzigd.

• Als ONis ingesteld, werkt de cursor de sleutelkolommen in de oorspronkelijke rij van de werktabel bij.

De parameter bound_param

De parameternaam moet worden paramdef- wanneer PARAMETERIZED_STMT is opgegeven, volgens het foutbericht in de code. Wanneer PARAMETERIZED_STMT niet is opgegeven, wordt er geen naam opgegeven in het foutbericht.

RPC-overwegingen

De RPC-RETURN_METADATA invoervlag kan worden ingesteld op 0x0001 om aan te vragen dat metagegevens van de cursorlijst selecteren wordt geretourneerd in de TDS-stroom.

Voorbeelden

Een. De parameter bound_param

Parameters na de vijfde worden als invoerparameters doorgegeven aan het instructieplan. De eerste parameter moet een tekenreeks in de volgende vorm zijn:

<parameter_name> <data_type> [ ,... n ]

Volgende parameters worden gebruikt om de waarden door te geven die moeten worden vervangen door de <parameter_name> in de instructie.

Verwante inhoud

• sp_cursorfetch (Transact-SQL)
• systeem opgeslagen procedures (Transact-SQL)