Compatibilidad con tipos de parámetros con valores de tabla de OLE DB (propiedades)
Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
En este tema se proporciona información sobre las propiedades de OLE DB y los conjuntos de propiedades asociados a los objetos de conjunto de filas de parámetro con valores de tabla.
Propiedades
A continuación, se muestra la lista de propiedades expuestas mediante el método IRowsetInfo::GetProperties en los objetos de conjunto de filas de parámetro con valores de tabla. Observe que todas las propiedades de conjunto de filas de parámetro con valores de tabla son de solo lectura. Por lo tanto, si se intenta establecer cualquiera de las propiedades mediante los métodos IOpenRowset::OpenRowset o ITableDefinitionWithConstraints::CreateTableWithConstraints en sus valores no predeterminados, se producirá un error y no se creará ningún objeto.
No se enumeran aquí las propiedades no implementadas en el objeto de conjunto de filas de parámetro con valores. Para obtener una lista completa de las propiedades, vea la documentación de OLE DB en Data Access Components para Windows.
Id. de propiedad | Value |
---|---|
DBPROP_ABORTPRESERVE | VARIANT_TRUE |
DBPROP_ACCESSORDER | DBPROPVAL_AO_RANDOM |
DBPROP_BLOCKINGSTORAGEOBJECTS | VARIANT_TRUE |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS |
L/E: solo lectura Valor predeterminado: VARIANT_FALSE Descripción: no se permiten marcadores en los objetos de conjunto de filas de parámetro con valores de tabla. |
DBPROP_BOOKMARKSKIPPED | VARIANT_FALSE |
DBPROP_BOOKMARKTYPE | DBPROPVAL_BMK_NUMERIC |
DBPROP_CANHOLDROWS | VARIANT_FALSE |
DBPROP_CHANGEINSERTEDROWS | VARIANT_TRUE |
DBPROP_COLUMNRESTRICT | VARIANT_FALSE |
DBPROP_COMMANDTIMEOUT | 0 |
DBPROP_COMMITPRESERVE | VARIANT_TRUE |
DBPROP_DEFERRED | VARIANT_FALSE |
DBPROP_DELAYSTORAGEOBJECTS | VARIANT_FALSE |
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo DBPROP_IColumnsRowset |
VARIANT_TRUE |
DBPROP_IConnectionPointContainer DBPROP_IMultipleResults DBPROP_IRowsetUpdate DBPROP_IRowsetIdentity DBPROP_IRowsetLocate DBPROP_IRowsetScroll DBPROP_IRowsetResynch |
VARIANT_FALSE |
DBPROP_IRowsetChange | VARIANT_TRUE Nota: El objeto de conjunto de filas de parámetro con valores de tabla admite las interfaces IRowsetChange. Los conjuntos de filas creados utilizando DBPROP_IRowsetChange igual a VARIANT_TRUE exhiben los comportamientos de modo de actualización inmediatos. Pero, si las columnas BLOB se enlazan como objetos ISequentialStream, se espera que el consumidor las mantenga mientras exista el objeto de conjunto de filas de parámetro con valores de tabla. |
DBPROP_ISupportErrorInfo | VARIANT_TRUE |
DBPROP_ISequentialStream | VARIANT_TRUE |
DBPROP_IMMOBILEROWS | VARIANT_TRUE |
DBPROP_LITERALIDENTITY | VARIANT_TRUE |
DBPROP_LOCKMODE | DBPROPVAL_LM_NONE |
DBPROP_MAXOPENROWS | 0 |
DBPROP_MAXPENDINGROWS | 0 |
DBPROP_MAXROWS | 0 |
DBPROP_NOTIFICATIONPHASES | 0 |
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | 0 |
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE | VARIANT_FALSE |
DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE |
VARIANT_TRUE |
DBPROP_QUICKRESTART | VARIANT_TRUE |
DBPROP_REENTRANTEVENTS | VARIANT_FALSE |
DBPROP_REMOVEDELETED | VARIANT_TRUE |
DBPROP_RETURNPENDINGINSERTS | VARIANT_TRUE |
DBPROP_ROWRESTRICT | VARIANT_FALSE |
DBPROP_ROWTHREADMODEL | DBPROPVAL_RT_FREETHREAD |
DBPROP_SERVERCURSOR | VARIANT_FALSE |
DBPROP_SERVERDATAONINSERT | VARIANT_FALSE |
DBPROP_STRONGIDENTITY | VARIANT_TRUE |
DBPROP_TRANSACTEDOBJECT | VARIANT_FALSE |
DBPROP_UNIQUEROWS | VARIANT_FALSE |
DBPROP_UPDATABILITY | DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_DELETE | DBPROPVAL_UP_INSERT |
Conjuntos de propiedades
La propiedad siguiente establece los parámetros con valores de tabla admitidos.
DBPROPSET_SQLSERVERCOLUMN
El consumidor usa esta propiedad en el proceso de crear un objeto de conjunto de filas de parámetros con valores de tabla mediante ITableDefinitionWithConstraints::CreateTableWithConstraints para cada columna con la estructura DBCOLUMNDESC, si es necesario.
Id. de propiedad | Valor de la propiedad |
---|---|
SSPROP_COL_COMPUTED | L/E: de lectura/escritura Valor predeterminado: VARIANT_FALSE Tipo: VT_BOOL Descripción: cuando se establece en VARIANT_TRUE, indica que la columna es calculada. VARIANT_FALSE indica que no es una columna calculada. |
DBPROPSET_SQLSERVERPARAMETER
El consumidor lee estas propiedades mientras se detecta la información de tipos de parámetros con valores de tabla en las llamadas a ISSCommandWithParameters::GetParameterPropertiey las establece mientras se configuran propiedades específicas sobre el parámetro con valores de tabla mediante ISSCommandWithParameters::SetParameterProperties.
En la tabla siguiente se proporcionan descripciones detalladas de estas propiedades.
Id. de propiedad | Valor de la propiedad |
---|---|
SSPROP_PARAM_TYPE_TYPENAME | L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Esta propiedad se puede especificar opcionalmente para proporcionar un nombre de tipo de tabla para un parámetro con valores de tabla (en caso del comando de sintaxis de llamada ODBC). Esta propiedad es necesaria para las consultas SQL parametrizadas ad hoc. |
SSPROP_PARAM_TYPE_SCHEMANAME | L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre de esquema del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. |
SSPROP_PARAM_TYPE_CATALOGNAME | L/E: de solo lectura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener el nombre de catálogo del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Es un error establecer esta propiedad; los tipos de tabla definidos por el usuario deben estar en la misma base de datos que los parámetros con valores de tabla que los usan. |
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS | L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: los consumidores usan esta propiedad para especificar qué conjunto de columnas del conjunto de filas será tratado como valores predeterminados. No se enviará ningún valor para esas columnas. Al capturar datos del objeto de conjunto de filas del consumidor, el proveedor no requiere un enlace para tales columnas. Todos los elementos de la matriz deben ser ordinales de columnas del objeto de conjunto de filas. Los ordinales no válidos producirán errores durante la ejecución del comando. |
SSPROP_PARAM_TABLE_COLUMN_ORDER | L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: el consumidor utiliza esta propiedad para proporcionar una sugerencia al servidor que indica el orden de clasificación de los datos de columna. El proveedor no realiza ninguna validación y asume que el consumidor se ajusta a la especificación que se proporcionó. El servidor usa esta propiedad para realizar las optimizaciones. La información de orden de las columnas para cada columna se representa mediante un par de elementos de la matriz. El primer elemento del par es el número de la columna. El segundo elemento del par será 1 para el orden ascendente o 2 para el orden descendente. |
Consulte también
Compatibilidad con tipos de parámetros con valores de tablas de OLE DB
Usar parámetros con valores de tabla (OLE DB)
Comentarios
https://aka.ms/ContentUserFeedback.
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:Enviar y ver comentarios de