Inzicht in cursortypen

JDBC-stuurprogramma downloaden

Bewerkingen in een relationele database werken op een volledige set rijen. De set rijen die door een SELECT-instructie worden geretourneerd, bestaat uit alle rijen die voldoen aan de voorwaarden in de WHERE-component van de instructie. Deze volledige set rijen die door de query worden geretourneerd, wordt de resultatenset genoemd. Toepassingen kunnen niet altijd effectief werken met de volledige resultatenset als een eenheid. Deze toepassingen hebben een manier nodig om met één rij of een klein blok rijen tegelijk te werken. Cursors zijn een uitbreiding op resultatensets die dat mechanisme bieden.

Cursors breiden de verwerking van resultatensets uit door de volgende items uit te voeren:

  • Plaatsing op specifieke rijen van de resultatenset toestaan.
  • Eén rij of een blok rijen ophalen vanaf de huidige positie in de resultatenset.
  • Ondersteuning van gegevenswijzigingen in de rij op de huidige locatie in de resultatenset.
  • Ondersteuning voor verschillende zichtbaarheidsniveaus voor wijzigingen in de databasegegevens door andere gebruikers die worden weergegeven in de resultatenset.

Opmerking

Zie Type cursors voor een volledige beschrijving van de SQL Server-cursortypen.

De JDBC-specificatie biedt ondersteuning voor alleen-doorstuur- en schuifbare cursors die gevoelig of ongevoelig zijn voor wijzigingen die door andere taken zijn aangebracht en die alleen-lezen of bijwerkbaar zijn. Deze functionaliteit wordt geleverd door het Microsoft JDBC-stuurprogramma voor SQLServer SQLServerResultSet-klasse .

Opmerkingen

Het JDBC-stuurprogramma ondersteunt de volgende resultatenset en cursortypen, samen met de opgegeven gedragsopties.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) N/A Alleen-doorsturen, alleen-lezen rechtstreeks full

De toepassing moet één enkele keer (vooruit) door de resultaatset doorlopen. Deze pass is het standaardgedrag en gedraagt zich hetzelfde als een TYPE_SS_DIRECT_FORWARD_ONLY cursor. Het stuurprogramma leest de volledige resultatenset van de server in een geheugen tijdens de uitvoeringstijd van de instructie.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) N/A Alleen-doorsturen, alleen-lezen rechtstreeks aanpasbaar

De toepassing moet één enkele keer (vooruit) door de resultaatset doorlopen. Het gedraagt zich hetzelfde als een TYPE_SS_DIRECT_FORWARD_ONLY cursor. Het stuurprogramma leest rijen van de server terwijl de toepassing deze aanvraagt en minimaliseert het geheugengebruik aan de clientzijde.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) Snel vooruit Alleen-doorsturen, alleen-lezen cursor N/A

De toepassing moet één keer (vooruit) door de resultatenset gaan door gebruik te maken van een servercursor. Het gedraagt zich hetzelfde als een TYPE_SS_SERVER_CURSOR_FORWARD_ONLY cursor.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_FORWARD_ONLY (CONCUR_UPDATABLE) Dynamisch (alleen vooruit) Alleen vooruit, updatebaar N/A N/A

De applicatie moet een enkele voorwaartse doorloop maken door de resultset om een of meerdere rijen te updaten.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

De ophaalgrootte is standaard opgelost wanneer de toepassing de setFetchSize-methode van het OBJECT SQLServerResultSet aanroept.

Opmerking

Het JDBC-stuurprogramma biedt een adaptieve bufferfunctie waarmee u uitvoerresultaten van de instructie kunt ophalen van de SQL Server, omdat deze nodig zijn voor de toepassing, in plaats van alles tegelijk. Als de toepassing bijvoorbeeld een grote gegevens moet ophalen die te groot is om volledig in het toepassingsgeheugen te passen, kan de clienttoepassing met adaptieve buffering een dergelijke waarde als een stream ophalen. Het standaardgedrag van het stuurprogramma is 'adaptief'. Om de adaptieve buffering voor de updatable resultatensets alleen doorsturen op te halen, moet de toepassing echter expliciet de methode setResponseBuffering van het SQLServerStatement-object aanroepen door een tekenreekswaarde 'adaptief' op te geven. Zie voor een voorbeeldcode bijwerken van een grote gegevensset.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SCROLL_INSENSITIVE Statisch Schuifbaar, kan niet worden bijgewerkt.

Externe rijupdates, invoegingen en verwijderingen zijn niet zichtbaar.
N/A N/A

Voor de toepassing is een momentopname van de database vereist. De resultatenset kan niet worden bijgewerkt. Alleen CONCUR_READ_ONLY wordt ondersteund. Alle andere gelijktijdigheidstypen veroorzaken een uitzondering bij gebruik met dit cursortype.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SCROLL_SENSITIVE (CONCUR_READ_ONLY) Keyset Scrollbaar, alleen-lezen modus. Externe rijupdates zijn zichtbaar en verwijderingen worden weergegeven als ontbrekende gegevens.

