Partage via


Propriétés de la source de données SQL Server Native Client (OLE DB)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Important

SQL Server Native Client (souvent abrégé en SNAC) a été supprimé dans SQL Server 2022 (16.x) et SQL Server Management Studio 19 (SSMS). Le fournisseur OLE DB pour SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB hérité pour SQL Server (SQLOLEDB) ne sont pas recommandés dans les nouveaux développements. Utilisez à la place le nouveau Microsoft OLE DB Driver (MSOLEDBSQL) pour SQL Server.

Le fournisseur OLE DB SQL Server Native Client implémente les propriétés de source de données comme suit.

ID de propriété Description
DBPROP_CURRENTCATALOG R/W : lecture/écriture Par défaut : aucune

Description : la valeur de DBPROP_CURRENTCATALOG signale la base de données active pour une session de fournisseur OLE DB SQL Server Native Client. La définition de la valeur de la propriété a un effet identique à la définition de la base de données active avec l’instruction Transact-SQL USE database.

À compter de SQL Server 2005 (9.x), si vous appelez sp_defaultdb et que vous spécifiez le nom de la base de données en minuscules, même si la base de données a été créée à l’origine avec un nom en casse mixte, DBPROP_CURRENTCATALOG retourne le nom en minuscules. Avec les versions antérieures de SQL Server, DBPROP_CURRENTCATALOG retourne la casse mixte attendue.
DBPROP_MULTIPLECONNECTIONS R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : si la connexion exécute une commande qui ne produit pas un ensemble de lignes ou génère un ensemble de lignes qui n'est pas un curseur côté serveur et que vous exécutez une autre commande, une nouvelle connexion est créée pour exécuter la nouvelle commande si DBPROP_MULTIPLECONNECTIONS a la valeur VARIANT_TRUE.

Le fournisseur OLE DB SQL Server Native Client ne crée pas de connexion si DBPROP_MULTIPLECONNECTION est VARIANT_FALSE ou si une transaction est active sur la connexion. Le fournisseur OLE DB SQL Server Native Client retourne DB_E_OBJECTOPEN si DBPROP_MULTIPLECONNECTIONS est VARIANT_FALSE et retourne E_FAIL s’il existe une transaction active. Les transactions et le verrouillage sont gérés par SQL Server connexion par connexion. Si une deuxième connexion est générée, les commandes sur les connexions séparées ne partagent pas les verrous. Pour garantir qu'une commande n'en bloque pas une autre, maintenez les verrous sur les lignes demandées par l'autre commande. Ceci reste vrai en cas de création de plusieurs sessions.

Chaque session possède une connexion distincte.

Dans le jeu de propriétés spécifique au fournisseur DBPROPSET_SQLSERVERDATASOURCE, le fournisseur OLE DB SQL Server Native Client définit les propriétés de source de données supplémentaires suivantes.

ID de propriété Description
SSPROP_ENABLEFASTLOAD R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : pour permettre la copie en bloc à partir de la mémoire, la propriété SSPROP_ENABLEFASTLOAD doit avoir la valeur VARIANT_TRUE. Avec cette propriété définie sur la source de données, la session nouvellement créée autorise l’accès du consommateur à l’interface IRowsetFastLoad.

Si la propriété est définir sue VARIANT_TRUE, l’interface IRowsetFastLoad est disponible via IOpenRowset::OpenRowset en demandant l’interface IID_IRowsetFastLoad ou en définissant SSPROP_IRowsetFastLoad sur VARIANT_TRUE.
SSPROP_ENABLEBULKCOPY R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : pour permettre la copie en bloc à partir de fichiers, la propriété SSPROP_ENABLEBULKCOPY doit avoir la valeur VARIANT_TRUE. Avec cette propriété définie sur la source de données, l'accès du consommateur à l'interface IBCPSession est disponible sous le même niveau que Sessions.

SSPROP_IRowsetFastLoad doit également être défini avec la valeur VARIANT_TRUE.

Voir aussi

Objets source de données (OLE DB)