Ensembles de lignes et curseurs SQL Server

SQL Server retourne les jeux de résultats aux consommateurs à l'aide de deux méthodes :

• Les jeux de résultats par défaut qui :

  • minimisent la charge ;

  • procurent des performances maximales pour extraire des données ;

  • prennent en charge uniquement la fonctionnalité de curseur avant uniquement en lecture seule par défaut ;

  • retournent les lignes au consommateur une à la fois ;

  • prennent en charge une seule instruction active à la fois sur une connexion.

    Une fois qu'une instruction a été exécutée, aucune autre instruction ne peut être exécutée sur la connexion tant que tous les résultats n'ont pas été extraits par le consommateur ou que l'instruction n'a pas été annulée ;

  • prennent en charge toutes les instructions Transact-SQL.

• Les curseurs côté serveur qui :

  • prennent en charge toutes les fonctionnalités de curseur ;

  • peuvent retourner des blocs de lignes au consommateur ;

  • prennent en charge plusieurs instructions actives sur une connexion unique ;

  • procurent un compromis entre les fonctionnalités de curseur et les performances.

    La prise en charge des fonctionnalités de curseur peut réduire les performances par rapport à un jeu de résultats par défaut. Cette dégradation peut être limitée si le consommateur peut utiliser les fonctionnalités de curseur pour extraire un plus petit ensemble de lignes ;

  • ne prennent en charge aucune instruction Transact-SQL qui retourne plus d'un seul jeu de résultats.

Les consommateurs peuvent demander différents comportements de curseur dans un ensemble de lignes en définissant certaines propriétés d'ensemble de lignes. Si le consommateur ne définit aucune de ces propriétés d'ensemble de lignes ou leur affecte à toutes leur valeur par défaut, le fournisseur OLE DB SQL Server Native Client implémente l'ensemble de lignes à l'aide d'un jeu de résultats par défaut. Si une valeur autre que la valeur par défaut est affectée à l'une de ces propriétés, le fournisseur OLE DB SQL Server Native Client implémente l'ensemble de lignes à l'aide d'un curseur côté serveur.

Les propriétés d'ensemble de lignes suivantes font en sorte que le fournisseur OLE DB SQL Server Native Client utilise des curseurs SQL Server. Certaines propriétés peuvent être combinées avec d'autres sans risque. Par exemple, un ensemble de lignes qui expose les propriétés DBPROP_IRowsetScroll et DBPROP_IRowsetChange sera un ensemble de lignes signet présentant un comportement de mise à jour immédiat. Les autres propriétés s'excluent mutuellement. Par exemple, un ensemble de lignes exposant DBPROP_OTHERINSERT ne peut pas contenir de signets.

Un ensemble de lignes de fournisseur OLE DB SQL Server Native Client pris en charge par un curseur côté serveur peut être créé facilement sur une vue ou une table de base SQL Server à l'aide de la méthode IOpenRowset::OpenRowset . Spécifiez la table ou la vue par nom et passez les jeux de propriétés d'ensemble de lignes requis dans le paramètre rgPropertySets.

Le texte de la commande qui crée un ensemble de lignes est restreint lorsque le consommateur requiert que l'ensemble de lignes soit pris en charge par un curseur côté serveur. Plus spécifiquement, le texte de la commande est restreint à une instruction SELECT unique qui retourne un résultat d'ensemble de lignes unique ou à une procédure stockée qui implémente une instruction SELECT unique qui retourne un résultat d'ensemble de lignes unique.

Ces deux tableaux montrent les mappages de différentes propriétés OLE DB et les modèles de curseur. Ils indiquent également quelles propriétés d'ensemble de lignes doivent être définies pour utiliser un certain type de modèle de curseur.

Chaque cellule du tableau contient une valeur de la propriété d'ensemble de lignes pour le modèle de curseur spécifique. Le type de données de toutes les propriétés d'ensemble de lignes répertoriées plus haut dans cette rubrique est VT_BOOL et la valeur par défaut est VARIANT_FALSE. Les symboles suivants sont utilisés dans le tableau.

F = valeur par défaut (VARIANT_FALSE)

T = VARIANT_TRUE

- = VARIANT_TRUE ou VARIANT_FALSE

Pour utiliser un certain type de modèle de curseur, recherchez la colonne correspondant au modèle de curseur et recherchez toutes les propriétés d'ensemble de lignes avec la valeur « T » dans la colonne. Affectez la valeur VARIANT_TRUE à ces propriétés d'ensemble de lignes pour utiliser le modèle de curseur spécifique. Les propriétés d'ensemble de lignes avec '-' comme valeur peuvent être définies à VARIANT_TRUE ou VARIANT_FALSE.

Pour un jeu particulier de propriétés d'ensemble de lignes, le modèle de curseur sélectionné est déterminé comme suit.

À partir de la collection spécifiée de propriétés d'ensemble de lignes, obtenez un sous-ensemble de propriétés répertoriées dans les tableaux précédents. Divisez ces propriétés en deux sous-groupes selon la valeur de l'indicateur, requis (T, F) ou facultatif (-), de chaque propriété d'ensemble de lignes. Pour chaque modèle de curseur, commencez par la première table et déplacez-vous de gauche à droite. Comparez les valeurs des propriétés dans les deux sous-groupes avec les valeurs des propriétés correspondantes dans cette colonne. Le modèle de curseur qui n'a aucune incompatibilité avec les propriétés requises et le plus petit nombre d'incompatibilités avec les propriétés facultatives est sélectionné. S'il y a plusieurs modèles de curseur, celui situé le plus à gauche est choisi.