Externe rijinvoegingen zijn niet zichtbaar.
N/A N/A

De toepassing moet alleen gewijzigde gegevens voor bestaande rijen zien.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SCROLL_SENSITIVE (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) Keyset Schuifbaar, kan worden bijgewerkt.

Externe en interne rijupdates zijn zichtbaar en verwijderingen worden weergegeven als ontbrekende gegevens; invoegingen zijn niet zichtbaar.
N/A N/A

De toepassing kan gegevens in de bestaande rijen wijzigen met behulp van het ResultSet-object. De toepassing moet ook de wijzigingen in rijen kunnen zien die door anderen van buiten het ResultSet-object zijn aangebracht.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_DIRECT_FORWARD_ONLY N/A Alleen-doorsturen, alleen-lezen N/A volledig of aanpasbaar

Geheel getal = 2003. Biedt een alleen-lezen cursor aan de clientzijde die volledig is gebufferd. Er wordt geen servercursor gemaakt.

Alleen CONCUR_READ_ONLY gelijktijdigheidstype wordt ondersteund. Alle andere gelijktijdigheidstypen veroorzaken een uitzondering bij gebruik met dit cursortype.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SERVER_CURSOR_FORWARD_ONLY Snel vooruit Alleen vooruit N/A N/A

Integer = 2004. Snel en gebruikt een servercursor om toegang te krijgen tot alle gegevens. Het kan worden bijgewerkt wanneer het wordt gebruikt met het CONCUR_UPDATABLE concurrentietype.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Om adaptieve buffering voor dit geval op te halen, moet de toepassing de methode setResponseBuffering van het SQLServerStatement-object expliciet aanroepen door een tekenreekswaarde 'adaptief' op te geven. Zie voor een voorbeeldcode bijwerken van een grote gegevensset.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SCROLL_STATIC Statisch Updates van andere gebruikers worden niet weerspiegeld. N/A N/A

Integerwaarde = 1004. Voor de toepassing is een momentopname van de database vereist. Deze optie is het SQL Server-specifieke synoniem voor de JDBC_TYPE_SCROLL_INSENSITIVE en heeft hetzelfde gedrag bij gelijktijdigheidsinstellings.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SCROLL_KEYSET (CONCUR_READ_ONLY) Keyset Scrollbaar, alleen-lezen modus. Externe rijupdates zijn zichtbaar en verwijderingen worden weergegeven als ontbrekende gegevens.

Externe rijinvoegingen zijn niet zichtbaar.
N/A N/A

Integer = 1005. De toepassing moet alleen gewijzigde gegevens voor bestaande rijen zien. Deze optie is het SQL Server-specifieke synoniem voor de JDBC TYPE_SCROLL_SENSITIVE en heeft hetzelfde gelijktijdigheidsinstellingsgedrag.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SCROLL_KEYSET (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) Keyset Schuifbaar, kan worden bijgewerkt.

Externe en interne rijupdates zijn zichtbaar en verwijderingen worden weergegeven als ontbrekende gegevens; invoegingen zijn niet zichtbaar.
N/A N/A

Integer = 1005. De toepassing moet gegevens wijzigen of gewijzigde gegevens voor bestaande rijen bekijken. Deze optie is het SQL Server-specifieke synoniem voor de JDBC TYPE_SCROLL_SENSITIVE en heeft hetzelfde gelijktijdigheidsinstellingsgedrag.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SCROLL_DYNAMIC (CONCUR_READ_ONLY) Dynamisch Scrollbaar, alleen-lezen modus.

Externe rijupdates en invoegingen zijn zichtbaar en verwijderingen worden weergegeven als tijdelijke ontbrekende gegevens in de huidige ophaalbuffer.
N/A N/A

Gehele waarde = 1006. De toepassing moet gewijzigde gegevens voor bestaande rijen zien en ingevoegde en verwijderde rijen zien tijdens de levensduur van de cursor.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Resultaatsettype (cursor) SQL Server Cursortype Kenmerken methode selecteren reactiebuffering
TYPE_SS_SCROLL_DYNAMIC (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) Dynamisch Schuifbaar, kan worden bijgewerkt.

Externe en interne rijupdates en invoegingen zijn zichtbaar en verwijderingen worden weergegeven als tijdelijke ontbrekende gegevens in de huidige ophaalbuffer.
N/A N/A

Gehele waarde = 1006. De toepassing kan gegevens voor bestaande rijen wijzigen of rijen invoegen of verwijderen met behulp van het ResultSet-object. De toepassing moet ook wijzigingen, invoegingen en verwijderingen van anderen van buiten het ResultSet-object kunnen zien.

