Partager via


Propriétés de la source de données (OLE DB)

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

Télécharger le pilote OLE DB

OLE DB Driver pour SQL Server implémente les propriétés de la 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 indique la base de données active pour une session du pilote OLE DB pour SQL Server. 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 pilote OLE DB pour SQL Server ne crée pas une autre connexion si DBPROP_MULTIPLECONNECTION a la valeur VARIANT_FALSE ou si une transaction est active sur la connexion. Le pilote OLE DB pour SQL Server retourne DB_E_OBJECTOPEN si DBPROP_MULTIPLECONNECTIONS a la valeur 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 DBPROPSET_SQLSERVERDATASOURCE spécifique au fournisseur, le pilote OLE DB pour SQL Server définit les propriétés supplémentaires suivantes de la source de données.

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)