Rowsets und SQL Server-Cursor (Native Client OLE DB-Anbieter)
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
SQL Server gibt Consumern Resultsets mit zwei Methoden zurück:
Standardresultsets mit folgenden Funktionen:
Minimierung der Verwaltung
Maximale Leistung beim Abrufen der Daten
Unterstützung der standardmäßigen schreibgeschützten Vorwärtscursorfunktion
Zeilenweise Rückgabe an den Consumer
Unterstützung von nur jeweils einer aktiven Anweisung für eine Verbindung
Nachdem eine Anweisung ausgeführt wurde, kann die nächste Anweisung über diese Verbindung erst ausgeführt werden, wenn alle Ergebnisse vom Consumer abgerufen wurden oder die Anweisung abgebrochen wurde.
Unterstützung aller Transact-SQL-Anweisungen
Servercursor mit folgenden Funktionen:
Unterstützung aller Cursorfunktionen
Mögliche Rückgabe von Zeilenblöcken an den Consumer
Unterstützung mehrerer aktiver Anweisungen über eine einzelne Verbindung
Abwägen von Cursorfunktionalität gegenüber der Leistung
Die Unterstützung der Cursorfunktionalität kann die Leistung in Bezug auf ein Standardresultset verringern. Dieser Nachteil kann ausgeglichen werden, wenn der Consumer die Cursorfunktionalität zum Abrufen einer kleineren Zeilenmenge verwenden kann.
Keine Unterstützung für Transact-SQL-Anweisungen, die mehr als ein einzelnes Resultset zurückgeben
Consumer können andere Cursorverhaltensweisen in einem Rowset anfordern, indem sie bestimmte Rowseteigenschaften festlegen. Wenn der Consumer keine dieser Rowseteigenschaften festlegt oder sie alle auf ihre Standardwerte festlegt, implementiert der OLE DB-Anbieter von SQL Server Native Client das Rowset mit einem Standardergebnissatz. Wenn eine dieser Eigenschaften auf einen anderen Wert als den Standardwert festgelegt ist, implementiert der OLE DB-Anbieter von SQL Server Native Client das Rowset mithilfe eines Servercursors.
Die folgenden Rowseteigenschaften leiten den OLE DB-Anbieter des SQL Server Native Client zur Verwendung von SQL Server-Cursorn an. Einige Eigenschaften können mit anderen problemlos kombiniert werden. Ein Rowset mit den Eigenschaften DBPROP_IRowsetScroll und DBPROP_IRowsetChange entspricht beispielsweise einem Lesezeichenrowset mit sofortigem Updateverhalten. Andere Eigenschaften schließen sich hingegen gegenseitig aus. Zum Beispiel kann ein Rowset, das DBPROP_OTHERINSERT aufweist, keine Lesezeichen enthalten.
| Eigenschafts-ID | value | Rowsetverhalten |
|---|---|---|
| DBPROP_SERVERCURSOR | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset ist sequenziell und unterstützt nur den Bildlauf vorwärts und das Abrufen. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. |
| DBPROP_CANSCROLLBACKWARDS oder DBPROP_CANFETCHBACKWARDS | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt das Durchführen eines Bildlaufs und das Abrufen in beiden Richtungen. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. |
| DBPROP_BOOKMARKS oder DBPROP_LITERALBOOKMARKS | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset ist sequenziell und unterstützt nur den Bildlauf vorwärts und das Abrufen. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. |
| DBPROP_OWNUPDATEDELETE oder DBPROP_OWNINSERT oder DBPROP_OTHERUPDATEDELETE | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt das Durchführen eines Bildlaufs und das Abrufen in beiden Richtungen. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. |
| DBPROP_OTHERINSERT | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt das Durchführen eines Bildlaufs und das Abrufen in beiden Richtungen. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten, wenn ein Index für die Spalten vorhanden ist, auf die verwiesen wird. DBPROP_OTHERINSERT kann nicht VARIANT_TRUE sein, wenn das Rowset Lesezeichen enthält. Wenn Sie versuchen, ein Rowset mit dieser Visibility-Eigenschaft und Lesezeichen zu erstellen, wird ein Fehler ausgegeben. |
| DBPROP_IRowsetLocate oder DBPROP_IRowsetScroll | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt das Durchführen eines Bildlaufs und das Abrufen in beiden Richtungen. Lesezeichen und die absolute Positionierung durch die IRowsetLocate-Schnittstelle werden im Rowset unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. DBPROP_IRowsetLocate und DBPROP_IRowsetScroll erfordern Lesezeichen im Rowset. Wenn Sie versuchen, ein Rowset mit Lesezeichen und der DBPROP_OTHERINSERT-Eigenschaft zu erstellen, die auf VARIANT_TRUE festgelegt ist, tritt ein Fehler auf. |
| DBPROP_IRowsetChange oder DBPROP_IRowsetUpdate | VARIANT_TRUE | SQL Server-Daten können über das Rowset aktualisiert werden. Das Rowset ist sequenziell und unterstützt nur den Bildlauf vorwärts und das Abrufen. Die relative Zeilenpositionierung wird unterstützt. Alle Befehle, die für aktualisierbare Cursor verfügbar sind, können diese Schnittstellen unterstützen. |
| DBPROP_IRowsetLocate oder DBPROP_IRowsetScroll und DBPROP_IRowsetChange oder DBPROP_IRowsetUpdate | VARIANT_TRUE | SQL Server-Daten können über das Rowset aktualisiert werden. Das Rowset unterstützt das Durchführen eines Bildlaufs und das Abrufen in beiden Richtungen. Lesezeichen und die absolute Positionierung durch IRowsetLocate werden im Rowset unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten. |
| DBPROP_IMMOBILEROWS | VARIANT_FALSE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt nur den Bildlauf vorwärts. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten, wenn ein Index für die Spalten vorhanden ist, auf die verwiesen wird. DBPROP_IMMOBILEROWS ist nur in Rowsets verfügbar, die SQL Server-Zeilen anzeigen können, die von Befehlen in anderen Sitzungen oder von anderen Benutzern eingefügt wurden. Wenn Sie versuchen, ein Rowset mit einer auf VARIANT_FALSE festgelegten Eigenschaft für ein Rowset zu öffnen, für das DBPROP_OTHERINSERT nicht VARIANT_TRUE sein kann, tritt ein Fehler auf. |
| DBPROP_REMOVEDELETED | VARIANT_TRUE | SQL Server-Daten können nicht über das Rowset aktualisiert werden. Das Rowset unterstützt nur den Bildlauf vorwärts. Die relative Zeilenpositionierung wird unterstützt. Befehlstext kann eine ORDER BY-Klausel enthalten, sofern keine Beschränkung durch eine andere Eigenschaft vorliegt. |
Ein SQL Server Native Client OLE DB-Anbieter-Rowset, das von einem Servercursor unterstützt wird, kann mithilfe der IOpenRowset::OpenRowset-Methode auf einfache Weise in einer SQL Server-Basistabelle oder -Ansicht erstellt werden. Geben Sie die Tabelle oder die Sicht mit Namen an, indem die erforderlichen Eigenschaftensätze für das Rowset im rgPropertySets-Parameter übergeben werden.
Befehlstext, der ein Rowset erstellt, ist eingeschränkt, wenn der Consumer erfordert, dass das Rowset von einem Servercursor unterstützt wird. Der Befehlstext ist insbesondere entweder auf eine einzelne SELECT-Anweisung, die ein einzelnes Rowsetergebnis zurückgibt, oder auf eine gespeicherte Prozedur beschränkt, die eine einzelne SELECT-Anweisung implementiert, mit der ein einzelnes Rowsetergebnis zurückgegeben wird.
Diese beiden Tabellen zeigen die Zuordnungen verschiedener OLE DB-Eigenschaften sowie die Cursormodelle an. Sie geben außerdem Aufschluss darüber, welche Rowseteigenschaften festgelegt werden sollen, um einen bestimmten Cursormodelltyp zu verwenden.
Jede Zelle in der Tabelle enthält einen Wert der Rowseteigenschaft für das bestimmte Cursormodell. Der Datentyp aller bereits in diesem Thema aufgeführten Rowseteigenschaft lautet VT_BOOL und der Standardwert ist VARIANT_FALSE. In der Tabelle werden die folgenden Symbole verwendet.
F = Standardwert (VARIANT_FALSE)
T = VARIANT_TRUE
- = VARIANT_TRUE oder VARIANT_FALSE
Um ein bestimmtes Cursormodell zu verwenden, suchen Sie die dem Cursormodell entsprechende Spalte, und suchen Sie alle Rowseteigenschaften mit dem Wert "T" in der Spalte. Legen Sie diese Rowseteigenschaften auf VARIANT_TRUE fest, um das gewünschte Cursormodell zu verwenden. Die Rowseteigenschaften mit dem Wert "-" können entweder auf VARIANT_TRUE oder VARIANT_FALSE festgelegt werden.
| Rowseteigenschaften/Cursormodelle | Standard result set (RO) |
Schnell forward- Machine Learning (RO) |
statischen (RO) |
Keyset driven (RO) |
|---|---|---|---|---|
| DBPROP_SERVERCURSOR | F | T | T | T |
| DBPROP_DEFERRED | F | F | - | - |
| DBPROP_IrowsetChange | F | F | F | F |
| DBPROP_IrowsetLocate | F | F | - | - |
| DBPROP_IrowsetScroll | F | F | - | - |
| DBPROP_IrowsetUpdate | F | F | F | F |
| DBPROP_BOOKMARKS | F | F | - | - |
| DBPROP_CANFETCHBACKWARDS | F | F | - | - |
| DBPROP_CANSRCOLLBACKWARDS | F | F | - | - |
| DBPROP_CANHOLDROWS | F | F | - | - |
| DBPROP_LITERALBOOKMARKS | F | F | - | - |
| DBPROP_OTHERINSERT | F | T | F | F |
| DBPROP_OTHERUPDATEDELETE | F | T | F | T |
| DBPROP_OWNINSERT | F | T | F | T |
| DBPROP_OWNUPDATEDELETE | F | T | F | T |
| DBPROP_QUICKSTART | F | F | - | - |
| DBPROP_REMOVEDELETED | F | F | F | - |
| DBPROP_IrowsetResynch | F | F | F | - |
| DBPROP_CHANGEINSERTEDROWS | F | F | F | F |
| DBPROP_SERVERDATAONINSERT | F | F | F | - |
| DBPROP_UNIQUEROWS | - | F | F | F |
| DBPROP_IMMOBILEROWS | - | - | - | T |
| Rowseteigenschaften/Cursormodelle | Dynamic (RO) | Keyset (R/W) | Dynamic (R/W) |
|---|---|---|---|
| DBPROP_SERVERCURSOR | T | T | T |
| DBPROP_DEFERRED | - | - | - |
| DBPROP_IrowsetChange | F | - | - |
| DBPROP_IrowsetLocate | F | - | F |
| DBPROP_IrowsetScroll | F | - | F |
| DBPROP_IrowsetUpdate | F | - | - |
| DBPROP_BOOKMARKS | F | - | F |
| DBPROP_CANFETCHBACKWARDS | - | - | - |
| DBPROP_CANSRCOLLBACKWARDS | - | - | - |
| DBPROP_CANHOLDROWS | F | - | F |
| DBPROP_LITERALBOOKMARKS | F | - | F |
| DBPROP_OTHERINSERT | T | F | T |
| DBPROP_OTHERUPDATEDELETE | T | T | T |
| DBPROP_OWNINSERT | T | T | T |
| DBPROP_OWNUPDATEDELETE | T | T | T |
| DBPROP_QUICKSTART | - | - | - |
| DBPROP_REMOVEDELETED | T | - | T |
| DBPROP_IrowsetResynch | - | - | - |
| DBPROP_CHANGEINSERTEDROWS | F | - | F |
| DBPROP_SERVERDATAONINSERT | F | - | F |
| DBPROP_UNIQUEROWS | F | F | F |
| DBPROP_IMMOBILEROWS | F | T | F |
Für einen spezifischen Satz von Rowseteigenschaften wird das Cursormodell, das ausgewählt wird, wie folgt bestimmt.
Rufen Sie von der angegebenen Auflistung von Rowseteigenschaften eine Teilmenge von den in den vorherigen Tabellen aufgelisteten Eigenschaften ab. Teilen Sie diese Eigenschaften abhängig vom Flagwert – erforderlich (T, F) oder optional (-) – der jeweiligen Rowseteigenschaften in zwei Untergruppen auf. Beginnen Sie für die einzelnen Cursormodelle in der ersten Tabelle, und gehen Sie von links nach rechts vor. Vergleichen Sie die Werte der Eigenschaften in den beiden Untergruppen mit den Werten der entsprechenden Eigenschaften in dieser Spalte. Das Cursormodell, für das keine fehlende Übereinstimmung mit den erforderlichen Eigenschaften und die geringste Zahl fehlender Übereinstimmungen mit den optionalen Eigenschaften gefunden wird, wird ausgewählt. Wenn dies auf mehr als ein Cursormodell zutrifft, wird das am weitesten links stehende Modell ausgewählt.
Blockgröße des SQL Server-Cursors
Wenn ein SQL Server-Cursor ein SQL Server Native Client OLE DB-Anbieter-Rowset unterstützt, definiert die Anzahl der Elemente im Zeilenhandle-Arrayparameter des IRowset::GetNextRows oder der IRowsetLocate::GetRowsAt-Methoden die Cursorblockgröße. Die von den Handles im Array angegebenen Zeilen sind die Elemente des Cursorblocks.
Für Rowsets, die Lesezeichen unterstützen, werden die Elemente des Cursorblocks durch die mit der IRowsetLocate::GetRowsByBookmark-Methode abgerufenen Zeilenhandles definiert.
Der Cursorblock ist unabhängig von der Methode, die zum Auffüllen des Rowsets und zur Bildung des SQL Server-Cursorblocks verwendet wird, aktiv, bis die nächste Methode zum Abrufen von Zeilen für das Rowset ausgeführt wird.