Rijen worden in blokken van de server opgehaald die zijn bepaald door de ophaalgrootte.

Cursorpositie

De cursors TYPE_FORWARD_ONLY, TYPE_SS_DIRECT_FORWARD_ONLY en TYPE_SS_SERVER_CURSOR_FORWARD_ONLY ondersteunen alleen de volgende plaatsingsmethode.

De TYPE_SS_SCROLL_DYNAMIC cursor biedt geen ondersteuning voor de absolute en getRow-methoden . De absolute methode kan worden geschat door een combinatie van aanroepen naar de eerste en relatieve methoden voor dynamische cursors.

De getRow-methode wordt alleen ondersteund door TYPE_FORWARD_ONLY, TYPE_SS_DIRECT_FORWARD_ONLY, TYPE_SS_SERVER_CURSOR_FORWARD_ONLY, TYPE_SS_SCROLL_KEYSET en TYPE_SS_SCROLL_STATIC cursors. De getRow-methode met alle typen cursors die alleen vooruit zijn, retourneert het aantal rijen dat tot nu toe door de cursor wordt gelezen.

Opmerking

Wanneer een toepassing een niet-ondersteunde cursorpositieaanroep maakt of een niet-ondersteunde aanroep naar de getRow-methode, wordt er een uitzondering gegenereerd met het bericht 'De aangevraagde bewerking wordt niet ondersteund met dit cursortype'.

Alleen de TYPE_SS_SCROLL_KEYSET en de equivalente TYPE_SCROLL_SENSITIVE cursors maken verwijderde rijen beschikbaar. Als de cursor op een verwijderde rij wordt geplaatst, zijn kolomwaarden niet beschikbaar en retourneert de methode rowDeleted 'true'. Aanroepen van <getType>-methoden genereren een uitzondering met het bericht: "Kan geen waarde verkrijgen uit een verwijderde rij." Verwijderde rijen kunnen niet worden bijgewerkt. Als u een methode updatetype<> voor een verwijderde rij probeert aan te roepen, wordt er een uitzondering gegenereerd met het bericht 'Een verwijderde rij kan niet worden bijgewerkt'. De TYPE_SS_SCROLL_DYNAMIC cursor heeft hetzelfde gedrag totdat de cursor uit de huidige ophaalbuffer wordt verplaatst.

Vooruit en dynamische cursors tonen verwijderde rijen op een vergelijkbare manier, maar alleen terwijl de cursors toegankelijk blijven in de fetch buffer. Voor voorwaartse cursors is dit gedrag vrij eenvoudig. Voor dynamische cursors is het complexer wanneer de ophaalgrootte groter is dan 1. Een toepassing kan de cursor vooruit en achteruit verplaatsen binnen het venster dat wordt gedefinieerd door de ophaalbuffer, maar de verdwenen rij zal verdwijnen wanneer de oorspronkelijke ophaalbuffer waarin deze is bijgewerkt, verlaten wordt. Als een toepassing geen tijdelijke verwijderde rijen wil zien met behulp van dynamische cursors, moet een relatief ophalen (0) worden gebruikt.

Als de sleutelwaarden van een TYPE_SS_SCROLL_KEYSET of TYPE_SCROLL_SENSITIVE cursorrij worden bijgewerkt met de cursor, behoudt de rij de oorspronkelijke positie in de resultatenset, ongeacht of de bijgewerkte rij voldoet aan de selectiecriteria van de cursor. Als de rij buiten de cursor is bijgewerkt, wordt een verwijderde rij weergegeven op de oorspronkelijke positie van de rij, maar wordt de rij alleen weergegeven in de cursor als er nog een rij met de nieuwe sleutelwaarden aanwezig was in de cursor, maar sindsdien is verwijderd.

Voor dynamische cursors behouden bijgewerkte rijen hun positie in de ophaalbuffer totdat het venster dat door de ophaalbuffer is gedefinieerd, overblijft. Bijgewerkte rijen worden later opnieuw weergegeven op verschillende posities in de resultatenset of verdwijnen mogelijk volledig. Toepassingen die tijdelijke inconsistenties in de resultaatset moeten voorkomen, moeten een ophaalgrootte van 1 gebruiken (de standaardwaarde is 8 rijen met CONCUR_SS_SCROLL_LOCKS gelijktijdigheid en 128 rijen met andere concurrenties).

Conversie van cursor

SQL Server kan er soms voor kiezen om een ander cursortype dan het aangevraagde type te implementeren, dat wordt aangeduid als een impliciete cursorconversie (of cursordegradatie).

