Compartir a través de


Propiedades del origen de datos de SQL Server Native Client (OLE DB)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Importante

SQL Server Native Client (a menudo abreviado SNAC) se ha quitado de SQL Server 2022 (16.x) y SQL Server Management Studio 19 (SSMS). Para nuevos trabajos de desarrollo, no se recomiendan ni el proveedor OLE DB de SQL Server Native Client (SQLNCLI o SQLNCLI11) ni el proveedor OLE DB de Microsoft para SQL Server (SQLOLEDB) heredado. Cambie al nuevo Controlador Microsoft OLE DB para SQL Server de ahora en adelante.

El proveedor OLE DB de SQL Server Native Client implementa las propiedades del origen de datos como se indica a continuación.

Id. de propiedad Descripción
DBPROP_CURRENTCATALOG L/E: Lectura y escritura. Valor predeterminado: Ninguno

Descripción: el valor de DBPROP_CURRENTCATALOG informa de la base de datos actual para una sesión de proveedor OLE DB de SQL Server Native Client. Establecer el valor de propiedad tiene el mismo efecto que establecer la base de datos actual mediante la instrucción USE base de datos de Transact-SQL.

A partir de SQL Server 2005 (9.x), si llama a sp_defaultdb y especifica el nombre de la base de datos en letra minúscula, aunque la base de datos se hubiera creado inicialmente con un nombre en grafía mixta (mayúsculas y minúsculas), DBPROP_CURRENTCATALOG devolverá el nombre en letra minúscula. Con versiones anteriores de SQL Server, DBPROP_CURRENTCATALOG devolverá el nombre en la grafía mixta (mayúsculas y minúsculas) esperada.
DBPROP_MULTIPLECONNECTIONS L/E: Lectura/escritura. Valor predeterminado: VARIANT_FALSE

Descripción: Si la conexión está ejecutando un comando que no genera un conjunto de filas o genera un conjunto de filas que no es un cursor de servidor y el usuario ejecuta otro comando, se creará una nueva conexión para ejecutar el nuevo comando si DBPROP_MULTIPLECONNECTIONS es VARIANT_TRUE.

El proveedor OLE DB de SQL Server Native Client no creará otra conexión si DBPROP_MULTIPLECONNECTION es VARIANT_FALSE o si una transacción está activa en la conexión. El proveedor OLE DB de SQL Server Native Client devuelve DB_E_OBJECTOPEN si DBPROP_MULTIPLECONNECTIONS está VARIANT_FALSE y devuelve E_FAIL si hay una transacción activa. SQL Server administra las transacciones y el bloqueo para cada conexión. Si se genera una segunda conexión, los comandos de cada una de las conexiones no comparten los bloqueos. Para asegurarse de que un comando no bloquea otro comando, mantenga los bloqueos en las filas solicitadas por el otro comando. Esto también es válido cuando se crean varias sesiones.

Cada sesión tiene una conexión independiente.

En el conjunto de propiedades específicas del proveedor DBPROPSET_SQLSERVERDATASOURCE, el proveedor OLE DB de SQL Server Native Client define las siguientes propiedades adicionales del origen de datos.

Id. de propiedad Descripción
SSPROP_ENABLEFASTLOAD L/E: Lectura/escritura. Valor predeterminado: VARIANT_FALSE

Descripción: Para habilitar la copia masiva de la memoria, la propiedad SSPROP_ENABLEFASTLOAD debe establecerse en VARIANT_TRUE. Con esta propiedad establecida en el origen de datos, la sesión recién creada permite el acceso del consumidor a la interfaz IRowsetFastLoad.

Si la propiedad se establece en VARIANT_TRUE, la interfaz IRowsetFastLoad está disponible a través de IOpenRowset::OpenRowset al solicitar la interfaz IID_IRowsetFastLoad o establecer SSPROP_IRowsetFastLoad en VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY L/E: Lectura/escritura. Valor predeterminado: VARIANT_FALSE

Descripción: Para habilitar la copia masiva desde archivos, la propiedad SSPROP_ENABLEBULKCOPY debe establecerse en VARIANT_TRUE. Con esta propiedad establecida en el origen de datos, el acceso del consumidor a la interfaz IBCPSession está disponible en el mismo nivel que Sessions.

SSPROP_IRowsetFastLoad también debe establecerse en VARIANT_TRUE.

Consulte también

Objetos de origen de datos (OLE DB)