Conjuntos de filas y cursores de SQL Server (proveedor OLE DB de Native Client)
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
SQL Server devuelve conjuntos de resultados a los consumidores mediante dos métodos:
Conjuntos de resultados predeterminados que:
Minimizan la sobrecarga.
Proporcionan un rendimiento máximo en la captura de datos.
Solo admiten la funcionalidad de cursor predeterminado de solo avance y solo lectura.
Devuelven filas de una en una al consumidor.
Solo admiten una instrucción activa a la vez en una conexión.
Una vez ejecutada una instrucción, no podrá ejecutarse ninguna otra instrucción en la conexión hasta que el consumidor haya recuperado todos los resultados o se haya cancelado la instrucción.
Admiten todas las instrucciones Transact-SQL.
Cursores de servidor que:
Admiten toda la funcionalidad de cursor.
Pueden devolver bloques de filas al consumidor.
Admiten varias instrucciones activas en una única conexión.
Equilibran la funcionalidad de cursor con respecto al rendimiento.
La compatibilidad con la funcionalidad de cursor puede disminuir el rendimiento relativo a un conjunto de resultados predeterminado. Esto puede compensarse si el consumidor puede usar la funcionalidad de cursor para recuperar un conjunto de filas más pequeño.
No admiten ninguna instrucción de Transact-SQL que devuelva más de un único conjunto de resultados.
Los consumidores pueden solicitar distintos comportamientos de cursor en un conjunto de filas estableciendo determinadas propiedades del conjunto de filas. Si el consumidor no establece ninguna de estas propiedades de conjunto de filas o las establece todas en sus valores predeterminados, el proveedor OLE DB de SQL Server Native Client implementa el conjunto de filas mediante un conjunto de resultados predeterminado. Si alguna de estas propiedades se establece en un valor distinto del predeterminado, el proveedor OLE DB de SQL Server Native Client implementa el conjunto de filas mediante un cursor de servidor.
Las siguientes propiedades de conjunto de filas dirigen al proveedor OLE DB de SQL Server Native Client para usar cursores de SQL Server. Algunas propiedades pueden combinarse con otras sin ningún riesgo. Por ejemplo, un conjunto de filas que exhibe las propiedades DBPROP_IRowsetChange y DBPROP_IRowsetScroll será un conjunto de filas de marcador que exhibe un comportamiento de actualización inmediato. Otras propiedades se excluyen mutuamente. Por ejemplo, un conjunto de filas que exhibe DBPROP_OTHERINSERT no puede contener marcadores.
| Id. de propiedad | Value | Comportamiento del conjunto de filas |
|---|---|---|
| DBPROP_SERVERCURSOR | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas es secuencial y solamente admite desplazamiento y captura hacia delante. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY. |
| DBPROP_CANSCROLLBACKWARDS o DBPROP_CANFETCHBACKWARDS | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas admite desplazamiento y captura en cualquier dirección. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY. |
| DBPROP_BOOKMARKS o DBPROP_LITERALBOOKMARKS | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas es secuencial y solamente admite desplazamiento y captura hacia delante. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY. |
| DBPROP_OWNUPDATEDELETE o DBPROP_OWNINSERT o DBPROP_OTHERUPDATEDELETE | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas admite desplazamiento y captura en cualquier dirección. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY. |
| DBPROP_OTHERINSERT | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas admite desplazamiento y captura en cualquier dirección. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY si existe un índice en las columnas a las que se hace referencia. DBPROP_OTHERINSERT no puede ser VARIANT_TRUE si el conjunto de filas contiene marcadores. Si se intenta crear un conjunto de filas con esta propiedad de visibilidad y marcadores, se genera un error. |
| DBPROP_IRowsetLocate o DBPROP_IRowsetScroll | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas admite desplazamiento y captura en cualquier dirección. Se admiten marcadores y posicionamiento absoluto mediante de la interfaz IRowsetLocate en el conjunto de filas. El texto de comando puede incluir una cláusula ORDER BY. DBPROP_IRowsetLocate y DBPROP_IRowsetScroll requieren marcadores en el conjunto de filas. Si se intenta crear un conjunto de filas con marcadores y DBPROP_OTHERINSERT se establece en VARIANT_TRUE, se genera un error. |
| DBPROP_IRowsetChange o DBPROP_IRowsetUpdate | VARIANT_TRUE | Puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas es secuencial y solamente admite desplazamiento y captura hacia delante. Se admite la posición de fila relativa. Todos los comandos que admiten cursores actualizables pueden admitir estas interfaces. |
| DBPROP_IRowsetLocate o DBPROP_IRowsetScroll y DBPROP_IRowsetChange o DBPROP_IRowsetUpdate | VARIANT_TRUE | Puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas admite desplazamiento y captura en cualquier dirección. Se admiten marcadores y posicionamiento absoluto mediante la interfaz IRowsetLocate en el conjunto de filas. El texto de comando puede incluir una cláusula ORDER BY. |
| DBPROP_IMMOBILEROWS | VARIANT_FALSE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas solamente admite desplazamiento hacia delante. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY si existe un índice en las columnas a las que se hace referencia. DBPROP_IMMOBILEROWS solo está disponible en conjuntos de filas que pueden mostrar las filas de SQL Server insertadas mediante comandos en otras sesiones o por parte de otros usuarios. Si se intenta abrir un conjunto de filas con la propiedad establecida en VARIANT_FALSE en cualquier conjunto de filas para el que DBPROP_OTHERINSERT no puede ser VARIANT_TRUE, se produce un error. |
| DBPROP_REMOVEDELETED | VARIANT_TRUE | No puede actualizar los datos de SQL Server a través del conjunto de filas. El conjunto de filas solamente admite desplazamiento hacia delante. Se admite la posición de fila relativa. El texto de comando puede incluir una cláusula ORDER BY a menos que esté restringido por otra propiedad. |
Un conjunto de filas de proveedor OLE DB de SQL Server Native Client compatible con un cursor de servidor se puede crear fácilmente en una tabla base o vista de SQL Server mediante el método IOpenRowset::OpenRowset . Especifique la tabla o vista con su nombre, pasando los conjuntos de propiedades de conjunto de filas correspondientes en el parámetro rgPropertySets.
El texto de comando que crea un conjunto de filas se restringe cuando el consumidor requiere que un cursor de servidor admita el conjunto de filas. Concretamente, el texto de comando se restringe a una única instrucción SELECT que devuelve un único resultado de conjunto de filas, o bien, a un procedimiento almacenado que implementa una única instrucción SELECT que devuelve un único resultado de conjunto de filas.
En estas dos tablas se muestran las asignaciones de varias propiedades OLE DB y los modelos de cursor. También se muestran las propiedades de conjunto de filas que deberían establecerse para usar un determinado tipo de modelo de cursor.
Cada celda de la tabla contiene un valor de propiedad de conjunto de filas para cada modelo de cursor específico. El tipo de datos de todas las propiedades de conjunto de filas anteriormente indicadas en este tema es VT_BOOL y el valor predeterminado es VARIANT_FALSE. En la tabla se usan los símbolos siguientes.
F = valor predeterminado (VARIANT_FALSE)
T = VARIANT_TRUE
- = VARIANT_TRUE o VARIANT_FALSE
Para usar un tipo de modelo de cursor determinado, busque la columna correspondiente al modelo de cursor y busque todas las propiedades de conjunto de filas que tengan el valor 'T' en la columna. Establezca estas propiedades de conjunto de filas en VARIANT_TRUE para usar ese modelo de cursor específico. Las propiedades del conjunto de filas que contienen '-' como valor pueden establecerse en VARIANT_TRUE o VARIANT_FALSE.
| Propiedades de conjunto de filas o modelos de cursores | Valor predeterminado resultado set (SL) |
Fast (rápido) solo solo (SL) |
estática (SL) |
Keyset conjuntos de claves (SL) |
|---|---|---|---|---|
| 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 |
| Propiedades de conjunto de filas/modelos de cursores | Dinámico (SL) | Conjunto de claves (L/E) | Dinámico (L/E) |
|---|---|---|---|
| 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 |
Para un conjunto determinado de propiedades de conjunto de filas, el modelo de cursor seleccionado se determina tal y como se indica a continuación.
De la colección especificada de propiedades de conjunto de filas, obtenga un subconjunto de propiedades de los que se indicaban en las tablas anteriores. Divida estas propiedades en dos subgrupos en función del valor de marca de cada propiedad del conjunto de filas: requerido (T, F) u opcional (-). Para cada modelo de cursor, empiece en la primera tabla y desplácese de izquierda a derecha. Compare los valores de las propiedades de los dos subgrupos con los valores de las propiedades correspondientes de esa columna. Se seleccionará el modelo de cursor que no presente ninguna discrepancia con las propiedades necesarias y que tenga el menor número de discrepancias con las propiedades opcionales. Si hay más de un modelo de cursor, se elegirá el que esté situado más a la izquierda.
Tamaño del bloque de cursor de SQL Server
Cuando un cursor de SQL Server admite un conjunto de filas OLE DB de SQL Server Native Client, el número de elementos del parámetro de matriz de identificador de fila del IRowset::GetNextRows o los métodos IRowsetLocate::GetRowsAt define el tamaño del bloque de cursor. Las filas indicadas por los identificadores de la matriz son los miembros del bloque de cursor.
En el caso de los conjuntos de filas que admiten marcadores, los identificadores de fila recuperados mediante el método IRowsetLocate::GetRowsByBookmark definen los miembros del bloque de cursor.
Independientemente del método usado para rellenar el conjunto de filas y formar el bloque de cursor de SQL Server, el bloque de cursor estará activo hasta que se ejecute el siguiente método de captura de filas en el conjunto de filas.