Wanneer u met SQL Server 2000 (8.x) de gegevens bijwerkt via de ResultSet.TYPE_SCROLL_SENSITIVE en ResultSet.CONCUR_UPDATABLE resultatenset, wordt er een uitzondering gegenereerd met het bericht 'De cursor is ALLEEN-LEZEN'. Deze uitzondering treedt op omdat SQL Server 2000 (8.x) een impliciete cursorconversie voor die resultatenset heeft uitgevoerd en de aangevraagde bijwerkbare cursor niet heeft geretourneerd.

U kunt dit probleem omzeilen door een van de volgende oplossingen uit te voeren:

Cursor bijwerken

In-place updates worden ondersteund voor cursors waarbij het cursortype en gelijktijdigheid updates ondersteunen. Als de cursor niet is geplaatst op een rij die kan worden bijgewerkt in de resultatenset (geen geslaagde aanroep van de getType-methode), zal een aanroep van een updateType-methode een uitzondering worden opgewekt met als boodschap: "De resultatenset heeft geen huidige rij." De JDBC-specificatie geeft aan dat er een uitzondering plaatsvindt wanneer een updatemethode wordt aangeroepen voor een kolom van een cursor die is CONCUR_READ_ONLY. In situaties waarin de rij niet kan worden bijgewerkt, bijvoorbeeld vanwege een optimistisch gelijktijdigheidsconflict, zoals een concurrerende update of verwijdering, kan de uitzondering zich pas voordoen als insertRow, updateRow of DeleteRow wordt aangeroepen.

Na een aanroep van update<Type>, kan er niet worden toegegaan tot de betreffende kolom met get<Type> totdat updateRow of cancelRowUpdates is aangeroepen. Dit gedrag voorkomt problemen waarbij een kolom wordt bijgewerkt met behulp van een ander type dan het type dat door de server wordt geretourneerd, en daaropvolgende getter-aanroepen kunnen clienttypeconversies aanroepen die onjuiste resultaten geven. Aanroepen van get<Type> genereren een uitzondering met het bericht: 'Bijgewerkte kolommen kunnen pas worden benaderd nadat updateRow() of cancelRowUpdates() is aangeroepen.'

Opmerking

Als de updateRow-methode wordt aangeroepen wanneer er geen kolommen zijn bijgewerkt, genereert het JDBC-stuurprogramma een uitzondering met het bericht 'updateRow() aangeroepen wanneer er geen kolommen zijn bijgewerkt.'

Nadat moveToInsertRow is aangeroepen, wordt er een uitzondering gegenereerd als een andere methode dan get<Type>, updateType<>, insertRow en cursorpositiemethoden (inclusief moveToCurrentRow) worden aangeroepen in de resultatenset. De methode moveToInsertRow plaatst de resultatenset effectief in de invoegmodus, en de invoegmodus wordt beëindigd door het gebruik van cursorpositiemethoden. Relatieve cursorpositieaanroepen verplaatsen de cursor ten opzichte van de positie waar deze zich bevond voordat moveToInsertRow werd aangeroepen. Na het plaatsen van cursoraanroepen wordt de positie van de uiteindelijke doelcursor de nieuwe cursorpositie.

Als de aanroep voor het plaatsen van de cursor in de invoegmodus niet slaagt, is de cursorpositie na de mislukte aanroep de oorspronkelijke cursorpositie voordat moveToInsetRow werd aangeroepen. Als insertRow mislukt, blijft de cursor op de invoegrij staan en blijft de cursor in de invoegmodus staan.

Kolommen in de invoegrij hebben in eerste instantie een niet-geïnitialiseerde status. Oproepen van de update<Type>-methode zet de kolomstatus op geïnitialiseerd. Een aanroep van de get<Type-methode> voor een niet-geïnitialiseerde kolom genereert een uitzondering. Een aanroep van de insertRow-methode retourneert alle kolommen in de invoegrij naar een niet-geïnitialiseerde status.

Als kolommen niet geïnitialiseerd zijn wanneer de insertRow-methode wordt aangeroepen, wordt de standaardwaarde voor de kolom ingevoegd. Als er geen standaardwaarde is, maar de kolom nullable is, wordt NULL ingevoegd. Als er geen standaardwaarde is en de kolom niet nullable is, retourneert de server een fout en wordt er een uitzondering gegenereerd.

Opmerking

Aanroepen naar de getRow-methode retourneert 0 wanneer deze zich in de invoegmodus bevindt.

Het JDBC-stuurprogramma biedt geen ondersteuning voor positionele updates of verwijderingen. Volgens de JDBC-specificatie heeft de methode setCursorName geen effect en genereert de methode getCursorName een uitzondering als deze wordt aangeroepen.

Alleen-lezen en statische cursors kunnen nooit worden bijgewerkt.

SQL Server beperkt servercursors tot één resultatenset. Als een batch- of opgeslagen procedure meerdere instructies bevat, moet een alleen-voorwaarts alleen-lezen clientcursor worden gebruikt.