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

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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 de la siguiente manera.

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 del 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 está VARIANT_FALSE o si una transacción está activa en la conexión. El proveedor OLE DB SQL Server Native Client devuelve DB_E_OBJECTOPEN si se VARIANT_FALSE DBPROP_MULTIPLECONNECTIONS 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ífico 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)