Propiedades y comportamientos de conjuntos de filas
Se aplica a:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Estas son las propiedades de los conjuntos de filas de OLE DB Driver for SQL Server:
| Id. de propiedad | Descripción |
|---|---|
| DBPROP_ABORTPRESERVE | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: esta propiedad determina el comportamiento de un conjunto de filas tras una operación de anulación. VARIANT_FALSE: OLE DB Driver for SQL Server invalida los conjuntos de filas después de una operación de anulación. Prácticamente se pierde la funcionalidad del objeto de conjunto de filas. Solo se admiten operaciones IUnknown y la liberación de identificadores de descriptores de acceso y filas pendientes. VARIANT_TRUE: OLE DB Driver for SQL Server mantiene un conjunto de filas válido. |
| DBPROP_ACCESSORDER | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: DBPROPVAL_AO_RANDOM Descripción: orden de acceso. orden en que debe obtenerse acceso a las columnas en el conjunto de filas. DBPROPVAL_AO_RANDOM: se puede acceder a la columna en cualquier orden. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: solamente se puede acceder a columnas enlazadas como objetos de almacenamiento en orden secuencial, según determina el índice de columna. DBPROPVAL_AO_SEQUENTIAL: se debe acceder a todas las columnas en orden secuencial, según determina el índice de columna. |
| DBPROP_APPENDONLY | OLE DB Driver for SQL Server no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: Los objetos de almacenamiento de OLE DB Driver for SQL Server se bloquean mediante otros métodos de conjunto de filas. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server admite marcadores para la identificación de filas del conjunto de filas cuando DBPROP_BOOKMARKS o DBPROP_LITERALBOOKMARKS es VARIANT_TRUE. Al establecer una de estas propiedades en VARIANT_TRUE no se habilita el posicionamiento por marcador del conjunto de filas. Establezca DBPROP_IRowsetLocate o DBPROP_IRowsetScroll en VARIANT_TRUE para crear un conjunto de filas que admita el posicionamiento por marcador del conjunto de filas. OLE DB Driver for SQL Server usa un cursor Microsoft SQL Server para admitir un conjunto de filas que contiene marcadores. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. Nota: Si estas propiedades entran en conflicto con otras propiedades de definición de cursor del controlador OLE DB para SQL Server, se producirá un error. Por ejemplo, si DBPROP_BOOKMARKS se establece en VARIANT_TRUE cuando la propiedad DBPROP_OTHERINSERT también está establecida en VARIANT_TRUE, se genera un error cuando el consumidor intenta abrir un conjunto de filas. |
| DBPROP_BOOKMARKSKIPPED | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server devuelve DB_E_BADBOOKMARK si el consumidor indica un marcador no válido al colocar o buscar un conjunto de filas marcado. |
| DBPROP_BOOKMARKTYPE | R (lectura) y W (escritura): Solo lectura Valor predeterminado: DBPROPVAL_BMK_NUMERIC Descripción: OLE DB Driver for SQL Server solo implementa marcadores numéricos. Un marcador de OLE DB Driver for SQL Server es un entero sin signo de 32 bits, de tipo DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | OLE DB Driver for SQL Server no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server admite la captura y el desplazamiento hacia atrás en conjuntos de filas no secuenciales. El controlador OLE DB para SQL Server crea un conjunto de filas que admite cursores cuando DBPROP_CANFETCHBACKWARDS o DBPROP_CANSCROLLBACKWARDS es VARIANT_TRUE. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. |
| DBPROP_CANHOLDROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: de forma predeterminada, OLE DB Driver for SQL Server devuelve DB_E_ROWSNOTRELEASED si el consumidor intenta obtener más filas de un conjunto de filas mientras hay cambios pendientes en las que están actualmente en el conjunto de filas. Este comportamiento puede modificarse. El establecimiento de DBPROP_CANHOLDROWS y DBPROP_IRowsetChange en VARIANT_TRUE, implica un conjunto de filas marcado. Si ambas propiedades son VARIANT_TRUE, la interfaz IRowsetLocate estará disponible en el conjunto de filas y las propiedades DBPROP_BOOKMARKS y DBPROP_LITERALBOOKMARKS serán ambas VARIANT_TRUE. Los cursores de SQL Server admiten conjuntos de filas de OLE DB Driver for SQL Server que contienen marcadores. |
| DBPROP_CHANGEINSERTEDROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: esta propiedad solo puede establecerse en VARIANT_TRUE si el conjunto de filas usa un cursor controlado por conjunto de claves. |
| DBPROP_COLUMNRESTRICT | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server establece la propiedad en VARIANT_TRUE cuando el consumidor no puede modificar una columna de un conjunto de filas. Es posible que otras columnas del conjunto de filas puedan actualizarse y también es posible que puedan eliminarse las propias filas. Cuando esta propiedad es VARIANT_TRUE, el consumidor examina el miembro dwFlags de la estructura DBCOLUMNINFO para determinar si puede escribirse o no el valor de una columna individual. Para las columnas que pueden modificarse, dwFlags muestra DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: 0 Descripción: De forma predeterminada, OLE DB Driver for SQL Server no agota el tiempo de espera en el método ICommand::Execute. |
| DBPROP_COMMITPRESERVE | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: esta propiedad determina el comportamiento de un conjunto de filas tras una operación de confirmación. VARIANT_TRUE: OLE DB Driver for SQL Server mantiene un conjunto de filas válido. VARIANT_FALSE: OLE DB Driver for SQL Server invalida los conjuntos de filas después de una operación de confirmación. Prácticamente se pierde la funcionalidad del objeto de conjunto de filas. Solo se admiten operaciones IUnknown y la liberación de identificadores de descriptores de acceso y filas pendientes. |
| DBPROP_DEFERRED | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: cuando se establece en VARIANT_TRUE, OLE DB Driver for SQL Server intenta usar un cursor de servidor para el conjunto de filas. El servidor no devuelve las columnas text, ntext e image hasta que la aplicación acceda a estas. |
| DBPROP_DELAYSTORAGEOBJECTS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server admite el modo de actualización inmediata en los objetos de almacenamiento. Los cambios realizados en los datos de un objeto de flujo se envían inmediatamente a SQL Server. Las modificaciones se confirman en función del modo de transacción del conjunto de filas. |
| DBPROP_HIDDENCOLUMNS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: Recuento de columnas ocultas Si DBPROP_UNIQUEROWS es VARIANT_TRUE, la propiedad DBPROP_HIDDENCOLUMNS devuelve el número de columnas "ocultas" adicionales agregadas por el proveedor para identificar de forma única las filas del conjunto de filas. Los métodos IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset devuelven estas columnas. Pero no se incluyen en el número de filas indicado por el argumento pcColumns devuelto por IColumnsInfo::GetColumnInfo. Para determinar el número total de columnas representadas en la estructura prgInfo devuelta por IColumnsInfo::GetColumnInfo, incluidas las columnas ocultas, el consumidor suma el valor de DBPROP_HIDDENCOLUMNS al número de columnas devuelto por IColumnsInfo::GetColumnInfo en pcColumns. Si DBPROP_UNIQUEROWS es VARIANT_FALSE, DBPROP_HIDDENCOLUMNS es cero. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: OLE DB Driver for SQL Server admite estas interfaces en todos los conjuntos de filas. |
| DBPROP_IColumnsRowset | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: OLE DB Driver for SQL Server admite la interfaz IColumnsRowset. |
| DBPROP_IConnectionPointContainer | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: IConnectionPointContainer. Si es VARIANT_TRUE, el conjunto de filas admite la interfaz especificada. Si es VARIANT_FALSE, el conjunto de filas no admite la interfaz especificada. Los proveedores que admiten esta interfaz deben admitir la propiedad asociada a la interfaz con un valor VARIANT_TRUE. Estas propiedades se utilizan principalmente para solicitar interfaces a través de ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server admite la interfaz IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server admite las interfaces IRowsetChange y IRowsetUpdate. Los conjuntos de filas creados utilizando DBPROP_IRowsetChange igual a VARIANT_TRUE exhiben los comportamientos de modo de actualización inmediatos. Cuando DBPROP_IRowsetUpdate es VARIANT_TRUE, DBPROP_IRowsetChange también es VARIANT_TRUE. El conjunto de filas exhibe un comportamiento de modo de actualización retrasada. OLE DB Driver for SQL Server usa un cursor SQL Server para admitir conjuntos de filas que exponen IRowsetChange o IRowsetUpdate. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. |
| DBPROP_IRowsetIdentity | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: OLE DB Driver for SQL Server admite la interfaz IRowsetIdentity. Si un conjunto de filas admite esta interfaz, cualquier par de identificadores de fila que represente la misma fila subyacente siempre reflejará los mismos datos y el mismo estado. Los consumidores pueden llamar al método IRowsetIdentity:: IsSameRow para comparar dos manipuladores de fila para ver si hacen referencia a la misma instancia de fila. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server puede exponer las interfaces IRowsetLocate y IRowsetScroll. Cuando DBPROP_IRowsetLocate es VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS y DBPROP_CANSCROLLBACKWARDS también son VARIANT_TRUE. Cuando DBPROP_IRowsetScroll es VARIANT_TRUE, DBPROP_IRowsetLocate también es VARIANT_TRUE y ambas interfaces están disponibles en el conjunto de filas. Se requieren marcadores para ambas interfaces. El controlador OLE DB para SQL Server establece DBPROP_BOOKMARKS y DBPROP_LITERALBOOKMARKS en VARIANT_TRUE cuando el consumidor solicita una de las interfaces. OLE DB Driver for SQL Server usa cursores de SQL Server para admitir IRowsetLocate y IRowsetScroll. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. Si estas propiedades entran en conflicto con otras propiedades de definición de cursor del controlador OLE DB para SQL Server, se producirá un error. Por ejemplo, si DBPROP_IRowsetScroll se establece en VARIANT_TRUE cuando la propiedad DBPROP_OTHERINSERT también está establecida en VARIANT_TRUE, se genera un error cuando el consumidor intenta abrir un conjunto de filas. |
| DBPROP_IRowsetResynch | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server expone la interfaz IRowsetResynch a petición. OLE DB Driver for SQL Server puede exponer la interfaz en cualquier conjunto de filas. |
| DBPROP_ISupportErrorInfo | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: OLE DB Driver for SQL Server expone la interfaz ISupportErrorInfo en conjuntos de filas. |
| DBPROP_ILockBytes | OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error. |
| DBPROP_ISequentialStream | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server expone la interfaz ISequentialStream para admitir datos largos de longitud variable almacenados en SQL Server. |
| DBPROP_IStorage | OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error. |
| DBPROP_IStream | OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error. |
| DBPROP_IMMOBILEROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: la propiedad solo es VARIANT_TRUE para los cursores de conjunto de claves de SQL Server; es VARIANT_FALSE en el caso de todos los demás cursores. VARIANT_TRUE: el conjunto de filas no reordenará las filas insertadas o actualizadas. En el caso de IRowsetChange::InsertRow, las filas aparecerán al final del conjunto de filas. En el caso de IRowsetChange::SetData, si el conjunto de filas no está ordenado, no se modificará la posición de las filas actualizadas. Si el conjunto de filas está ordenado y el método IRowsetChange::SetData modifica una columna que se usa para ordenar el conjunto de filas, la fila no se mueve. Si el conjunto de filas se crea en un conjunto de columnas de clave (normalmente un conjunto de filas para el que DBPROP_OTHERUPDATEDELETE es VARIANT_TRUE pero DBPROP_OTHERINSERT es VARIANT_FALSE), modificar el valor de una columna de clave suele ser equivalente a eliminar la fila actual e insertar una nueva. Por lo tanto, si DBPROP_OWNINSERT es VARIANT_FALSE, es posible que parezca que la fila se mueve o incluso desaparece del conjunto de filas, aunque la propiedad DBPROP_IMMOBILEROWS sea VARIANT_TRUE. VARIANT_FALSE: si el conjunto de filas está ordenado, las filas insertadas aparecen en el orden correcto del conjunto de filas. Si el conjunto de filas no está ordenado, la fila insertada aparece al final. Si IRowsetChange::SetData modifica una columna que se usa para ordenar el conjunto de filas, la fila se mueve. Si el conjunto de filas no está ordenado, no se modifica la posición de la fila. |
| DBPROP_LITERALIDENTITY | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: esta propiedad siempre es VARIANT_TRUE. |
| DBPROP_LOCKMODE | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: DBPROPVAL_LM_NONE Descripción: nivel de bloqueo aplicado por el conjunto de filas (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Nota: Cuando se usa el aislamiento de instantáneas en una transacción, si un conjunto de filas se abre mediante un cursor de servidor dinámico o de conjunto de claves y el modo de bloqueo se establece en DBPROPVAL_LM_SINGLEROW, se producirá un error al capturar una fila si otro usuario ha actualizado esta fila desde que se iniciara la transacción. En otros tipos de cursor y modos de bloqueo, si otro usuario ha actualizado la fila desde que se inició la transacción, no se produce ningún error hasta que el usuario intenta actualizar la fila. En ambos casos, el servidor genera estos errores. |
| DBPROP_MAXOPENROWS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: 0 Descripción: OLE DB Driver for SQL Server no limita el número de filas que pueden estar activas en conjuntos de filas. |
| DBPROP_MAXPENDINGROWS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: 0 Descripción: OLE DB Driver for SQL Server no limita el número de filas de conjunto de filas con cambios pendientes. |
| DBPROP_MAXROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: 0 Descripción: de forma predeterminada, OLE DB Driver for SQL Server no limita el número de filas de un conjunto de filas. Cuando el consumidor establece DBPROP_MAXROWS, el controlador OLE DB para SQL Server usa la instrucción SET ROWCOUNT para limitar el número de filas del conjunto de filas. SET ROWCOUNT puede producir consecuencias no deseadas en la ejecución de instrucciones SQL Server. Para obtener más información, vea SET ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_MEMORYUSAGE | OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_NOTIFICATIONGRANULARITY | OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_NOTIFICATIONPHASES | R (lectura) y W (escritura): Solo lectura Valor predeterminado: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Descripción: OLE DB Driver for SQL Server admite todas las fases de notificación. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | R (lectura) y W (escritura): Solo lectura Valor predeterminado: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Descripción: las fases de notificación de OLE DB Driver for SQL Server pueden cancelarse antes de intentar realizar la modificación indicada en el conjunto de filas. OLE DB Driver for SQL Server no admite la cancelación de fases una vez completado el intento. |
| DBPROP_ORDEREDBOOKMARKS | OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el establecimiento de propiedades de visibilidad de cambios hace que OLE DB Driver for SQL Server use los cursores de SQL Server para admitir el conjunto de filas. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. |
| DBPROP_QUICKRESTART | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: cuando se establece en VARIANT_TRUE, OLE DB Driver for SQL Server intenta usar un cursor de servidor para el conjunto de filas. |
| DBPROP_REENTRANTEVENTS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: los conjuntos de filas de OLE DB Driver for SQL Server son reentrantes y pueden devolver DB_E_NOTREENTRANT si un consumidor intenta acceder a un método de conjunto de filas no reentrante desde una devolución de llamada de notificación. |
| DBPROP_REMOVEDELETED | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server altera el valor de la propiedad según la visibilidad de cambios en los datos de SQL Server expuestos por el conjunto de filas. VARIANT_TRUE: las filas eliminadas por el consumidor u otros usuarios de SQL Server se quitan del conjunto de filas cuando se actualiza este. DBPROP_OTHERINSERT es VARIANT_TRUE. VARIANT_FALSE: las filas eliminadas por el consumidor u otros usuarios de SQL Server no se quitan del conjunto de filas cuando se actualiza este. El valor de estado de fila para las filas de SQL Server eliminadas del conjunto de filas es DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT es VARIANT_TRUE. Esta propiedad solo tiene valor para los conjuntos de filas admitidos por los cursores de SQL Server. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. Cuando la propiedad DBPROP_REMOVEDELETED se implementa en un conjunto de filas de cursor de conjunto de claves, las filas eliminadas se quitan en el momento de la captura y es posible que los métodos de captura de filas, como GetNextRows y GetRowsAt, devuelvan S_OK y menos filas de las solicitadas. Tenga en cuenta que este comportamiento no implica la condición DB_S_ENDOFROWSET y que el número de filas devuelto nunca será cero hay filas restantes. |
| DBPROP_REPORTMULTIPLECHANGES | OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_RETURNPENDINGINSERTS | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: cuando se llama a un método que captura filas, OLE DB Driver for SQL Server no devuelve las filas pendientes de inserción. |
| DBPROP_ROWRESTRICT | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: los conjuntos de filas de OLE DB Driver for SQL Server no admiten derechos de acceso basados en la fila. Si la interfaz IRowsetChange se expone en un conjunto de filas, el consumidor puede llamar al método SetData. |
| DBPROP_ROWSET_ASYNCH | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: 0 Descripción: se proporciona para el procesamiento asincrónico del conjunto de filas. Esta propiedad pertenece al grupo de propiedades del conjunto de filas y al conjunto de propiedades DBPROPSET_ROWSET. El tipo es VT_14. El único valor de la máscara de bits que admite OLE DB Driver for SQL Server es DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R (lectura) y W (escritura): Solo lectura Valor predeterminado: DBPROPVAL_RT_FREETHREAD Descripción: OLE DB Driver for SQL Server admite el acceso a sus objetos desde varios subprocesos de ejecución de un único consumidor. |
| DBPROP_SERVERCURSOR | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: cuando se establece, se usa un cursor de SQL Server para admitir el conjunto de filas. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. |
| DBPROP_SERVERDATAONINSERT | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: datos de servidor al insertar. VARIANT_TRUE: en el momento en que se transmite una inserción al servidor, el proveedor recupera los datos del servidor para actualizar la caché de filas local. VARIANT_FALSE: el proveedor no recupera los valores de servidor para las filas recién insertadas. |
| DBPROP_STRONGIDENTITY | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: identidad de fila segura. Si se permiten inserciones en un conjunto de filas (IRowsetChange o IRowsetUpdate es true) y DBPROP_UPDATABILITY se establece para admitir InsertRows, el valor de DBPROP_STRONGIDENTITY dependerá de la propiedad DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE si el valor de la propiedad DBPROP_CHANGEINSERTEDROWS es VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_FALSE Descripción: OLE DB Driver for SQL Server solo admite objetos de transacción. Para más información, consulte Transacciones. |
| DBPROP_UNIQUEROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: Filas únicas. VARIANT_TRUE: cada fila se identifica de forma única mediante sus valores de columna. El conjunto de columnas que identifican de forma única la fila tiene establecido DBCOLUMNFLAGS_KEYCOLUMN en la estructura DBCOLUMNINFO devuelta por el método GetColumnInfo. VARIANT_FALSE: las filas se pueden identificar o no de forma única por sus valores de columna. Las columnas de clave pueden estar o no estar marcadas con DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: 0 Descripción: OLE DB Driver for SQL Server admite todos los valores de DBPROP_UPDATABILITY. Al establecer DBPROP_UPDATABILITY, no se crea ningún conjunto de filas que pueda modificarse. Para que un conjunto de filas pueda modificarse, establezca DBPROP_IRowsetChange o DBPROP_IRowsetUpdate. |
El controlador OLE DB para SQL Server define el conjunto de propiedades DBPROPSET_SQLSERVERROWSET específico del proveedor, como se muestra en esta tabla.
| Id. de propiedad | Descripción |
|---|---|
| SSPROP_COLUMN_ID | Columna: ColumnID R (lectura) y W (escritura): Solo lectura Tipo: VT_U12 | VT_ARRAY Valor predeterminado: VT_EMPTY Descripción: matriz de valores enteros que representan la posición ordinal (en base 1) de una columna de resultados de la cláusula COMPUTE en la instrucción SELECT actual de Transact-SQL. Esta es la API OLE DB Driver for SQL Server equivalente al atributo SQL_CA_SS_COLUMN_ID de ODBC. |
| SSPROP_DEFERPREPARE | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BOOL Valor predeterminado: VARIANT_TRUE Descripción: VARIANT_TRUE: en una ejecución preparada, la preparación de comandos se aplaza hasta que se llama a ICommand::Execute o hasta que se realiza una operación de metapropiedad. Si la propiedad está establecida en VARIANT_FALSE: la instrucción se prepara cuando se ejecuta ICommandPrepare::Prepare. |
| SSPROP_IRowsetFastLoad | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: establezca esta propiedad en VARIANT_TRUE para abrir un conjunto de filas de carga rápida mediante IOpenRowset::OpenRowset. No puede establecer esta propiedad en ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Columna: No. R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: establezca esta propiedad en VARIANT_TRUE para habilitar las operaciones asincrónicas con la interfaz ISSAsynchStatus. |
| SSPROP_ISSDataClassification | R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BOOL Valor predeterminado: VARIANT_TRUE Descripción: El controlador OLE DB Driver for SQL Server admite la recuperación de información de clasificación de confidencialidad mediante la interfaz ISSDataClassification. |
| SSPROP_MAXBLOBLENGTH | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_I4 Valor predeterminado: el proveedor no restringe el tamaño del texto devuelto por el servidor y el valor de propiedad se establece en su valor máximo. Por ejemplo, 2147483647. Descripción: OLE DB Driver for SQL Server ejecuta una instrucción SET TEXTSIZE para restringir la longitud de los datos de objetos binarios grandes (BLOB) devueltos por una instrucción SELECT. |
| SSPROP_NOCOUNT_STATUS | Columna: NoCount R (lectura) y W (escritura): Solo lectura Escriba: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: valor booleano que representa el estado de SET NOCOUNT ON/OFF en SQL Server: VARIANT_TRUE: cuando SET NOCOUNT ON VARIANT_FALSE: cuando SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BSTR (1-2000 caracteres permitidos) Valor predeterminado: cadena vacía. Descripción: texto del mensaje de la notificación de consulta. Lo define el usuario y no tiene ningún formato definido. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_BSTR Valor predeterminado: cadena vacía. Descripción: Opciones de notificación de consulta. Se especifican en una cadena con name=value. El usuario es responsable de la creación del servicio y de la lectura de las notificaciones fuera de la cola. La sintaxis de la cadena de opciones de notificación de consulta es la siguiente:service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Por ejemplo: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Columna: No R (lectura) y W (escritura): Lectura/escritura Escriba: VT_UI4 Valor predeterminado: 432000 segundos (5 días) Mínimos: 1 segundo Máximo: 2^31-1 segundos Descripción: Número de segundos que la notificación de consulta va a permanecer activa. |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de